java.lang.Object | ||
↳ | android.content.pm.PackageManager | |
↳ | android.test.mock.MockPackageManager |
A mock PackageManager
class. All methods are non-functional and throw
UnsupportedOperationException
. Override it to provide the operations that you
need.
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
android.content.pm.PackageManager
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
| |||||||||||
Add a new dynamic permission to the system.
| |||||||||||
Like
addPermission(PermissionInfo) but asynchronously
persists the package manager state after returning from the call,
allowing it to return quicker and batch a series of adds at the
expense of no guarantee the added permission will be retained if
the device is rebooted before it is written.
| |||||||||||
This method is deprecated.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this cannot be directly modified.
Add a new preferred activity mapping to the system. This will be used
to automatically select the given activity component when
Context.startActivity() finds
multiple matching activities and also matches the given filter.
| |||||||||||
Map from a packages canonical name to the current name in use on the device.
| |||||||||||
Check whether a particular package has been granted a particular
permission.
| |||||||||||
Like
checkSignatures(String, String) , but takes UIDs of
the two packages to be checked.
| |||||||||||
Compare the signatures of two packages to determine if the same
signature appears in both of them.
| |||||||||||
Remove all preferred activity mappings, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName) , from the
system whose activities are implemented in the given package name.
| |||||||||||
Map from the current package names in use on the device to whatever
the current canonical name of that package is.
| |||||||||||
Allows a package listening to the
package verification
broadcast to extend the default timeout for a response and declare what
action to perform after the timeout occurs.
| |||||||||||
Retrieve the banner associated with an Intent.
| |||||||||||
Retrieve the banner associated with an activity.
| |||||||||||
Retrieve the icon associated with an Intent.
| |||||||||||
Retrieve the icon associated with an activity.
| |||||||||||
Retrieve all of the information we know about a particular activity
class.
| |||||||||||
Retrieve the logo associated with an Intent.
| |||||||||||
Retrieve the logo associated with an activity.
| |||||||||||
Get the list of IntentFilter for a specific package.
| |||||||||||
Retrieve all of the known permission groups in the system.
| |||||||||||
Retrieve the banner associated with an application.
| |||||||||||
Retrieve the banner associated with an application.
| |||||||||||
Return the enabled setting for an application.
| |||||||||||
Retrieve the icon associated with an application.
| |||||||||||
Retrieve the icon associated with an application.
| |||||||||||
Retrieve all of the information we know about a particular
package/application.
| |||||||||||
Return the label to use for this application.
| |||||||||||
Retrieve the logo associated with an application.
| |||||||||||
Retrieve the logo associated with an application.
| |||||||||||
Return the enabled setting for a package component (activity,
receiver, service, provider).
| |||||||||||
Return the generic icon for an activity that is used when no specific
icon is defined.
| |||||||||||
Get the default Browser package name for a specific user.
| |||||||||||
Retrieve an image from a package.
| |||||||||||
Return a List of all application packages that are installed on the
device.
| |||||||||||
Return a List of all packages that are installed
on the device.
| |||||||||||
Retrieve the package name of the application that installed a package.
| |||||||||||
Retrieve all of the information we know about a particular
instrumentation class.
| |||||||||||
Returns a "good" intent to launch a front-door activity in a package.
| |||||||||||
Return a "good" intent to launch a front-door Leanback activity in a
package, for use for example to implement an "open" button when browsing
through packages.
| |||||||||||
Retrieve the official name associated with a user id.
| |||||||||||
Retrieve overall information about an application package defined
in a package archive file
| |||||||||||
Return an array of all of the secondary group-ids that have been assigned
to a package.
| |||||||||||
Retrieve overall information about an application package that is
installed on the system.
| |||||||||||
Retrieve the names of all packages that are associated with a particular
user id.
| |||||||||||
Return a List of all installed packages that are currently
holding any of the given permissions.
| |||||||||||
Retrieve all of the information we know about a particular group of
permissions.
| |||||||||||
Retrieve all of the information we know about a particular permission.
| |||||||||||
Retrieve all preferred activities, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName) , that are
currently registered with the system.
| |||||||||||
Retrieve the list of all currently configured preferred packages.
| |||||||||||
Retrieve all of the information we know about a particular content
provider class.
| |||||||||||
Retrieve all of the information we know about a particular receiver
class.
| |||||||||||
Retrieve the resources associated with an activity.
| |||||||||||
Retrieve the resources associated with an application.
| |||||||||||
Retrieve the resources for an application.
| |||||||||||
Retrieve all of the information we know about a particular service
class.
| |||||||||||
Get a list of features that are available on the
system.
| |||||||||||
Get a list of shared libraries that are available on the
system.
| |||||||||||
Retrieve text from a package.
| |||||||||||
If the target user is a managed profile of the calling user or the caller
is itself a managed profile, then this returns a badged copy of the given
drawable allowing the user to distinguish it from the original drawable.
| |||||||||||
If the target user is a managed profile of the calling user or if the
target user is the caller and is itself a managed profile, then this
returns a badged copy of the given icon to be able to distinguish it from
the original icon.
| |||||||||||
If the target user is a managed profile of the calling user or the caller
is itself a managed profile, then this returns a copy of the label with
badging for accessibility services like talkback.
| |||||||||||
Retrieve an XML file from a package.
| |||||||||||
Check whether the given feature name is one of the available
features as returned by
getSystemAvailableFeatures() .
| |||||||||||
Checks whether a particular permissions has been revoked for a
package by policy.
| |||||||||||
Return whether the device has been booted into safe mode.
| |||||||||||
Retrieve all receivers that can handle a broadcast of the given intent.
| |||||||||||
Retrieve content provider information.
| |||||||||||
Retrieve information about available instrumentation code.
| |||||||||||
Retrieve all activities that can be performed for the given intent.
| |||||||||||
Retrieve a set of activities that should be presented to the user as
similar options.
| |||||||||||
Retrieve all providers that can match the given intent.
| |||||||||||
Retrieve all services that can match the given intent.
| |||||||||||
Query for all of the permissions associated with a particular group.
| |||||||||||
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
| |||||||||||
Removes a permission that was previously added with
addPermission(PermissionInfo) .
| |||||||||||
Determine the best action to perform for a given Intent.
| |||||||||||
Find a single content provider by its base path name.
| |||||||||||
Determine the best service to handle for a given Intent.
| |||||||||||
Set the enabled setting for an application
This setting will override any enabled state which may have been set by the application in
its manifest.
| |||||||||||
Set the enabled setting for a package component (activity, receiver, service, provider).
| |||||||||||
Set the default Browser package name for a specific user.
| |||||||||||
Change the installer associated with a given package.
| |||||||||||
Allows a package listening to the
package verification
broadcast to respond to the package manager.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
android.content.pm.PackageManager
| |||||||||||
From class
java.lang.Object
|
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
Add a new dynamic permission to the system. For this to work, your
package must have defined a permission tree through the
<permission-tree>
tag in its manifest. A package can only add
permissions to trees that were defined by either its own package or
another with the same user id; a permission is in a tree if it
matches the name of the permission tree + ".": for example,
"com.foo.bar" is a member of the permission tree "com.foo".
It is good to make your permission tree name descriptive, because you are taking possession of that entire set of permission names. Thus, it must be under a domain you control, with a suffix that will not match any normal permissions that may be declared in any applications that are part of that domain.
New permissions must be added before any .apks are installed that use those permissions. Permissions you add through this method are remembered across reboots of the device. If the given permission already exists, the info you supply here will be used to update it.
info | Description of the permission to be added. |
---|
Like addPermission(PermissionInfo)
but asynchronously
persists the package manager state after returning from the call,
allowing it to return quicker and batch a series of adds at the
expense of no guarantee the added permission will be retained if
the device is rebooted before it is written.
This method is deprecated.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this cannot be directly modified.
Add a new preferred activity mapping to the system. This will be used
to automatically select the given activity component when
Context.startActivity()
finds
multiple matching activities and also matches the given filter.
filter | The set of intents under which this activity will be made preferred. |
---|---|
match | The IntentFilter match category that this preference applies to. |
set | The set of activities that the user was picking from when this preference was made. |
activity | The component name of the activity that is to be preferred. |
Map from a packages canonical name to the current name in use on the device.
names | Array of new names to be mapped. |
---|
Check whether a particular package has been granted a particular permission.
permName | The name of the permission you are checking for. |
---|---|
pkgName | The name of the package you are checking against. |
Like checkSignatures(String, String)
, but takes UIDs of
the two packages to be checked. This can be useful, for example,
when doing the check in an IPC, where the UID is the only identity
available. It is functionally identical to determining the package
associated with the UIDs and checking their signatures.
uid1 | First UID whose signature will be compared. |
---|---|
uid2 | Second UID whose signature will be compared. |
SIGNATURE_MATCH
) if
all signatures match or < 0 if there is not a match (SIGNATURE_NO_MATCH
or SIGNATURE_UNKNOWN_PACKAGE
).Compare the signatures of two packages to determine if the same signature appears in both of them. If they do contain the same signature, then they are allowed special privileges when working with each other: they can share the same user-id, run instrumentation against each other, etc.
pkg1 | First package name whose signature will be compared. |
---|---|
pkg2 | Second package name whose signature will be compared. |
SIGNATURE_MATCH
) if
all signatures match or < 0 if there is not a match (SIGNATURE_NO_MATCH
or SIGNATURE_UNKNOWN_PACKAGE
).Remove all preferred activity mappings, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName)
, from the
system whose activities are implemented in the given package name.
An application can only clear its own package(s).
packageName | The name of the package whose preferred activity mappings are to be removed. |
---|
Map from the current package names in use on the device to whatever the current canonical name of that package is.
names | Array of current names to be mapped. |
---|
Allows a package listening to the
package verification
broadcast
to extend the default timeout for a response and declare what
action to perform after the timeout occurs. The response must include
the verificationCodeAtTimeout
which is one of
VERIFICATION_ALLOW
or
VERIFICATION_REJECT
.
This method may only be called once per package id. Additional calls
will have no effect.
id | pending package identifier as passed via the
EXTRA_VERIFICATION_ID Intent extra. |
---|---|
verificationCodeAtTimeout | either
VERIFICATION_ALLOW or
VERIFICATION_REJECT . If
verificationCodeAtTimeout is neither
VERIFICATION_ALLOW or
VERIFICATION_REJECT , then
verificationCodeAtTimeout will default to
VERIFICATION_REJECT . |
millisecondsToDelay | the amount of time requested for the timeout.
Must be positive and less than
MAXIMUM_VERIFICATION_TIMEOUT . If
millisecondsToDelay is out of bounds,
millisecondsToDelay will be set to the closest in
bounds value; namely, 0 or
MAXIMUM_VERIFICATION_TIMEOUT . |
Retrieve the banner associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityBanner(intent.getClassName()). Otherwise it resolves the intent's component and returns the banner associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve a banner. |
---|
Retrieve the banner associated with an activity. Given the full name of
an activity, retrieves the information about it and calls
ComponentInfo.loadIcon()
to return its
banner. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose banner is to be retrieved. |
---|
Retrieve the icon associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityIcon(intent.getClassName()). Otherwise it resolves the intent's component and returns the icon associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve an icon. |
---|
Retrieve the icon associated with an activity. Given the full name of
an activity, retrieves the information about it and calls
ComponentInfo.loadIcon()
to return its icon.
If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose icon is to be retrieved. |
---|
Retrieve all of the information we know about a particular activity class.
Throws PackageManager.NameNotFoundException
if an activity with the given
class name cannot be found on the system.
className | The full component name (i.e. com.google.apps.contacts/com.google.apps.contacts.ContactsList) of an Activity class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data (in ApplicationInfo) returned. |
ActivityInfo
containing information about the activity.Retrieve the logo associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityLogo(intent.getClassName()). Otherwise it resolves the intent's component and returns the logo associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve a logo. |
---|
Retrieve the logo associated with an activity. Given the full name of an
activity, retrieves the information about it and calls
ComponentInfo.loadLogo()
to return its
logo. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose logo is to be retrieved. |
---|
Get the list of IntentFilter for a specific package.
packageName | the package name. This parameter is set to a non null value, the list will contain all the IntentFilter for that package. Otherwise, the list will be empty. |
---|
Retrieve all of the known permission groups in the system.
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission group. |
---|
PermissionGroupInfo
containing
information about all of the known permission groups.
Retrieve the banner associated with an application.
info | Information about application being queried. |
---|
Retrieve the banner associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationIcon() to return its banner. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application banner is to be retrieved. |
---|
Return the enabled setting for an application. This returns
the last value set by
setApplicationEnabledSetting(String, int, int)
; in most
cases this value will be COMPONENT_ENABLED_STATE_DEFAULT
since
the value originally specified in the manifest has not been modified.
packageName | The package name of the application to retrieve. |
---|
COMPONENT_ENABLED_STATE_ENABLED
,
COMPONENT_ENABLED_STATE_DISABLED
, or
COMPONENT_ENABLED_STATE_DEFAULT
. The last one means the
application's enabled state is based on the original information in
the manifest as found in ComponentInfo
.Retrieve the icon associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationIcon() to return its icon. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application icon is to be retrieved. |
---|
Retrieve the icon associated with an application. If it has not defined an icon, the default app icon is returned. Does not return null.
info | Information about application being queried. |
---|
Retrieve all of the information we know about a particular package/application.
Throws PackageManager.NameNotFoundException
if an application with the given
package name cannot be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of an application. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
ApplicationInfo
Returns ApplicationInfo object containing
information about the package.
If flag GET_UNINSTALLED_PACKAGES is set and if the package is not
found in the list of installed applications,
the application information is retrieved from the
list of uninstalled applications(which includes
installed applications as well as applications
with data directory ie applications which had been
deleted with DONT_DELETE_DATA
flag set).Return the label to use for this application.
info | The application to get the label of. |
---|
Retrieve the logo associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationLogo() to return its logo. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application logo is to be retrieved. |
---|
Retrieve the logo associated with an application. If it has not specified a logo, this method returns null.
info | Information about application being queried. |
---|
Return the enabled setting for a package component (activity,
receiver, service, provider). This returns the last value set by
setComponentEnabledSetting(ComponentName, int, int)
; in most
cases this value will be COMPONENT_ENABLED_STATE_DEFAULT
since
the value originally specified in the manifest has not been modified.
componentName | The component to retrieve. |
---|
COMPONENT_ENABLED_STATE_ENABLED
,
COMPONENT_ENABLED_STATE_DISABLED
, or
COMPONENT_ENABLED_STATE_DEFAULT
. The last one means the
component's enabled state is based on the original information in
the manifest as found in ComponentInfo
.
Return the generic icon for an activity that is used when no specific icon is defined.
Get the default Browser package name for a specific user.
userId | The user id. |
---|
Retrieve an image from a package. This is a low-level API used by
the various package manager info structures (such as
ComponentInfo
to implement retrieval of their associated
icon.
packageName | The name of the package that this icon is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired image. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Return a List of all application packages that are installed on the
device. If flag GET_UNINSTALLED_PACKAGES has been set, a list of all
applications including those deleted with DONT_DELETE_DATA
(partially
installed apps with data directory) will be returned.
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
DONT_DELETE_DATA
(partially installed apps with data directory) will be returned.Return a List of all packages that are installed on the device.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
DONT_DELETE_DATA
(partially installed apps with data directory) will be returned.Retrieve the package name of the application that installed a package. This identifies which market the package came from.
packageName | The name of the package to query |
---|
Retrieve all of the information we know about a particular instrumentation class.
Throws PackageManager.NameNotFoundException
if instrumentation with the
given class name cannot be found on the system.
className | The full name (i.e. com.google.apps.contacts.InstrumentList) of an Instrumentation class. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Returns a "good" intent to launch a front-door activity in a package.
This is used, for example, to implement an "open" button when browsing
through packages. The current implementation looks first for a main
activity in the category CATEGORY_INFO
, and next for a
main activity in the category CATEGORY_LAUNCHER
. Returns
null
if neither are found.
packageName | The name of the package to inspect. |
---|
Intent
that can be used to launch the
main activity in the package. Returns null
if the package
does not contain such an activity, or if packageName is not
recognized.
Return a "good" intent to launch a front-door Leanback activity in a
package, for use for example to implement an "open" button when browsing
through packages. The current implementation will look for a main
activity in the category CATEGORY_LEANBACK_LAUNCHER
, or
return null if no main leanback activities are found.
Throws PackageManager.NameNotFoundException
if a package with the given name
cannot be found on the system.
packageName | The name of the package to inspect. |
---|
Retrieve the official name associated with a user id. This name is guaranteed to never change, though it is possible for the underlying user id to be changed. That is, if you are storing information about user ids in persistent storage, you should use the string returned by this function instead of the raw user-id.
uid | The user id for which you would like to retrieve a name. |
---|
Retrieve overall information about an application package defined in a package archive file
archiveFilePath | The path to the archive file |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES , to modify the data returned. |
Return an array of all of the secondary group-ids that have been assigned to a package.
Throws PackageManager.NameNotFoundException
if a package with the given name
cannot be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|
Retrieve overall information about an application package that is installed on the system.
Throws PackageManager.NameNotFoundException
if a package with the given name can
not be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES , GET_GIDS ,
GET_CONFIGURATIONS , GET_INSTRUMENTATION ,
GET_PERMISSIONS , GET_PROVIDERS ,
GET_RECEIVERS , GET_SERVICES ,
GET_SIGNATURES , GET_UNINSTALLED_PACKAGES to
modify the data returned. |
DONT_DELETE_DATA
flag set).Retrieve the names of all packages that are associated with a particular user id. In most cases, this will be a single package name, the package that has been assigned that user id. Where there are multiple packages sharing the same user id through the "sharedUserId" mechanism, all packages with that id will be returned.
uid | The user id for which you would like to retrieve the associated packages. |
---|
Return a List of all installed packages that are currently holding any of the given permissions.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
Retrieve all of the information we know about a particular group of permissions.
Throws PackageManager.NameNotFoundException
if a permission group with the given
name cannot be found on the system.
name | The fully qualified name (i.e. com.google.permission_group.APPS) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission group. |
PermissionGroupInfo
containing information
about the permission.
Retrieve all of the information we know about a particular permission.
Throws PackageManager.NameNotFoundException
if a permission with the given
name cannot be found on the system.
name | The fully qualified name (i.e. com.google.permission.LOGIN) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission. |
PermissionInfo
containing information about the
permission.
Retrieve all preferred activities, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName)
, that are
currently registered with the system.
outFilters | A required list in which to place the filters of all of the preferred activities. |
---|---|
outActivities | A required list in which to place the component names of all of the preferred activities. |
packageName | An optional package in which you would like to limit the list. If null, all activities will be returned; if non-null, only those activities in the given package are returned. |
Retrieve the list of all currently configured preferred packages. The first package on the list is the most preferred, the last is the least preferred.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES , to modify the data returned. |
---|
Retrieve all of the information we know about a particular content provider class.
Throws PackageManager.NameNotFoundException
if a provider with the given
class name cannot be found on the system.
className | The full component name (i.e. com.google.providers.media/com.google.providers.media.MediaProvider) of a ContentProvider class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
Retrieve all of the information we know about a particular receiver class.
Throws PackageManager.NameNotFoundException
if a receiver with the given
class name cannot be found on the system.
className | The full component name (i.e. com.google.apps.calendar/com.google.apps.calendar.CalendarAlarm) of a Receiver class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
ActivityInfo
containing information about the receiver.Retrieve the resources associated with an activity. Given the full name of an activity, retrieves the information about it and calls getResources() to return its application's resources. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose resources are to be retrieved. |
---|
Retrieve the resources associated with an application. Given the full package name of an application, retrieves the information about it and calls getResources() to return its application's resources. If the appPackageName cannot be found, NameNotFoundException is thrown.
appPackageName | Package name of the application whose resources are to be retrieved. |
---|
Retrieve the resources for an application. Throws NameNotFoundException if the package is no longer installed.
app | Information about the desired application. |
---|
Retrieve all of the information we know about a particular service class.
Throws PackageManager.NameNotFoundException
if a service with the given
class name cannot be found on the system.
className | The full component name (i.e. com.google.apps.media/com.google.apps.media.BackgroundPlayback) of a Service class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
Get a list of features that are available on the system.
Get a list of shared libraries that are available on the system.
Retrieve text from a package. This is a low-level API used by
the various package manager info structures (such as
ComponentInfo
to implement retrieval of their associated
labels and other text.
packageName | The name of the package that this text is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired text. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
If the target user is a managed profile of the calling user or the caller is itself a managed profile, then this returns a badged copy of the given drawable allowing the user to distinguish it from the original drawable. The caller can specify the location in the bounds of the drawable to be badged where the badge should be applied as well as the density of the badge to be used.
If the original drawable is a BitmapDrawable and the backing bitmap is
mutable as per isMutable()
, the bading
is performed in place and the original drawable is returned.
drawable | The drawable to badge. |
---|---|
user | The target user. |
badgeLocation | Where in the bounds of the badged drawable to place the badge. If not provided, the badge is applied on top of the entire drawable being badged. |
badgeDensity | The optional desired density for the badge as per
densityDpi . If not provided,
the density of the display is used. |
If the target user is a managed profile of the calling user or if the
target user is the caller and is itself a managed profile, then this
returns a badged copy of the given icon to be able to distinguish it from
the original icon. For badging an arbitrary drawable use
getUserBadgedDrawableForDensity(android.graphics.drawable.Drawable, UserHandle, android.graphics.Rect, int)
.
If the original drawable is a BitmapDrawable and the backing bitmap is
mutable as per isMutable()
, the badging
is performed in place and the original drawable is returned.
icon | The icon to badge. |
---|---|
user | The target user. |
If the target user is a managed profile of the calling user or the caller is itself a managed profile, then this returns a copy of the label with badging for accessibility services like talkback. E.g. passing in "Email" and it might return "Work Email" for Email in the work profile.
label | The label to change. |
---|---|
user | The target user. |
Retrieve an XML file from a package. This is a low-level API used to retrieve XML meta data.
packageName | The name of the package that this xml is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired xml. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Check whether the given feature name is one of the available
features as returned by getSystemAvailableFeatures()
.
Checks whether a particular permissions has been revoked for a package by policy. Typically the device owner or the profile owner may apply such a policy. The user cannot grant policy revoked permissions, hence the only way for an app to get such a permission is by a policy change.
permName | The name of the permission you are checking for. |
---|---|
pkgName | The name of the package you are checking against. |
Return whether the device has been booted into safe mode.
Retrieve all receivers that can handle a broadcast of the given intent.
intent | The desired intent as per resolveActivity(). |
---|---|
flags | Additional option flags. |
Retrieve content provider information.
Note: unlike most other methods, an empty result set is indicated by a null return instead of an empty list.
processName | If non-null, limits the returned providers to only those that are hosted by the given process. If null, all content providers are returned. |
---|---|
uid | If processName is non-null, this is the required uid owning the requested content providers. |
flags | Additional option flags. Currently should always be 0. |
Retrieve information about available instrumentation code. May be used to retrieve either all instrumentation code, or only the code targeting a particular package.
targetPackage | If null, all instrumentation is returned; only the instrumentation targeting this package name is returned. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Retrieve all activities that can be performed for the given intent.
intent | The desired intent as per resolveActivity(). |
---|---|
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT .
You can also set MATCH_ALL for preventing the filtering of the results. |
resolveActivity(Intent, int)
. If there are no matching activities, an empty
list is returned.Retrieve a set of activities that should be presented to the user as
similar options. This is like queryIntentActivities(Intent, int)
, except it
also allows you to supply a list of more explicit Intents that you would
like to resolve to particular options, and takes care of returning the
final ResolveInfo list in a reasonable order, with no duplicates, based
on those inputs.
caller | The class name of the activity that is making the request. This activity will never appear in the output list. Can be null. |
---|---|
specifics | An array of Intents that should be resolved to the first specific results. Can be null. |
intent | The desired intent as per resolveActivity(). |
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT . |
Retrieve all providers that can match the given intent.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. |
null
is returned.Retrieve all services that can match the given intent.
intent | The desired intent as per resolveService(). |
---|---|
flags | Additional option flags. |
null
is returned.Query for all of the permissions associated with a particular group.
Throws PackageManager.NameNotFoundException
if the given group does not
exist.
group | The fully qualified name (i.e. com.google.permission.LOGIN) of the permission group you are interested in. Use null to find all of the permissions not associated with a group. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permissions. |
PermissionInfo
containing information
about all of the permissions in the given group.
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
Removes a permission that was previously added with
addPermission(PermissionInfo)
. The same ownership rules apply
-- you are only allowed to remove permissions that you are allowed
to add.
name | The name of the permission to remove. |
---|
Determine the best action to perform for a given Intent. This is how
resolveActivity(PackageManager)
finds an activity if a class has not
been explicitly specified.
Note: if using an implicit Intent (without an explicit ComponentName
specified), be sure to consider whether to set the MATCH_DEFAULT_ONLY
only flag. You need to do so to resolve the activity in the same way
that startActivity(Intent)
and
Intent.resolveActivity(PackageManager)
do.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT . |
Find a single content provider by its base path name.
name | The name of the provider to find. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Determine the best service to handle for a given Intent.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. |
Set the enabled setting for an application
This setting will override any enabled state which may have been set by the application in
its manifest. It also overrides the enabled state set in the manifest for any of the
application's components. It does not override any enabled state set by
setComponentEnabledSetting(ComponentName, int, int)
for any of the application's components.
packageName | The package name of the application to enable |
---|---|
newState | The new enabled state for the component. The legal values for this state
are:
COMPONENT_ENABLED_STATE_ENABLED ,
COMPONENT_ENABLED_STATE_DISABLED
and
COMPONENT_ENABLED_STATE_DEFAULT
The last one removes the setting, thereby restoring the applications's state to
whatever was set in its manifest (or enabled, by default). |
flags | Optional behavior flags: DONT_KILL_APP or 0.
|
Set the enabled setting for a package component (activity, receiver, service, provider). This setting will override any enabled state which may have been set by the component in its manifest.
componentName | The component to enable |
---|---|
newState | The new enabled state for the component. The legal values for this state
are:
COMPONENT_ENABLED_STATE_ENABLED ,
COMPONENT_ENABLED_STATE_DISABLED
and
COMPONENT_ENABLED_STATE_DEFAULT
The last one removes the setting, thereby restoring the component's state to
whatever was set in it's manifest (or enabled, by default). |
flags | Optional behavior flags: DONT_KILL_APP or 0.
|
Set the default Browser package name for a specific user.
packageName | The package name of the default Browser. |
---|---|
userId | The user id. |
Change the installer associated with a given package. There are limitations on how the installer package can be changed; in particular:
targetPackage | The installed package whose installer will be changed. |
---|---|
installerPackageName | The package name of the new installer. May be null to clear the association. |
Allows a package listening to the
package verification
broadcast
to respond to the package manager. The response must include
the verificationCode
which is one of
VERIFICATION_ALLOW
or
VERIFICATION_REJECT
.
id | pending package identifier as passed via the
EXTRA_VERIFICATION_ID Intent extra. |
---|---|
verificationCode | either VERIFICATION_ALLOW
or VERIFICATION_REJECT . |