MockPackageManager

MockPackageManager

MockPackageManager ()

addPackageToPreferred

void addPackageToPreferred (String packageName)

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.

addPermission

boolean addPermission (PermissionInfo info)

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.

addPermissionAsync

boolean addPermissionAsync (PermissionInfo info)

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.

addPreferredActivity

void addPreferredActivity (IntentFilter filter, 
                int match, 
                ComponentName[] set, 
                ComponentName activity)

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.

canonicalToCurrentPackageNames

String[] canonicalToCurrentPackageNames (String[] names)

Map from a packages canonical name to the current name in use on the device.

checkPermission

int checkPermission (String permName, 
                String pkgName)

Check whether a particular package has been granted a particular permission.

checkSignatures

int checkSignatures (String pkg1, 
                String pkg2)

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.

checkSignatures

int checkSignatures (int uid1, 
                int uid2)

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.

clearPackagePreferredActivities

void clearPackagePreferredActivities (String packageName)

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).

currentToCanonicalPackageNames

String[] currentToCanonicalPackageNames (String[] names)

Map from the current package names in use on the device to whatever the current canonical name of that package is.

extendVerificationTimeout

void extendVerificationTimeout (int id, 
                int verificationCodeAtTimeout, 
                long millisecondsToDelay)

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.

getActivityBanner

Drawable getActivityBanner (Intent intent)

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.

getActivityBanner

Drawable getActivityBanner (ComponentName activityName)

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.

getActivityIcon

Drawable getActivityIcon (Intent intent)

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.

getActivityIcon

Drawable getActivityIcon (ComponentName activityName)

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.

getActivityInfo

ActivityInfo getActivityInfo (ComponentName className, 
                int flags)

Retrieve all of the information we know about a particular activity class.

getActivityLogo

Drawable getActivityLogo (Intent intent)

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.

getActivityLogo

Drawable getActivityLogo (ComponentName activityName)

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.

getAllIntentFilters

List<IntentFilter> getAllIntentFilters (String packageName)

Get the list of IntentFilter for a specific package.

getAllPermissionGroups

List<PermissionGroupInfo> getAllPermissionGroups (int flags)

Retrieve all of the known permission groups in the system.

getApplicationBanner

Drawable getApplicationBanner (ApplicationInfo info)

Retrieve the banner associated with an application.

getApplicationBanner

Drawable getApplicationBanner (String packageName)

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.

getApplicationEnabledSetting

int getApplicationEnabledSetting (String packageName)

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.

getApplicationIcon

Drawable getApplicationIcon (String packageName)

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.

getApplicationIcon

Drawable getApplicationIcon (ApplicationInfo info)

Retrieve the icon associated with an application. If it has not defined an icon, the default app icon is returned. Does not return null.

getApplicationInfo

ApplicationInfo getApplicationInfo (String packageName, 
                int flags)

Retrieve all of the information we know about a particular package/application.

getApplicationLabel

CharSequence getApplicationLabel (ApplicationInfo info)

Return the label to use for this application.

getApplicationLogo

Drawable getApplicationLogo (String packageName)

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.

getApplicationLogo

Drawable getApplicationLogo (ApplicationInfo info)

Retrieve the logo associated with an application. If it has not specified a logo, this method returns null.

getComponentEnabledSetting

int getComponentEnabledSetting (ComponentName componentName)

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.

getDefaultActivityIcon

Drawable getDefaultActivityIcon ()

Return the generic icon for an activity that is used when no specific icon is defined.

getDrawable

Drawable getDrawable (String packageName, 
                int resid, 
                ApplicationInfo appInfo)

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.

getInstalledApplications

List<ApplicationInfo> getInstalledApplications (int flags)

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.

getInstalledPackages

List<PackageInfo> getInstalledPackages (int flags)

Return a List of all packages that are installed on the device.

getInstallerPackageName

String getInstallerPackageName (String packageName)

Retrieve the package name of the application that installed a package. This identifies which market the package came from.

getInstrumentationInfo

InstrumentationInfo getInstrumentationInfo (ComponentName className, 
                int flags)

Retrieve all of the information we know about a particular instrumentation class.

getLaunchIntentForPackage

Intent getLaunchIntentForPackage (String packageName)

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.

getLeanbackLaunchIntentForPackage

Intent getLeanbackLaunchIntentForPackage (String packageName)

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.

getNameForUid

String getNameForUid (int uid)

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.

getPackageArchiveInfo

PackageInfo getPackageArchiveInfo (String archiveFilePath, 
                int flags)

Retrieve overall information about an application package defined in a package archive file

getPackageGids

int[] getPackageGids (String packageName)

Return an array of all of the POSIX secondary group IDs that have been assigned to the given package.

Note that the same package may have different GIDs under different UserHandle on the same device.

getPackageGids

int[] getPackageGids (String packageName, 
                int flags)

Return an array of all of the POSIX secondary group IDs that have been assigned to the given package.

Note that the same package may have different GIDs under different UserHandle on the same device.

getPackageInfo

PackageInfo getPackageInfo (String packageName, 
                int flags)

Retrieve overall information about an application package that is installed on the system.

getPackageUid

int getPackageUid (String packageName, 
                int flags)

Return the UID associated with the given package name.

Note that the same package will have different UIDs under different UserHandle on the same device.

getPackagesForUid

String[] getPackagesForUid (int uid)

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.

getPackagesHoldingPermissions

List<PackageInfo> getPackagesHoldingPermissions (String[] permissions, 
                int flags)

Return a List of all installed packages that are currently holding any of the given permissions.

getPermissionGroupInfo

PermissionGroupInfo getPermissionGroupInfo (String name, 
                int flags)

