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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Add a new package to the list of preferred packages.
| |||||||||||
Add a new dynamic permission to the system.
| |||||||||||
Add a new preferred activity mapping to the system.
| |||||||||||
Check whether a particular package has been granted a particular
permission.
| |||||||||||
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.
| |||||||||||
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 all of the known permission groups in the system.
| |||||||||||
Return the 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.
| |||||||||||
Return the 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.
| |||||||||||
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 all of the information we know about a particular
instrumentation class.
| |||||||||||
Return a "good" intent to launch a front-door 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.
| |||||||||||
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 receiver
class.
| |||||||||||
Retrieve the resources associated with an activity.
| |||||||||||
Retrieve the resources for an application.
| |||||||||||
Retrieve the resources associated with an application.
| |||||||||||
Retrieve all of the information we know about a particular service
class.
| |||||||||||
Get a list of shared libraries that are available on the
system.
| |||||||||||
Retrieve text from a package.
| |||||||||||
Retrieve an XML file from a package.
| |||||||||||
Install a package.
| |||||||||||
Install a package.
| |||||||||||
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 services that can match the given intent.
| |||||||||||
Query for all of the permissions associated with a particular group.
| |||||||||||
Remove a package from the list of preferred packages.
| |||||||||||
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).
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class android.content.pm.PackageManager
| |||||||||||
From class java.lang.Object
|
Add a new package to the list of preferred packages. This new package will be added to the front of the list (removed from its current location if already listed), meaning it will now be preferred over all other packages when resolving conflicts.
packageName | The package name of the new package to make preferred. |
---|
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. |
---|
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. |
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. |
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. |
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.
packageName | The name of the package whose preferred activity mappings are to be removed. |
---|
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() can not be found or the Intent can not 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 can not 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 can not be found on the system.
className | The full name (i.e. 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. |
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. |
---|
Return the 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 component to retrieve. |
---|
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 can not 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 can not 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. |
Return the label to use for this application.
info | The application to get the label of |
---|
Return the 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. |
---|
Return the generic icon for an activity that is used when no specific icon is defined.
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. Can not be null. |
---|---|
resid | The resource identifier of the desired image. Can not 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, {link #GET_UNINSTALLED_PACKAGES} to modify the data 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. |
---|
Retrieve all of the information we know about a particular instrumentation class.
Throws PackageManager.NameNotFoundException if instrumentation with the given class name can not 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. |
Return a "good" intent to launch a front-door activity in a package, for use for example to implement an "open" button when browsing through packages. The current implementation will look first for a main activity in the category CATEGORY_INFO, next for a main activity in the category CATEGORY_LAUNCHER, or return null if neither are found.
Throws PackageManager.NameNotFoundException if a package with the given name can not 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 possibly 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 can not 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. |
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. |
---|
Retrieve all of the information we know about a particular group of permissions.
Throws PackageManager.NameNotFoundException if a permission group with the given name can not 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. |
Retrieve all of the information we know about a particular permission.
Throws PackageManager.NameNotFoundException if a permission with the given name can not 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. |
Retrieve all preferred activities, previously added with addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName), that are currently registered with the system.
outFilters | A list in which to place the filters of all of the preferred activities, or null for none. |
---|---|
outActivities | A list in which to place the component names of all of the preferred activities, or null for none. |
packageName | An option 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 receiver class.
Throws PackageManager.NameNotFoundException if a receiver with the given class name can not be found on the system.
className | The full name (i.e. com.google.apps.contacts.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. |
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 can not be found, NameNotFoundException is thrown.
activityName | Name of the activity 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 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 can not be found, NameNotFoundException is thrown.
appPackageName | Package name of the application whose resources are to be retrieved. |
---|
Retrieve all of the information we know about a particular service class.
Throws PackageManager.NameNotFoundException if a service with the given class name can not be found on the system.
className | The full name (i.e. 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 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. Can not be null. |
---|---|
resid | The resource identifier of the desired text. Can not 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. |
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. Can not be null. |
---|---|
resid | The resource identifier of the desired xml. Can not 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. |
Install a package. Since this may take a little while, the result will be posted back to the given observer. An installation will fail if the calling context lacks the INSTALL_PACKAGES permission, if the package named in the package file's manifest is already installed, or if there's no space available on the device.
packageURI | The location of the package file to install. This can be a 'file:' or a 'content:' URI. |
---|---|
observer | An observer callback to get notified when the package installation is complete. packageInstalled(String, int) will be called when that happens. observer may be null to indicate that no callback is desired. |
flags | - possible values: FORWARD_LOCK_PACKAGE, REPLACE_EXISTING_PACKAGE |
Install a package.
packageURI | The location of the package file to install |
---|
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. The most important is MATCH_DEFAULT_ONLY, to limit the resolution to only those activities that support the CATEGORY_DEFAULT. |
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. |
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 services that can match the given intent.
intent | The desired intent as per resolveService(). |
---|---|
flags | Additional option flags. |
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. |
Remove a package from the list of preferred packages. If it was on the list, it will no longer be preferred over other packages.
packageName | The package name to remove. |
---|
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.
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. |