/* * Copyright (C) 2006 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.content.pm; import android.Manifest; import android.annotation.CheckResult; import android.annotation.DrawableRes; import android.annotation.IntDef; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.RequiresPermission; import android.annotation.SdkConstant; import android.annotation.SdkConstant.SdkConstantType; import android.annotation.StringRes; import android.annotation.SystemApi; import android.annotation.TestApi; import android.annotation.UserIdInt; import android.annotation.XmlRes; import android.app.PackageDeleteObserver; import android.app.PackageInstallObserver; import android.app.admin.DevicePolicyManager; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.IntentFilter; import android.content.IntentSender; import android.content.pm.PackageParser.PackageParserException; import android.content.res.Resources; import android.content.res.XmlResourceParser; import android.graphics.Rect; import android.graphics.drawable.Drawable; import android.net.Uri; import android.os.Bundle; import android.os.Handler; import android.os.RemoteException; import android.os.UserHandle; import android.os.storage.VolumeInfo; import android.util.AndroidException; import android.util.Log; import com.android.internal.util.ArrayUtils; import java.io.File; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.util.List; /** * Class for retrieving various kinds of information related to the application * packages that are currently installed on the device. * * You can find this class through {@link Context#getPackageManager}. */ public abstract class PackageManager { private static final String TAG = "PackageManager"; /** {@hide} */ public static final boolean APPLY_FORCE_DEVICE_ENCRYPTED = true; /** * This exception is thrown when a given package, application, or component * name cannot be found. */ public static class NameNotFoundException extends AndroidException { public NameNotFoundException() { } public NameNotFoundException(String name) { super(name); } } /** * Listener for changes in permissions granted to a UID. * * @hide */ @SystemApi public interface OnPermissionsChangedListener { /** * Called when the permissions for a UID change. * @param uid The UID with a change. */ public void onPermissionsChanged(int uid); } /** * As a guiding principle: *
* {@code GET_} flags are used to request additional data that may have been * elided to save wire space. *
* {@code MATCH_} flags are used to include components or packages that * would have otherwise been omitted from a result set by current system * state. */ /** @hide */ @IntDef(flag = true, value = { GET_ACTIVITIES, GET_CONFIGURATIONS, GET_GIDS, GET_INSTRUMENTATION, GET_INTENT_FILTERS, GET_META_DATA, GET_PERMISSIONS, GET_PROVIDERS, GET_RECEIVERS, GET_SERVICES, GET_SHARED_LIBRARY_FILES, GET_SIGNATURES, GET_URI_PERMISSION_PATTERNS, MATCH_UNINSTALLED_PACKAGES, MATCH_DISABLED_COMPONENTS, MATCH_DISABLED_UNTIL_USED_COMPONENTS, MATCH_SYSTEM_ONLY, MATCH_DEBUG_TRIAGED_MISSING, }) @Retention(RetentionPolicy.SOURCE) public @interface PackageInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, GET_SHARED_LIBRARY_FILES, MATCH_UNINSTALLED_PACKAGES, MATCH_SYSTEM_ONLY, MATCH_DEBUG_TRIAGED_MISSING, }) @Retention(RetentionPolicy.SOURCE) public @interface ApplicationInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, GET_SHARED_LIBRARY_FILES, MATCH_ALL, MATCH_DEBUG_TRIAGED_MISSING, MATCH_DEFAULT_ONLY, MATCH_DISABLED_COMPONENTS, MATCH_DISABLED_UNTIL_USED_COMPONENTS, MATCH_ENCRYPTION_AWARE, MATCH_ENCRYPTION_AWARE_AND_UNAWARE, MATCH_ENCRYPTION_UNAWARE, MATCH_SYSTEM_ONLY, MATCH_UNINSTALLED_PACKAGES, }) @Retention(RetentionPolicy.SOURCE) public @interface ComponentInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, GET_RESOLVED_FILTER, GET_SHARED_LIBRARY_FILES, MATCH_ALL, MATCH_DEBUG_TRIAGED_MISSING, MATCH_DISABLED_COMPONENTS, MATCH_DISABLED_UNTIL_USED_COMPONENTS, MATCH_DEFAULT_ONLY, MATCH_ENCRYPTION_AWARE, MATCH_ENCRYPTION_AWARE_AND_UNAWARE, MATCH_ENCRYPTION_UNAWARE, MATCH_SYSTEM_ONLY, MATCH_UNINSTALLED_PACKAGES, }) @Retention(RetentionPolicy.SOURCE) public @interface ResolveInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, }) @Retention(RetentionPolicy.SOURCE) public @interface PermissionInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, }) @Retention(RetentionPolicy.SOURCE) public @interface PermissionGroupInfoFlags {} /** @hide */ @IntDef(flag = true, value = { GET_META_DATA, }) @Retention(RetentionPolicy.SOURCE) public @interface InstrumentationInfoFlags {} /** * {@link PackageInfo} flag: return information about * activities in the package in {@link PackageInfo#activities}. */ public static final int GET_ACTIVITIES = 0x00000001; /** * {@link PackageInfo} flag: return information about * intent receivers in the package in * {@link PackageInfo#receivers}. */ public static final int GET_RECEIVERS = 0x00000002; /** * {@link PackageInfo} flag: return information about * services in the package in {@link PackageInfo#services}. */ public static final int GET_SERVICES = 0x00000004; /** * {@link PackageInfo} flag: return information about * content providers in the package in * {@link PackageInfo#providers}. */ public static final int GET_PROVIDERS = 0x00000008; /** * {@link PackageInfo} flag: return information about * instrumentation in the package in * {@link PackageInfo#instrumentation}. */ public static final int GET_INSTRUMENTATION = 0x00000010; /** * {@link PackageInfo} flag: return information about the * intent filters supported by the activity. */ public static final int GET_INTENT_FILTERS = 0x00000020; /** * {@link PackageInfo} flag: return information about the * signatures included in the package. */ public static final int GET_SIGNATURES = 0x00000040; /** * {@link ResolveInfo} flag: return the IntentFilter that * was matched for a particular ResolveInfo in * {@link ResolveInfo#filter}. */ public static final int GET_RESOLVED_FILTER = 0x00000040; /** * {@link ComponentInfo} flag: return the {@link ComponentInfo#metaData} * data {@link android.os.Bundle}s that are associated with a component. * This applies for any API returning a ComponentInfo subclass. */ public static final int GET_META_DATA = 0x00000080; /** * {@link PackageInfo} flag: return the * {@link PackageInfo#gids group ids} that are associated with an * application. * This applies for any API returning a PackageInfo class, either * directly or nested inside of another. */ public static final int GET_GIDS = 0x00000100; /** * @deprecated replaced with {@link #MATCH_DISABLED_COMPONENTS} */ @Deprecated public static final int GET_DISABLED_COMPONENTS = 0x00000200; /** * {@link PackageInfo} flag: include disabled components in the returned info. */ public static final int MATCH_DISABLED_COMPONENTS = 0x00000200; /** * {@link ApplicationInfo} flag: return the * {@link ApplicationInfo#sharedLibraryFiles paths to the shared libraries} * that are associated with an application. * This applies for any API returning an ApplicationInfo class, either * directly or nested inside of another. */ public static final int GET_SHARED_LIBRARY_FILES = 0x00000400; /** * {@link ProviderInfo} flag: return the * {@link ProviderInfo#uriPermissionPatterns URI permission patterns} * that are associated with a content provider. * This applies for any API returning a ProviderInfo class, either * directly or nested inside of another. */ public static final int GET_URI_PERMISSION_PATTERNS = 0x00000800; /** * {@link PackageInfo} flag: return information about * permissions in the package in * {@link PackageInfo#permissions}. */ public static final int GET_PERMISSIONS = 0x00001000; /** * @deprecated replaced with {@link #MATCH_UNINSTALLED_PACKAGES} */ @Deprecated public static final int GET_UNINSTALLED_PACKAGES = 0x00002000; /** * Flag parameter to retrieve some information about all applications (even * uninstalled ones) which have data directories. This state could have * resulted if applications have been deleted with flag * {@code DONT_DELETE_DATA} with a possibility of being replaced or * reinstalled in future. *
* Note: this flag may cause less information about currently installed * applications to be returned. */ public static final int MATCH_UNINSTALLED_PACKAGES = 0x00002000; /** * {@link PackageInfo} flag: return information about * hardware preferences in * {@link PackageInfo#configPreferences PackageInfo.configPreferences}, * and requested features in {@link PackageInfo#reqFeatures} and * {@link PackageInfo#featureGroups}. */ public static final int GET_CONFIGURATIONS = 0x00004000; /** * @deprecated replaced with {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}. */ @Deprecated public static final int GET_DISABLED_UNTIL_USED_COMPONENTS = 0x00008000; /** * {@link PackageInfo} flag: include disabled components which are in * that state only because of {@link #COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED} * in the returned info. Note that if you set this flag, applications * that are in this disabled state will be reported as enabled. */ public static final int MATCH_DISABLED_UNTIL_USED_COMPONENTS = 0x00008000; /** * Resolution and querying flag: if set, only filters that support the * {@link android.content.Intent#CATEGORY_DEFAULT} will be considered for * matching. This is a synonym for including the CATEGORY_DEFAULT in your * supplied Intent. */ public static final int MATCH_DEFAULT_ONLY = 0x00010000; /** * Querying flag: if set and if the platform is doing any filtering of the * results, then the filtering will not happen. This is a synonym for saying * that all results should be returned. *
* This flag should be used with extreme care. */ public static final int MATCH_ALL = 0x00020000; /** * Querying flag: include only components which are encryption unaware in * the returned info, regardless of the current user state. */ public static final int MATCH_ENCRYPTION_UNAWARE = 0x00040000; /** * Querying flag: include only components which are encryption aware in the * returned info, regardless of the current user state. */ public static final int MATCH_ENCRYPTION_AWARE = 0x00080000; /** * Querying flag: include both encryption aware and unaware components in * the returned info, regardless of the current user state. */ public static final int MATCH_ENCRYPTION_AWARE_AND_UNAWARE = MATCH_ENCRYPTION_AWARE | MATCH_ENCRYPTION_UNAWARE; /** * Querying flag: include only components from applications that are marked * with {@link ApplicationInfo#FLAG_SYSTEM}. */ public static final int MATCH_SYSTEM_ONLY = 0x00100000; /** * Internal flag used to indicate that a system component has done their * homework and verified that they correctly handle packages and components * that come and go over time. In particular: *
* The package name of the app which has already defined the permission is * passed to a {@link PackageInstallObserver}, if any, as the * {@link #EXTRA_FAILURE_EXISTING_PACKAGE} string extra; and the name of the * permission being redefined is passed in the * {@link #EXTRA_FAILURE_EXISTING_PERMISSION} string extra. * * @hide */ public static final int INSTALL_FAILED_DUPLICATE_PERMISSION = -112; /** * Installation failed return code: this is passed to the * {@link IPackageInstallObserver} if the system failed to install the * package because its packaged native code did not match any of the ABIs * supported by the system. * * @hide */ public static final int INSTALL_FAILED_NO_MATCHING_ABIS = -113; /** * Internal return code for NativeLibraryHelper methods to indicate that the package * being processed did not contain any native code. This is placed here only so that * it can belong to the same value space as the other install failure codes. * * @hide */ public static final int NO_NATIVE_LIBRARIES = -114; /** {@hide} */ public static final int INSTALL_FAILED_ABORTED = -115; /** * Installation failed return code: ephemeral app installs are incompatible with some * other installation flags supplied for the operation; or other circumstances such * as trying to upgrade a system app via an ephemeral install. * @hide */ public static final int INSTALL_FAILED_EPHEMERAL_INVALID = -116; /** @hide */ @IntDef(flag = true, value = { DELETE_KEEP_DATA, DELETE_ALL_USERS, DELETE_SYSTEM_APP, }) @Retention(RetentionPolicy.SOURCE) public @interface DeleteFlags {} /** * Flag parameter for {@link #deletePackage} to indicate that you don't want to delete the * package's data directory. * * @hide */ public static final int DELETE_KEEP_DATA = 0x00000001; /** * Flag parameter for {@link #deletePackage} to indicate that you want the * package deleted for all users. * * @hide */ public static final int DELETE_ALL_USERS = 0x00000002; /** * Flag parameter for {@link #deletePackage} to indicate that, if you are calling * uninstall on a system that has been updated, then don't do the normal process * of uninstalling the update and rolling back to the older system version (which * needs to happen for all users); instead, just mark the app as uninstalled for * the current user. * * @hide */ public static final int DELETE_SYSTEM_APP = 0x00000004; /** * Return code for when package deletion succeeds. This is passed to the * {@link IPackageDeleteObserver} if the system succeeded in deleting the * package. * * @hide */ public static final int DELETE_SUCCEEDED = 1; /** * Deletion failed return code: this is passed to the * {@link IPackageDeleteObserver} if the system failed to delete the package * for an unspecified reason. * * @hide */ public static final int DELETE_FAILED_INTERNAL_ERROR = -1; /** * Deletion failed return code: this is passed to the * {@link IPackageDeleteObserver} if the system failed to delete the package * because it is the active DevicePolicy manager. * * @hide */ public static final int DELETE_FAILED_DEVICE_POLICY_MANAGER = -2; /** * Deletion failed return code: this is passed to the * {@link IPackageDeleteObserver} if the system failed to delete the package * since the user is restricted. * * @hide */ public static final int DELETE_FAILED_USER_RESTRICTED = -3; /** * Deletion failed return code: this is passed to the * {@link IPackageDeleteObserver} if the system failed to delete the package * because a profile or device owner has marked the package as * uninstallable. * * @hide */ public static final int DELETE_FAILED_OWNER_BLOCKED = -4; /** {@hide} */ public static final int DELETE_FAILED_ABORTED = -5; /** * Return code that is passed to the {@link IPackageMoveObserver} when the * package has been successfully moved by the system. * * @hide */ public static final int MOVE_SUCCEEDED = -100; /** * Error code that is passed to the {@link IPackageMoveObserver} when the * package hasn't been successfully moved by the system because of * insufficient memory on specified media. * * @hide */ public static final int MOVE_FAILED_INSUFFICIENT_STORAGE = -1; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package doesn't exist. * * @hide */ public static final int MOVE_FAILED_DOESNT_EXIST = -2; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package cannot be moved since its a system package. * * @hide */ public static final int MOVE_FAILED_SYSTEM_PACKAGE = -3; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package cannot be moved since its forward locked. * * @hide */ public static final int MOVE_FAILED_FORWARD_LOCKED = -4; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package cannot be moved to the specified location. * * @hide */ public static final int MOVE_FAILED_INVALID_LOCATION = -5; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package cannot be moved to the specified location. * * @hide */ public static final int MOVE_FAILED_INTERNAL_ERROR = -6; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package already has an operation pending in the queue. * * @hide */ public static final int MOVE_FAILED_OPERATION_PENDING = -7; /** * Error code that is passed to the {@link IPackageMoveObserver} if the * specified package cannot be moved since it contains a device admin. * * @hide */ public static final int MOVE_FAILED_DEVICE_ADMIN = -8; /** * Flag parameter for {@link #movePackage} to indicate that * the package should be moved to internal storage if its * been installed on external media. * @hide */ @Deprecated public static final int MOVE_INTERNAL = 0x00000001; /** * Flag parameter for {@link #movePackage} to indicate that * the package should be moved to external media. * @hide */ @Deprecated public static final int MOVE_EXTERNAL_MEDIA = 0x00000002; /** {@hide} */ public static final String EXTRA_MOVE_ID = "android.content.pm.extra.MOVE_ID"; /** * Usable by the required verifier as the {@code verificationCode} argument * for {@link PackageManager#verifyPendingInstall} to indicate that it will * allow the installation to proceed without any of the optional verifiers * needing to vote. * * @hide */ public static final int VERIFICATION_ALLOW_WITHOUT_SUFFICIENT = 2; /** * Used as the {@code verificationCode} argument for * {@link PackageManager#verifyPendingInstall} to indicate that the calling * package verifier allows the installation to proceed. */ public static final int VERIFICATION_ALLOW = 1; /** * Used as the {@code verificationCode} argument for * {@link PackageManager#verifyPendingInstall} to indicate the calling * package verifier does not vote to allow the installation to proceed. */ public static final int VERIFICATION_REJECT = -1; /** * Used as the {@code verificationCode} argument for * {@link PackageManager#verifyIntentFilter} to indicate that the calling * IntentFilter Verifier confirms that the IntentFilter is verified. * * @hide */ public static final int INTENT_FILTER_VERIFICATION_SUCCESS = 1; /** * Used as the {@code verificationCode} argument for * {@link PackageManager#verifyIntentFilter} to indicate that the calling * IntentFilter Verifier confirms that the IntentFilter is NOT verified. * * @hide */ public static final int INTENT_FILTER_VERIFICATION_FAILURE = -1; /** * Internal status code to indicate that an IntentFilter verification result is not specified. * * @hide */ public static final int INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_UNDEFINED = 0; /** * Used as the {@code status} argument for * {@link #updateIntentVerificationStatusAsUser} to indicate that the User * will always be prompted the Intent Disambiguation Dialog if there are two * or more Intent resolved for the IntentFilter's domain(s). * * @hide */ public static final int INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_ASK = 1; /** * Used as the {@code status} argument for * {@link #updateIntentVerificationStatusAsUser} to indicate that the User * will never be prompted the Intent Disambiguation Dialog if there are two * or more resolution of the Intent. The default App for the domain(s) * specified in the IntentFilter will also ALWAYS be used. * * @hide */ public static final int INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_ALWAYS = 2; /** * Used as the {@code status} argument for * {@link #updateIntentVerificationStatusAsUser} to indicate that the User * may be prompted the Intent Disambiguation Dialog if there are two or more * Intent resolved. The default App for the domain(s) specified in the * IntentFilter will also NEVER be presented to the User. * * @hide */ public static final int INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_NEVER = 3; /** * Used as the {@code status} argument for * {@link #updateIntentVerificationStatusAsUser} to indicate that this app * should always be considered as an ambiguous candidate for handling the * matching Intent even if there are other candidate apps in the "always" * state. Put another way: if there are any 'always ask' apps in a set of * more than one candidate app, then a disambiguation is *always* presented * even if there is another candidate app with the 'always' state. * * @hide */ public static final int INTENT_FILTER_DOMAIN_VERIFICATION_STATUS_ALWAYS_ASK = 4; /** * Can be used as the {@code millisecondsToDelay} argument for * {@link PackageManager#extendVerificationTimeout}. This is the * maximum time {@code PackageManager} waits for the verification * agent to return (in milliseconds). */ public static final long MAXIMUM_VERIFICATION_TIMEOUT = 60*60*1000; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: The device's * audio pipeline is low-latency, more suitable for audio applications sensitive to delays or * lag in sound input or output. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_AUDIO_LOW_LATENCY = "android.hardware.audio.low_latency"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device includes at least one form of audio * output, such as speakers, audio jack or streaming over bluetooth */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_AUDIO_OUTPUT = "android.hardware.audio.output"; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: * The device has professional audio level of functionality and performance. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_AUDIO_PRO = "android.hardware.audio.pro"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device is capable of communicating with * other devices via Bluetooth. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_BLUETOOTH = "android.hardware.bluetooth"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device is capable of communicating with * other devices via Bluetooth Low Energy radio. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_BLUETOOTH_LE = "android.hardware.bluetooth_le"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device has a camera facing away * from the screen. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA = "android.hardware.camera"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device's camera supports auto-focus. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_AUTOFOCUS = "android.hardware.camera.autofocus"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device has at least one camera pointing in * some direction, or can support an external camera being connected to it. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_ANY = "android.hardware.camera.any"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device can support having an external camera connected to it. * The external camera may not always be connected or available to applications to use. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_EXTERNAL = "android.hardware.camera.external"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device's camera supports flash. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_FLASH = "android.hardware.camera.flash"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device has a front facing camera. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_FRONT = "android.hardware.camera.front"; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: At least one * of the cameras on the device supports the * {@link android.hardware.camera2.CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL full hardware} * capability level. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_LEVEL_FULL = "android.hardware.camera.level.full"; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: At least one * of the cameras on the device supports the * {@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR manual sensor} * capability level. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_CAPABILITY_MANUAL_SENSOR = "android.hardware.camera.capability.manual_sensor"; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: At least one * of the cameras on the device supports the * {@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING manual post-processing} * capability level. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_CAPABILITY_MANUAL_POST_PROCESSING = "android.hardware.camera.capability.manual_post_processing"; /** * Feature for {@link #getSystemAvailableFeatures} and {@link #hasSystemFeature}: At least one * of the cameras on the device supports the * {@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_RAW RAW} * capability level. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CAMERA_CAPABILITY_RAW = "android.hardware.camera.capability.raw"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device is capable of communicating with * consumer IR devices. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_CONSUMER_IR = "android.hardware.consumerir"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device supports one or more methods of * reporting current location. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_LOCATION = "android.hardware.location"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device has a Global Positioning System * receiver and can report precise location. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_LOCATION_GPS = "android.hardware.location.gps"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device can report location with coarse * accuracy using a network-based geolocation system. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_LOCATION_NETWORK = "android.hardware.location.network"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device can record audio via a * microphone. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_MICROPHONE = "android.hardware.microphone"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device can communicate using Near-Field * Communications (NFC). */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_NFC = "android.hardware.nfc"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device supports host- * based NFC card emulation. * * TODO remove when depending apps have moved to new constant. * @hide * @deprecated */ @Deprecated @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_NFC_HCE = "android.hardware.nfc.hce"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device supports host- * based NFC card emulation. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_NFC_HOST_CARD_EMULATION = "android.hardware.nfc.hce"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device supports host- * based NFC-F card emulation. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_NFC_HOST_CARD_EMULATION_NFCF = "android.hardware.nfc.hcef"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: The device supports the OpenGL ES * * Android Extension Pack. */ @SdkConstant(SdkConstantType.FEATURE) public static final String FEATURE_OPENGLES_EXTENSION_PACK = "android.hardware.opengles.aep"; /** * Feature for {@link #getSystemAvailableFeatures} and * {@link #hasSystemFeature}: If this feature is supported, the Vulkan native API will enumerate * at least one {@code VkPhysicalDevice}, and the feature version will indicate what * level of optional hardware features limits it supports. *
* Level 0 includes the base Vulkan requirements as well as: *
* Level 1 additionally includes: *
* Type: String[] *
* * @hide */ @SystemApi public static final String EXTRA_REQUEST_PERMISSIONS_NAMES = "android.content.pm.extra.REQUEST_PERMISSIONS_NAMES"; /** * The results from the permissions request. ** Type: int[] of #PermissionResult *
* * @hide */ @SystemApi public static final String EXTRA_REQUEST_PERMISSIONS_RESULTS = "android.content.pm.extra.REQUEST_PERMISSIONS_RESULTS"; /** * String extra for {@link PackageInstallObserver} in the 'extras' Bundle in case of * {@link #INSTALL_FAILED_DUPLICATE_PERMISSION}. This extra names the package which provides * the existing definition for the permission. * @hide */ public static final String EXTRA_FAILURE_EXISTING_PACKAGE = "android.content.pm.extra.FAILURE_EXISTING_PACKAGE"; /** * String extra for {@link PackageInstallObserver} in the 'extras' Bundle in case of * {@link #INSTALL_FAILED_DUPLICATE_PERMISSION}. This extra names the permission that is * being redundantly defined by the package being installed. * @hide */ public static final String EXTRA_FAILURE_EXISTING_PERMISSION = "android.content.pm.extra.FAILURE_EXISTING_PERMISSION"; /** * Permission flag: The permission is set in its current state * by the user and apps can still request it at runtime. * * @hide */ public static final int FLAG_PERMISSION_USER_SET = 1 << 0; /** * Permission flag: The permission is set in its current state * by the user and it is fixed, i.e. apps can no longer request * this permission. * * @hide */ public static final int FLAG_PERMISSION_USER_FIXED = 1 << 1; /** * Permission flag: The permission is set in its current state * by device policy and neither apps nor the user can change * its state. * * @hide */ public static final int FLAG_PERMISSION_POLICY_FIXED = 1 << 2; /** * Permission flag: The permission is set in a granted state but * access to resources it guards is restricted by other means to * enable revoking a permission on legacy apps that do not support * runtime permissions. If this permission is upgraded to runtime * because the app was updated to support runtime permissions, the * the permission will be revoked in the upgrade process. * * @hide */ public static final int FLAG_PERMISSION_REVOKE_ON_UPGRADE = 1 << 3; /** * Permission flag: The permission is set in its current state * because the app is a component that is a part of the system. * * @hide */ public static final int FLAG_PERMISSION_SYSTEM_FIXED = 1 << 4; /** * Permission flag: The permission is granted by default because it * enables app functionality that is expected to work out-of-the-box * for providing a smooth user experience. For example, the phone app * is expected to have the phone permission. * * @hide */ public static final int FLAG_PERMISSION_GRANTED_BY_DEFAULT = 1 << 5; /** * Permission flag: The permission has to be reviewed before any of * the app components can run. * * @hide */ public static final int FLAG_PERMISSION_REVIEW_REQUIRED = 1 << 6; /** * Mask for all permission flags. * * @hide */ @SystemApi public static final int MASK_PERMISSION_FLAGS = 0xFF; /** * This is a library that contains components apps can invoke. For * example, a services for apps to bind to, or standard chooser UI, * etc. This library is versioned and backwards compatible. Clients * should check its version via {@link android.ext.services.Version * #getVersionCode()} and avoid calling APIs added in later versions. * * @hide */ public static final String SYSTEM_SHARED_LIBRARY_SERVICES = "android.ext.services"; /** * This is a library that contains components apps can dynamically * load. For example, new widgets, helper classes, etc. This library * is versioned and backwards compatible. Clients should check its * version via {@link android.ext.shared.Version#getVersionCode()} * and avoid calling APIs added in later versions. * * @hide */ public static final String SYSTEM_SHARED_LIBRARY_SHARED = "android.ext.shared"; /** * Retrieve overall information about an application package that is * installed on the system. * * @param packageName The full name (i.e. com.google.apps.contacts) of the * desired package. * @param flags Additional option flags. Use any combination of * {@link #GET_ACTIVITIES}, {@link #GET_CONFIGURATIONS}, * {@link #GET_GIDS}, {@link #GET_INSTRUMENTATION}, * {@link #GET_INTENT_FILTERS}, {@link #GET_META_DATA}, * {@link #GET_PERMISSIONS}, {@link #GET_PROVIDERS}, * {@link #GET_RECEIVERS}, {@link #GET_SERVICES}, * {@link #GET_SHARED_LIBRARY_FILES}, {@link #GET_SIGNATURES}, * {@link #GET_URI_PERMISSION_PATTERNS}, {@link #GET_UNINSTALLED_PACKAGES}, * {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}, * {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. * * @return A PackageInfo object containing information about the * package. If flag {@code MATCH_UNINSTALLED_PACKAGES} is set and if the * package is not found in the list of installed applications, the * package information is retrieved from the list of uninstalled * applications (which includes installed applications as well as * applications with data directory i.e. applications which had been * deleted with {@code DONT_DELETE_DATA} flag set). * @throws NameNotFoundException if a package with the given name cannot be * found on the system. * @see #GET_ACTIVITIES * @see #GET_CONFIGURATIONS * @see #GET_GIDS * @see #GET_INSTRUMENTATION * @see #GET_INTENT_FILTERS * @see #GET_META_DATA * @see #GET_PERMISSIONS * @see #GET_PROVIDERS * @see #GET_RECEIVERS * @see #GET_SERVICES * @see #GET_SHARED_LIBRARY_FILES * @see #GET_SIGNATURES * @see #GET_URI_PERMISSION_PATTERNS * @see #MATCH_DISABLED_COMPONENTS * @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS * @see #MATCH_UNINSTALLED_PACKAGES */ public abstract PackageInfo getPackageInfo(String packageName, @PackageInfoFlags int flags) throws NameNotFoundException; /** * @hide * Retrieve overall information about an application package that is * installed on the system. * * @param packageName The full name (i.e. com.google.apps.contacts) of the * desired package. * @param flags Additional option flags. Use any combination of * {@link #GET_ACTIVITIES}, {@link #GET_CONFIGURATIONS}, * {@link #GET_GIDS}, {@link #GET_INSTRUMENTATION}, * {@link #GET_INTENT_FILTERS}, {@link #GET_META_DATA}, * {@link #GET_PERMISSIONS}, {@link #GET_PROVIDERS}, * {@link #GET_RECEIVERS}, {@link #GET_SERVICES}, * {@link #GET_SHARED_LIBRARY_FILES}, {@link #GET_SIGNATURES}, * {@link #GET_URI_PERMISSION_PATTERNS}, {@link #GET_UNINSTALLED_PACKAGES}, * {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}, * {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. * @param userId The user id. * * @return A PackageInfo object containing information about the * package. If flag {@code MATCH_UNINSTALLED_PACKAGES} is set and if the * package is not found in the list of installed applications, the * package information is retrieved from the list of uninstalled * applications (which includes installed applications as well as * applications with data directory i.e. applications which had been * deleted with {@code DONT_DELETE_DATA} flag set). * @throws NameNotFoundException if a package with the given name cannot be * found on the system. * @see #GET_ACTIVITIES * @see #GET_CONFIGURATIONS * @see #GET_GIDS * @see #GET_INSTRUMENTATION * @see #GET_INTENT_FILTERS * @see #GET_META_DATA * @see #GET_PERMISSIONS * @see #GET_PROVIDERS * @see #GET_RECEIVERS * @see #GET_SERVICES * @see #GET_SHARED_LIBRARY_FILES * @see #GET_SIGNATURES * @see #GET_URI_PERMISSION_PATTERNS * @see #MATCH_DISABLED_COMPONENTS * @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS * @see #MATCH_UNINSTALLED_PACKAGES */ @RequiresPermission(Manifest.permission.INTERACT_ACROSS_USERS) public abstract PackageInfo getPackageInfoAsUser(String packageName, @PackageInfoFlags int flags, @UserIdInt int userId) throws NameNotFoundException; /** * Map from the current package names in use on the device to whatever * the current canonical name of that package is. * @param names Array of current names to be mapped. * @return Returns an array of the same size as the original, containing * the canonical name for each package. */ public abstract String[] currentToCanonicalPackageNames(String[] names); /** * Map from a packages canonical name to the current name in use on the device. * @param names Array of new names to be mapped. * @return Returns an array of the same size as the original, containing * the current name for each package. */ public abstract String[] canonicalToCurrentPackageNames(String[] names); /** * 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 {@link Intent#CATEGORY_INFO}, and next for a * main activity in the category {@link Intent#CATEGORY_LAUNCHER}. Returns *null
if neither are found.
*
* @param packageName The name of the package to inspect.
*
* @return A fully-qualified {@link 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.
*/
public abstract Intent getLaunchIntentForPackage(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 {@link Intent#CATEGORY_LEANBACK_LAUNCHER}, or
* return null if no main leanback activities are found.
*
* @param packageName The name of the package to inspect.
* @return Returns either a fully-qualified Intent that can be used to launch
* the main Leanback activity in the package, or null if the package
* does not contain such an activity.
*/
public abstract Intent getLeanbackLaunchIntentForPackage(String packageName);
/**
* Return an array of all of the secondary group-ids that have been assigned
* to a package.
*
* @param packageName The full name (i.e. com.google.apps.contacts) of the
* desired package.
* @return Returns an int array of the assigned gids, or null if there are
* none.
* @throws NameNotFoundException if a package with the given name cannot be
* found on the system.
*/
public abstract int[] getPackageGids(String packageName)
throws NameNotFoundException;
/**
* Return an array of all of the secondary group-ids that have been assigned
* to a package.
*
* @param packageName The full name (i.e. com.google.apps.contacts) of the
* desired package.
* @return Returns an int array of the assigned gids, or null if there are
* none.
* @throws NameNotFoundException if a package with the given name cannot be
* found on the system.
*/
public abstract int[] getPackageGids(String packageName, @PackageInfoFlags int flags)
throws NameNotFoundException;
/**
* Return the UID associated with the given package name.
*
* @param packageName The full name (i.e. com.google.apps.contacts) of the
* desired package.
* @return Returns an integer UID who owns the given package name.
* @throws NameNotFoundException if a package with the given name can not be
* found on the system.
*/
public abstract int getPackageUid(String packageName, @PackageInfoFlags int flags)
throws NameNotFoundException;
/**
* Return the UID associated with the given package name.
*
* @param packageName The full name (i.e. com.google.apps.contacts) of the
* desired package.
* @param userId The user handle identifier to look up the package under.
* @return Returns an integer UID who owns the given package name.
* @throws NameNotFoundException if a package with the given name can not be
* found on the system.
* @hide
*/
public abstract int getPackageUidAsUser(String packageName, @UserIdInt int userId)
throws NameNotFoundException;
/**
* Return the UID associated with the given package name.
*
* @param packageName The full name (i.e. com.google.apps.contacts) of the
* desired package.
* @param userId The user handle identifier to look up the package under.
* @return Returns an integer UID who owns the given package name.
* @throws NameNotFoundException if a package with the given name can not be
* found on the system.
* @hide
*/
public abstract int getPackageUidAsUser(String packageName, @PackageInfoFlags int flags,
@UserIdInt int userId) throws NameNotFoundException;
/**
* Retrieve all of the information we know about a particular permission.
*
* @param name The fully qualified name (i.e. com.google.permission.LOGIN)
* of the permission you are interested in.
* @param flags Additional option flags. Use {@link #GET_META_DATA} to
* retrieve any meta-data associated with the permission.
*
* @return Returns a {@link PermissionInfo} containing information about the
* permission.
* @throws NameNotFoundException if a package with the given name cannot be
* found on the system.
*
* @see #GET_META_DATA
*/
public abstract PermissionInfo getPermissionInfo(String name, @PermissionInfoFlags int flags)
throws NameNotFoundException;
/**
* Query for all of the permissions associated with a particular group.
*
* @param 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.
* @param flags Additional option flags. Use {@link #GET_META_DATA} to
* retrieve any meta-data associated with the permissions.
*
* @return Returns a list of {@link PermissionInfo} containing information
* about all of the permissions in the given group.
* @throws NameNotFoundException if a package with the given name cannot be
* found on the system.
*
* @see #GET_META_DATA
*/
public abstract ListIt 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. * * @param info Description of the permission to be added. * * @return Returns true if a new permission was created, false if an * existing one was updated. * * @throws SecurityException if you are not allowed to add the * given permission name. * * @see #removePermission(String) */ public abstract boolean addPermission(PermissionInfo info); /** * Like {@link #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. */ public abstract boolean addPermissionAsync(PermissionInfo info); /** * Removes a permission that was previously added with * {@link #addPermission(PermissionInfo)}. The same ownership rules apply * -- you are only allowed to remove permissions that you are allowed * to add. * * @param name The name of the permission to remove. * * @throws SecurityException if you are not allowed to remove the * given permission name. * * @see #addPermission(PermissionInfo) */ public abstract void removePermission(String name); /** * Permission flags set when granting or revoking a permission. * * @hide */ @SystemApi @IntDef({FLAG_PERMISSION_USER_SET, FLAG_PERMISSION_USER_FIXED, FLAG_PERMISSION_POLICY_FIXED, FLAG_PERMISSION_REVOKE_ON_UPGRADE, FLAG_PERMISSION_SYSTEM_FIXED, FLAG_PERMISSION_GRANTED_BY_DEFAULT}) @Retention(RetentionPolicy.SOURCE) public @interface PermissionFlags {} /** * Grant a runtime permission to an application which the application does not * already have. The permission must have been requested by the application. * If the application is not allowed to hold the permission, a {@link * java.lang.SecurityException} is thrown. *
* Note: Using this API requires holding * android.permission.GRANT_REVOKE_PERMISSIONS and if the user id is * not the current user android.permission.INTERACT_ACROSS_USERS_FULL. *
* * @param packageName The package to which to grant the permission. * @param permissionName The permission name to grant. * @param user The user for which to grant the permission. * * @see #revokeRuntimePermission(String, String, android.os.UserHandle) * @see android.content.pm.PackageManager.PermissionFlags * * @hide */ @SystemApi public abstract void grantRuntimePermission(@NonNull String packageName, @NonNull String permissionName, @NonNull UserHandle user); /** * Revoke a runtime permission that was previously granted by {@link * #grantRuntimePermission(String, String, android.os.UserHandle)}. The * permission must have been requested by and granted to the application. * If the application is not allowed to hold the permission, a {@link * java.lang.SecurityException} is thrown. ** Note: Using this API requires holding * android.permission.GRANT_REVOKE_PERMISSIONS and if the user id is * not the current user android.permission.INTERACT_ACROSS_USERS_FULL. *
* * @param packageName The package from which to revoke the permission. * @param permissionName The permission name to revoke. * @param user The user for which to revoke the permission. * * @see #grantRuntimePermission(String, String, android.os.UserHandle) * @see android.content.pm.PackageManager.PermissionFlags * * @hide */ @SystemApi public abstract void revokeRuntimePermission(@NonNull String packageName, @NonNull String permissionName, @NonNull UserHandle user); /** * Gets the state flags associated with a permission. * * @param permissionName The permission for which to get the flags. * @param packageName The package name for which to get the flags. * @param user The user for which to get permission flags. * @return The permission flags. * * @hide */ @SystemApi public abstract @PermissionFlags int getPermissionFlags(String permissionName, String packageName, @NonNull UserHandle user); /** * Updates the flags associated with a permission by replacing the flags in * the specified mask with the provided flag values. * * @param permissionName The permission for which to update the flags. * @param packageName The package name for which to update the flags. * @param flagMask The flags which to replace. * @param flagValues The flags with which to replace. * @param user The user for which to update the permission flags. * * @hide */ @SystemApi public abstract void updatePermissionFlags(String permissionName, String packageName, @PermissionFlags int flagMask, int flagValues, @NonNull UserHandle user); /** * Gets whether you should show UI with rationale for requesting a permission. * You should do this only if you do not have the permission and the context in * which the permission is requested does not clearly communicate to the user * what would be the benefit from grating this permission. * * @param permission A permission your app wants to request. * @return Whether you can show permission rationale UI. * * @hide */ public abstract boolean shouldShowRequestPermissionRationale(String permission); /** * Returns an {@link android.content.Intent} suitable for passing to * {@link android.app.Activity#startActivityForResult(android.content.Intent, int)} * which prompts the user to grant permissions to this application. * * @throws NullPointerException if {@code permissions} is {@code null} or empty. * * @hide */ public Intent buildRequestPermissionsIntent(@NonNull String[] permissions) { if (ArrayUtils.isEmpty(permissions)) { throw new IllegalArgumentException("permission cannot be null or empty"); } Intent intent = new Intent(ACTION_REQUEST_PERMISSIONS); intent.putExtra(EXTRA_REQUEST_PERMISSIONS_NAMES, permissions); intent.setPackage(getPermissionControllerPackageName()); return intent; } /** * 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. * * @param pkg1 First package name whose signature will be compared. * @param pkg2 Second package name whose signature will be compared. * * @return Returns an integer indicating whether all signatures on the * two packages match. The value is >= 0 ({@link #SIGNATURE_MATCH}) if * all signatures match or < 0 if there is not a match ({@link * #SIGNATURE_NO_MATCH} or {@link #SIGNATURE_UNKNOWN_PACKAGE}). * * @see #checkSignatures(int, int) * @see #SIGNATURE_MATCH * @see #SIGNATURE_NO_MATCH * @see #SIGNATURE_UNKNOWN_PACKAGE */ @CheckResult public abstract int checkSignatures(String pkg1, String pkg2); /** * Like {@link #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. * * @param uid1 First UID whose signature will be compared. * @param uid2 Second UID whose signature will be compared. * * @return Returns an integer indicating whether all signatures on the * two packages match. The value is >= 0 ({@link #SIGNATURE_MATCH}) if * all signatures match or < 0 if there is not a match ({@link * #SIGNATURE_NO_MATCH} or {@link #SIGNATURE_UNKNOWN_PACKAGE}). * * @see #checkSignatures(String, String) * @see #SIGNATURE_MATCH * @see #SIGNATURE_NO_MATCH * @see #SIGNATURE_UNKNOWN_PACKAGE */ @CheckResult public abstract int checkSignatures(int uid1, int uid2); /** * 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. * * @param uid The user id for which you would like to retrieve the * associated packages. * * @return Returns an array of one or more packages assigned to the user * id, or null if there are no known packages with the given id. */ public abstract @Nullable String[] getPackagesForUid(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. * * @param uid The user id for which you would like to retrieve a name. * @return Returns a unique name for the given user id, or null if the * user id is not currently assigned. */ public abstract @Nullable String getNameForUid(int uid); /** * Return the user id associated with a shared user name. Multiple * applications can specify a shared user name in their manifest and thus * end up using a common uid. This might be used for new applications * that use an existing shared user name and need to know the uid of the * shared user. * * @param sharedUserName The shared user name whose uid is to be retrieved. * @return Returns the UID associated with the shared user. * @throws NameNotFoundException if a package with the given name cannot be * found on the system. * @hide */ public abstract int getUidForSharedUser(String sharedUserName) throws NameNotFoundException; /** * 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 {@code DONT_DELETE_DATA} (partially * installed apps with data directory) will be returned. * * @param flags Additional option flags. Use any combination of * {@link #GET_META_DATA}, {@link #GET_SHARED_LIBRARY_FILES}, * {@link #MATCH_SYSTEM_ONLY}, {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. * * @return A List of ApplicationInfo objects, one for each installed application. * In the unlikely case there are no installed packages, an empty list * is returned. If flag {@code MATCH_UNINSTALLED_PACKAGES} is set, the * application information is retrieved from the list of uninstalled * applications (which includes installed applications as well as * applications with data directory i.e. applications which had been * deleted with {@code DONT_DELETE_DATA} flag set). * * @see #GET_META_DATA * @see #GET_SHARED_LIBRARY_FILES * @see #MATCH_SYSTEM_ONLY * @see #MATCH_UNINSTALLED_PACKAGES */ public abstract ListNote: if using an implicit Intent (without an explicit ComponentName * specified), be sure to consider whether to set the {@link #MATCH_DEFAULT_ONLY} * only flag. You need to do so to resolve the activity in the same way * that {@link android.content.Context#startActivity(Intent)} and * {@link android.content.Intent#resolveActivity(PackageManager) * Intent.resolveActivity(PackageManager)} do.
* * @param intent An intent containing all of the desired specification * (action, data, type, category, and/or component). * @param flags Additional option flags. Use any combination of * {@link #GET_META_DATA}, {@link #GET_RESOLVED_FILTER}, * {@link #GET_SHARED_LIBRARY_FILES}, {@link #MATCH_ALL}, * {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}, * {@link #MATCH_DEFAULT_ONLY}, {@link #MATCH_ENCRYPTION_AWARE}, * {@link #MATCH_ENCRYPTION_AWARE_AND_UNAWARE}, {@link #MATCH_ENCRYPTION_UNAWARE}, * {@link #MATCH_SYSTEM_ONLY}, {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. The most important is * {@link #MATCH_DEFAULT_ONLY}, to limit the resolution to only * those activities that support the {@link android.content.Intent#CATEGORY_DEFAULT}. * * @return Returns a ResolveInfo object containing the final activity intent * that was determined to be the best action. Returns null if no * matching activity was found. If multiple matching activities are * found and there is no default set, returns a ResolveInfo object * containing something else, such as the activity resolver. * * @see #GET_META_DATA * @see #GET_RESOLVED_FILTER * @see #GET_SHARED_LIBRARY_FILES * @see #MATCH_ALL * @see #MATCH_DISABLED_COMPONENTS * @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS * @see #MATCH_DEFAULT_ONLY * @see #MATCH_ENCRYPTION_AWARE * @see #MATCH_ENCRYPTION_AWARE_AND_UNAWARE * @see #MATCH_ENCRYPTION_UNAWARE * @see #MATCH_SYSTEM_ONLY * @see #MATCH_UNINSTALLED_PACKAGES */ public abstract ResolveInfo resolveActivity(Intent intent, @ResolveInfoFlags int flags); /** * Determine the best action to perform for a given Intent for a given user. This * is how {@link Intent#resolveActivity} 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 {@link #MATCH_DEFAULT_ONLY} * only flag. You need to do so to resolve the activity in the same way * that {@link android.content.Context#startActivity(Intent)} and * {@link android.content.Intent#resolveActivity(PackageManager) * Intent.resolveActivity(PackageManager)} do.
* * @param intent An intent containing all of the desired specification * (action, data, type, category, and/or component). * @param flags Additional option flags. Use any combination of * {@link #GET_META_DATA}, {@link #GET_RESOLVED_FILTER}, * {@link #GET_SHARED_LIBRARY_FILES}, {@link #MATCH_ALL}, * {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}, * {@link #MATCH_DEFAULT_ONLY}, {@link #MATCH_ENCRYPTION_AWARE}, * {@link #MATCH_ENCRYPTION_AWARE_AND_UNAWARE}, {@link #MATCH_ENCRYPTION_UNAWARE}, * {@link #MATCH_SYSTEM_ONLY}, {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. The most important is * {@link #MATCH_DEFAULT_ONLY}, to limit the resolution to only * those activities that support the {@link android.content.Intent#CATEGORY_DEFAULT}. * @param userId The user id. * * @return Returns a ResolveInfo object containing the final activity intent * that was determined to be the best action. Returns null if no * matching activity was found. If multiple matching activities are * found and there is no default set, returns a ResolveInfo object * containing something else, such as the activity resolver. * * @see #GET_META_DATA * @see #GET_RESOLVED_FILTER * @see #GET_SHARED_LIBRARY_FILES * @see #MATCH_ALL * @see #MATCH_DISABLED_COMPONENTS * @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS * @see #MATCH_DEFAULT_ONLY * @see #MATCH_ENCRYPTION_AWARE * @see #MATCH_ENCRYPTION_AWARE_AND_UNAWARE * @see #MATCH_ENCRYPTION_UNAWARE * @see #MATCH_SYSTEM_ONLY * @see #MATCH_UNINSTALLED_PACKAGES * * @hide */ public abstract ResolveInfo resolveActivityAsUser(Intent intent, @ResolveInfoFlags int flags, @UserIdInt int userId); /** * Retrieve all activities that can be performed for the given intent. * * @param intent The desired intent as per resolveActivity(). * @param flags Additional option flags. Use any combination of * {@link #GET_META_DATA}, {@link #GET_RESOLVED_FILTER}, * {@link #GET_SHARED_LIBRARY_FILES}, {@link #MATCH_ALL}, * {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS}, * {@link #MATCH_DEFAULT_ONLY}, {@link #MATCH_ENCRYPTION_AWARE}, * {@link #MATCH_ENCRYPTION_AWARE_AND_UNAWARE}, {@link #MATCH_ENCRYPTION_UNAWARE}, * {@link #MATCH_SYSTEM_ONLY}, {@link #MATCH_UNINSTALLED_PACKAGES} * to modify the data returned. The most important is * {@link #MATCH_DEFAULT_ONLY}, to limit the resolution to only * those activities that support the {@link android.content.Intent#CATEGORY_DEFAULT}. * Or, set {@link #MATCH_ALL} to prevent any filtering of the results. * * @return Returns a List of ResolveInfo objects containing one entry for each * matching activity, ordered from best to worst. In other words, the * first item is what would be returned by {@link #resolveActivity}. * If there are no matching activities, an empty list is returned. * * @see #GET_META_DATA * @see #GET_RESOLVED_FILTER * @see #GET_SHARED_LIBRARY_FILES * @see #MATCH_ALL * @see #MATCH_DISABLED_COMPONENTS * @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS * @see #MATCH_DEFAULT_ONLY * @see #MATCH_ENCRYPTION_AWARE * @see #MATCH_ENCRYPTION_AWARE_AND_UNAWARE * @see #MATCH_ENCRYPTION_UNAWARE * @see #MATCH_SYSTEM_ONLY * @see #MATCH_UNINSTALLED_PACKAGES */ public abstract ListNote: unlike most other methods, an empty result set is indicated
* by a null return instead of an empty list.
*
* @param 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.
* @param uid If processName is non-null, this is the required
* uid owning the requested content providers.
* @param flags Additional option flags. Use any combination of
* {@link #GET_META_DATA}, {@link #GET_SHARED_LIBRARY_FILES},
* {@link #MATCH_ALL}, {@link #MATCH_DEFAULT_ONLY},
* {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS},
* {@link #MATCH_ENCRYPTION_AWARE}, {@link #MATCH_ENCRYPTION_AWARE_AND_UNAWARE},
* {@link #MATCH_ENCRYPTION_UNAWARE}, {@link #MATCH_SYSTEM_ONLY}
* {@link #MATCH_UNINSTALLED_PACKAGES}
* to modify the data returned.
*
* @return A list of {@link ProviderInfo} objects containing one entry for
* each provider either matching processName or, if
* processName is null, all known content providers.
* If there are no matching providers, null is returned.
*
* @see #GET_META_DATA
* @see #GET_SHARED_LIBRARY_FILES
* @see #MATCH_ALL
* @see #MATCH_DEBUG_TRIAGED_MISSING
* @see #MATCH_DEFAULT_ONLY
* @see #MATCH_DISABLED_COMPONENTS
* @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS
* @see #MATCH_ENCRYPTION_AWARE
* @see #MATCH_ENCRYPTION_AWARE_AND_UNAWARE
* @see #MATCH_ENCRYPTION_UNAWARE
* @see #MATCH_SYSTEM_ONLY
* @see #MATCH_UNINSTALLED_PACKAGES
*/
public abstract List
* If the original drawable is a BitmapDrawable and the backing bitmap is
* mutable as per {@link android.graphics.Bitmap#isMutable()}, the badging
* is performed in place and the original drawable is returned.
*
* If the original drawable is a BitmapDrawable and the backing bitmap is
* mutable as per {@link android.graphics.Bitmap#isMutable()}, the bading
* is performed in place and the original drawable is returned.
* It doesn't remove the data or the actual package file. The application notifications
* will be hidden, the application will not show up in recents, will not be able to show
* toasts or dialogs or ring the device.
*
* @param packageNames The names of the packages to set the suspended status.
* @param suspended If set to {@code true} than the packages will be suspended, if set to
* {@code false} the packages will be unsuspended.
* @param userId The user id.
*
* @return an array of package names for which the suspended status is not set as requested in
* this method.
*
* @hide
*/
public abstract String[] setPackagesSuspendedAsUser(
String[] packageNames, boolean suspended, @UserIdInt int userId);
/**
* @see #setPackageSuspendedAsUser(String, boolean, int)
* @param packageName The name of the package to get the suspended status of.
* @param userId The user id.
* @return {@code true} if the package is suspended or {@code false} if the package is not
* suspended or could not be found.
* @hide
*/
public abstract boolean isPackageSuspendedForUser(String packageName, int userId);
/** {@hide} */
public static boolean isMoveStatusFinished(int status) {
return (status < 0 || status > 100);
}
/** {@hide} */
public static abstract class MoveCallback {
public void onCreated(int moveId, Bundle extras) {}
public abstract void onStatusChanged(int moveId, int status, long estMillis);
}
/** {@hide} */
public abstract int getMoveStatus(int moveId);
/** {@hide} */
public abstract void registerMoveCallback(MoveCallback callback, Handler handler);
/** {@hide} */
public abstract void unregisterMoveCallback(MoveCallback callback);
/** {@hide} */
public abstract int movePackage(String packageName, VolumeInfo vol);
/** {@hide} */
public abstract @Nullable VolumeInfo getPackageCurrentVolume(ApplicationInfo app);
/** {@hide} */
public abstract @NonNull List
*
*
* @param targetPackage The installed package whose installer will be changed.
* @param installerPackageName The package name of the new installer. May be
* null to clear the association.
*/
public abstract void setInstallerPackageName(String targetPackage,
String installerPackageName);
/**
* Attempts to delete a package. Since this may take a little while, the
* result will be posted back to the given observer. A deletion will fail if
* the calling context lacks the
* {@link android.Manifest.permission#DELETE_PACKAGES} permission, if the
* named package cannot be found, or if the named package is a system
* package.
*
* @param packageName The name of the package to delete
* @param observer An observer callback to get notified when the package
* deletion is complete.
* {@link android.content.pm.IPackageDeleteObserver#packageDeleted}
* will be called when that happens. observer may be null to
* indicate that no callback is desired.
* @hide
*/
public abstract void deletePackage(String packageName, IPackageDeleteObserver observer,
@DeleteFlags int flags);
/**
* Attempts to delete a package. Since this may take a little while, the
* result will be posted back to the given observer. A deletion will fail if
* the named package cannot be found, or if the named package is a system
* package.
*
* @param packageName The name of the package to delete
* @param observer An observer callback to get notified when the package
* deletion is complete.
* {@link android.content.pm.IPackageDeleteObserver#packageDeleted}
* will be called when that happens. observer may be null to
* indicate that no callback is desired.
* @param userId The user Id
* @hide
*/
@RequiresPermission(anyOf = {
Manifest.permission.DELETE_PACKAGES,
Manifest.permission.INTERACT_ACROSS_USERS_FULL})
public abstract void deletePackageAsUser(String packageName, IPackageDeleteObserver observer,
@DeleteFlags int flags, @UserIdInt int userId);
/**
* Retrieve the package name of the application that installed a package. This identifies
* which market the package came from.
*
* @param packageName The name of the package to query
*/
public abstract String getInstallerPackageName(String packageName);
/**
* Attempts to clear the user data directory of an application.
* Since this may take a little while, the result will
* be posted back to the given observer. A deletion will fail if the
* named package cannot be found, or if the named package is a "system package".
*
* @param packageName The name of the package
* @param observer An observer callback to get notified when the operation is finished
* {@link android.content.pm.IPackageDataObserver#onRemoveCompleted(String, boolean)}
* will be called when that happens. observer may be null to indicate that
* no callback is desired.
*
* @hide
*/
public abstract void clearApplicationUserData(String packageName,
IPackageDataObserver observer);
/**
* Attempts to delete the cache files associated with an application.
* Since this may take a little while, the result will
* be posted back to the given observer. A deletion will fail if the calling context
* lacks the {@link android.Manifest.permission#DELETE_CACHE_FILES} permission, if the
* named package cannot be found, or if the named package is a "system package".
*
* @param packageName The name of the package to delete
* @param observer An observer callback to get notified when the cache file deletion
* is complete.
* {@link android.content.pm.IPackageDataObserver#onRemoveCompleted(String, boolean)}
* will be called when that happens. observer may be null to indicate that
* no callback is desired.
*
* @hide
*/
public abstract void deleteApplicationCacheFiles(String packageName,
IPackageDataObserver observer);
/**
* Free storage by deleting LRU sorted list of cache files across
* all applications. If the currently available free storage
* on the device is greater than or equal to the requested
* free storage, no cache files are cleared. If the currently
* available storage on the device is less than the requested
* free storage, some or all of the cache files across
* all applications are deleted (based on last accessed time)
* to increase the free storage space on the device to
* the requested value. There is no guarantee that clearing all
* the cache files from all applications will clear up
* enough storage to achieve the desired value.
* @param freeStorageSize The number of bytes of storage to be
* freed by the system. Say if freeStorageSize is XX,
* and the current free storage is YY,
* if XX is less than YY, just return. if not free XX-YY number
* of bytes if possible.
* @param observer call back used to notify when
* the operation is completed
*
* @hide
*/
public void freeStorageAndNotify(long freeStorageSize, IPackageDataObserver observer) {
freeStorageAndNotify(null, freeStorageSize, observer);
}
/** {@hide} */
public abstract void freeStorageAndNotify(String volumeUuid, long freeStorageSize,
IPackageDataObserver observer);
/**
* Free storage by deleting LRU sorted list of cache files across
* all applications. If the currently available free storage
* on the device is greater than or equal to the requested
* free storage, no cache files are cleared. If the currently
* available storage on the device is less than the requested
* free storage, some or all of the cache files across
* all applications are deleted (based on last accessed time)
* to increase the free storage space on the device to
* the requested value. There is no guarantee that clearing all
* the cache files from all applications will clear up
* enough storage to achieve the desired value.
* @param freeStorageSize The number of bytes of storage to be
* freed by the system. Say if freeStorageSize is XX,
* and the current free storage is YY,
* if XX is less than YY, just return. if not free XX-YY number
* of bytes if possible.
* @param pi IntentSender call back used to
* notify when the operation is completed.May be null
* to indicate that no call back is desired.
*
* @hide
*/
public void freeStorage(long freeStorageSize, IntentSender pi) {
freeStorage(null, freeStorageSize, pi);
}
/** {@hide} */
public abstract void freeStorage(String volumeUuid, long freeStorageSize, IntentSender pi);
/**
* Retrieve the size information for a package.
* Since this may take a little while, the result will
* be posted back to the given observer. The calling context
* should have the {@link android.Manifest.permission#GET_PACKAGE_SIZE} permission.
*
* @param packageName The name of the package whose size information is to be retrieved
* @param userId The user whose size information should be retrieved.
* @param observer An observer callback to get notified when the operation
* is complete.
* {@link android.content.pm.IPackageStatsObserver#onGetStatsCompleted(PackageStats, boolean)}
* The observer's callback is invoked with a PackageStats object(containing the
* code, data and cache sizes of the package) and a boolean value representing
* the status of the operation. observer may be null to indicate that
* no callback is desired.
*
* @hide
*/
public abstract void getPackageSizeInfoAsUser(String packageName, @UserIdInt int userId,
IPackageStatsObserver observer);
/**
* Like {@link #getPackageSizeInfoAsUser(String, int, IPackageStatsObserver)}, but
* returns the size for the calling user.
*
* @hide
*/
public void getPackageSizeInfo(String packageName, IPackageStatsObserver observer) {
getPackageSizeInfoAsUser(packageName, UserHandle.myUserId(), observer);
}
/**
* @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.
*/
@Deprecated
public abstract void addPackageToPreferred(String packageName);
/**
* @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.
*/
@Deprecated
public abstract void removePackageFromPreferred(String packageName);
/**
* 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.
*
* @param flags Additional option flags. Use any combination of
* {@link #GET_ACTIVITIES}, {@link #GET_CONFIGURATIONS},
* {@link #GET_GIDS}, {@link #GET_INSTRUMENTATION},
* {@link #GET_INTENT_FILTERS}, {@link #GET_META_DATA},
* {@link #GET_PERMISSIONS}, {@link #GET_PROVIDERS},
* {@link #GET_RECEIVERS}, {@link #GET_SERVICES},
* {@link #GET_SHARED_LIBRARY_FILES}, {@link #GET_SIGNATURES},
* {@link #GET_URI_PERMISSION_PATTERNS}, {@link #GET_UNINSTALLED_PACKAGES},
* {@link #MATCH_DISABLED_COMPONENTS}, {@link #MATCH_DISABLED_UNTIL_USED_COMPONENTS},
* {@link #MATCH_UNINSTALLED_PACKAGES}
* to modify the data returned.
*
* @return A List of PackageInfo objects, one for each preferred application,
* in order of preference.
*
* @see #GET_ACTIVITIES
* @see #GET_CONFIGURATIONS
* @see #GET_GIDS
* @see #GET_INSTRUMENTATION
* @see #GET_INTENT_FILTERS
* @see #GET_META_DATA
* @see #GET_PERMISSIONS
* @see #GET_PROVIDERS
* @see #GET_RECEIVERS
* @see #GET_SERVICES
* @see #GET_SHARED_LIBRARY_FILES
* @see #GET_SIGNATURES
* @see #GET_URI_PERMISSION_PATTERNS
* @see #MATCH_DISABLED_COMPONENTS
* @see #MATCH_DISABLED_UNTIL_USED_COMPONENTS
* @see #MATCH_UNINSTALLED_PACKAGES
*/
public abstract List