Retrieve all of the information we know about a particular group of permissions.

getPermissionInfo

PermissionInfo getPermissionInfo (String name, 
                int flags)

Retrieve all of the information we know about a particular permission.

getPreferredActivities

int getPreferredActivities (List<IntentFilter> outFilters, 
                List<ComponentName> outActivities, 
                String packageName)

Retrieve all preferred activities, previously added with addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName), that are currently registered with the system.

getPreferredPackages

List<PackageInfo> getPreferredPackages (int flags)

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.

getProviderInfo

ProviderInfo getProviderInfo (ComponentName className, 
                int flags)

Retrieve all of the information we know about a particular content provider class.

getReceiverInfo

ActivityInfo getReceiverInfo (ComponentName className, 
                int flags)

Retrieve all of the information we know about a particular receiver class.

getResourcesForActivity

Resources getResourcesForActivity (ComponentName activityName)

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.

getResourcesForApplication

Resources getResourcesForApplication (String appPackageName)

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.

getResourcesForApplication

Resources getResourcesForApplication (ApplicationInfo app)

Retrieve the resources for an application. Throws NameNotFoundException if the package is no longer installed.

getServiceInfo

ServiceInfo getServiceInfo (ComponentName className, 
                int flags)

Retrieve all of the information we know about a particular service class.

getSystemAvailableFeatures

FeatureInfo[] getSystemAvailableFeatures ()

Get a list of features that are available on the system.

getSystemSharedLibraryNames

String[] getSystemSharedLibraryNames ()

Get a list of shared libraries that are available on the system.

getText

CharSequence getText (String packageName, 
                int resid, 
                ApplicationInfo appInfo)

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.

getUserBadgedDrawableForDensity

Drawable getUserBadgedDrawableForDensity (Drawable drawable, 
                UserHandle user, 
                Rect badgeLocation, 
                int badgeDensity)

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 badging is performed in place and the original drawable is returned.

getUserBadgedIcon

Drawable getUserBadgedIcon (Drawable icon, 
                UserHandle user)

If the target user is 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.

getUserBadgedLabel

CharSequence getUserBadgedLabel (CharSequence label, 
                UserHandle 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.

getXml

XmlResourceParser getXml (String packageName, 
                int resid, 
                ApplicationInfo appInfo)

Retrieve an XML file from a package. This is a low-level API used to retrieve XML meta data.

hasSystemFeature

boolean hasSystemFeature (String name)

Check whether the given feature name is one of the available features as returned by getSystemAvailableFeatures(). This tests for the presence of any version of the given feature name; use hasSystemFeature(String, int) to check for a minimum version.

hasSystemFeature

boolean hasSystemFeature (String name, 
                int version)

Check whether the given feature name and version is one of the available features as returned by getSystemAvailableFeatures(). Since features are defined to always be backwards compatible, this returns true if the available feature version is greater than or equal to the requested version.

isPermissionRevokedByPolicy

boolean isPermissionRevokedByPolicy (String permName, 
                String pkgName)

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.

isSafeMode

boolean isSafeMode ()

Return whether the device has been booted into safe mode.

queryBroadcastReceivers

List<ResolveInfo> queryBroadcastReceivers (Intent intent, 
                int flags)

Retrieve all receivers that can handle a broadcast of the given intent.

queryContentProviders

List<ProviderInfo> queryContentProviders (String processName, 
                int uid, 
                int 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.

queryInstrumentation

List<InstrumentationInfo> queryInstrumentation (String targetPackage, 
                int flags)

Retrieve information about available instrumentation code. May be used to retrieve either all instrumentation code, or only the code targeting a particular package.

queryIntentActivities

List<ResolveInfo> queryIntentActivities (Intent intent, 
                int flags)

Retrieve all activities that can be performed for the given intent.

queryIntentActivityOptions

List<ResolveInfo> queryIntentActivityOptions (ComponentName caller, 
                Intent[] specifics, 
                Intent intent, 
                int flags)

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.

queryIntentContentProviders

List<ResolveInfo> queryIntentContentProviders (Intent intent, 
                int flags)

Retrieve all providers that can match the given intent.

queryIntentServices

List<ResolveInfo> queryIntentServices (Intent intent, 
                int flags)

Retrieve all services that can match the given intent.

queryPermissionsByGroup

List<PermissionInfo> queryPermissionsByGroup (String group, 
                int flags)

Query for all of the permissions associated with a particular group.

removePackageFromPreferred

void removePackageFromPreferred (String packageName)

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.

removePermission

void removePermission (String name)

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.

resolveActivity

ResolveInfo resolveActivity (Intent intent, 
                int flags)

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.

resolveContentProvider

ProviderInfo resolveContentProvider (String name, 
                int flags)

Find a single content provider by its base path name.

resolveService

ResolveInfo resolveService (Intent intent, 
                int flags)

Determine the best service to handle for a given Intent.

setApplicationEnabledSetting

void setApplicationEnabledSetting (String packageName, 
                int newState, 
                int 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.

setComponentEnabledSetting

void setComponentEnabledSetting (ComponentName componentName, 
                int newState, 
                int flags)

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.

setInstallerPackageName

void setInstallerPackageName (String targetPackage, 
                String installerPackageName)

Change the installer associated with a given package. There are limitations on how the installer package can be changed; in particular:

• A SecurityException will be thrown if installerPackageName is not signed with the same certificate as the calling application.
• A SecurityException will be thrown if targetPackage already has an installer package, and that installer package is not signed with the same certificate as the calling application.

verifyPendingInstall

void verifyPendingInstall (int id, 
                int verificationCode)

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.