java.lang.Object | |
↳ | android.content.pm.PackageManager |
Known Direct Subclasses |
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 getPackageManager()
.
Nested Classes | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
PackageManager.NameNotFoundException | This exception is thrown when a given package, application, or component name cannot be found. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | COMPONENT_ENABLED_STATE_DEFAULT | Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int) : This
component or application is in its default enabled state (as specified
in its manifest). |
|||||||||
int | COMPONENT_ENABLED_STATE_DISABLED | Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int) : This
component or application has been explicitly disabled, regardless of
what it has specified in its manifest. |
|||||||||
int | COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED | Flag for setApplicationEnabledSetting(String, int, int) only: This
application should be considered, until the point where the user actually
wants to use it. |
|||||||||
int | COMPONENT_ENABLED_STATE_DISABLED_USER | Flag for setApplicationEnabledSetting(String, int, int) only: The
user has explicitly disabled the application, regardless of what it has
specified in its manifest. |
|||||||||
int | COMPONENT_ENABLED_STATE_ENABLED | Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int) : This
component or application has been explictily enabled, regardless of
what it has specified in its manifest. |
|||||||||
int | DONT_KILL_APP | Flag parameter for
setComponentEnabledSetting(android.content.ComponentName, int, int) to indicate
that you don't want to kill the app containing the component. |
|||||||||
String | EXTRA_VERIFICATION_ID | Extra field name for the ID of a package pending verification. | |||||||||
String | EXTRA_VERIFICATION_RESULT | Extra field name for the result of a verification, either
VERIFICATION_ALLOW , or VERIFICATION_REJECT . |
|||||||||
String | FEATURE_APP_WIDGETS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports app widgets. |
|||||||||
String | FEATURE_AUDIO_LOW_LATENCY | Feature for getSystemAvailableFeatures() and hasSystemFeature(String) : The device's
audio pipeline is low-latency, more suitable for audio applications sensitive to delays or
lag in sound input or output. |
|||||||||
String | FEATURE_BACKUP | Feature for getSystemAvailableFeatures() and hasSystemFeature(String) :
The device can perform backup and restore operations on installed applications. |
|||||||||
String | FEATURE_BLUETOOTH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device is capable of communicating with
other devices via Bluetooth. |
|||||||||
String | FEATURE_BLUETOOTH_LE | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device is capable of communicating with
other devices via Bluetooth Low Energy radio. |
|||||||||
String | FEATURE_CAMERA | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a camera facing away
from the screen. |
|||||||||
String | FEATURE_CAMERA_ANY | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has at least one camera pointing in
some direction, or can support an external camera being connected to it. |
|||||||||
String | FEATURE_CAMERA_AUTOFOCUS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's camera supports auto-focus. |
|||||||||
String | FEATURE_CAMERA_EXTERNAL | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device can support having an external camera connected to it. |
|||||||||
String | FEATURE_CAMERA_FLASH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's camera supports flash. |
|||||||||
String | FEATURE_CAMERA_FRONT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a front facing camera. |
|||||||||
String | FEATURE_CONSUMER_IR | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device is capable of communicating with
consumer IR devices. |
|||||||||
String | FEATURE_DEVICE_ADMIN | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports device policy enforcement via device admins. |
|||||||||
String | FEATURE_FAKETOUCH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device does not have a touch screen, but
does support touch emulation for basic events. |
|||||||||
String | FEATURE_FAKETOUCH_MULTITOUCH_DISTINCT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device does not have a touch screen, but
does support touch emulation for basic events that supports distinct
tracking of two or more fingers. |
|||||||||
String | FEATURE_FAKETOUCH_MULTITOUCH_JAZZHAND | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device does not have a touch screen, but
does support touch emulation for basic events that supports tracking
a hand of fingers (5 or more fingers) fully independently. |
|||||||||
String | FEATURE_HOME_SCREEN | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports a home screen that is replaceable
by third party applications. |
|||||||||
String | FEATURE_INPUT_METHODS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports adding new input methods implemented
with the InputMethodService API. |
|||||||||
String | FEATURE_LEANBACK | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports leanback UI. |
|||||||||
String | FEATURE_LIVE_WALLPAPER | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports live wallpapers. |
|||||||||
String | FEATURE_LOCATION | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports one or more methods of
reporting current location. |
|||||||||
String | FEATURE_LOCATION_GPS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a Global Positioning System
receiver and can report precise location. |
|||||||||
String | FEATURE_LOCATION_NETWORK | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device can report location with coarse
accuracy using a network-based geolocation system. |
|||||||||
String | FEATURE_MANAGED_PROFILES | Feature for getSystemAvailableFeatures() and hasSystemFeature(String) :
The device supports managed profiles for enterprise users. |
|||||||||
String | FEATURE_MICROPHONE | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device can record audio via a
microphone. |
|||||||||
String | FEATURE_NFC | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device can communicate using Near-Field
Communications (NFC). |
|||||||||
String | FEATURE_NFC_HOST_CARD_EMULATION | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports host-
based NFC card emulation. |
|||||||||
String | FEATURE_PRINTING | Feature for getSystemAvailableFeatures() and hasSystemFeature(String) :
The device supports printing. |
|||||||||
String | FEATURE_SCREEN_LANDSCAPE | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports landscape orientation
screens. |
|||||||||
String | FEATURE_SCREEN_PORTRAIT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports portrait orientation
screens. |
|||||||||
String | FEATURE_SENSOR_ACCELEROMETER | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes an accelerometer. |
|||||||||
String | FEATURE_SENSOR_BAROMETER | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a barometer (air
pressure sensor.)
|
|||||||||
String | FEATURE_SENSOR_COMPASS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a magnetometer (compass). |
|||||||||
String | FEATURE_SENSOR_GYROSCOPE | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a gyroscope. |
|||||||||
String | FEATURE_SENSOR_HEART_RATE | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a heart rate monitor. |
|||||||||
String | FEATURE_SENSOR_LIGHT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a light sensor. |
|||||||||
String | FEATURE_SENSOR_PROXIMITY | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a proximity sensor. |
|||||||||
String | FEATURE_SENSOR_STEP_COUNTER | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a hardware step counter. |
|||||||||
String | FEATURE_SENSOR_STEP_DETECTOR | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device includes a hardware step detector. |
|||||||||
String | FEATURE_SIP | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The SIP API is enabled on the device. |
|||||||||
String | FEATURE_SIP_VOIP | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports SIP-based VOIP. |
|||||||||
String | FEATURE_TELEPHONY | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a telephony radio with data
communication support. |
|||||||||
String | FEATURE_TELEPHONY_CDMA | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a CDMA telephony stack. |
|||||||||
String | FEATURE_TELEPHONY_GSM | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a GSM telephony stack. |
|||||||||
String | FEATURE_TELEVISION |
This constant is deprecated.
use FEATURE_LEANBACK instead.
|
|||||||||
String | FEATURE_TOUCHSCREEN | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's display has a touch screen. |
|||||||||
String | FEATURE_TOUCHSCREEN_MULTITOUCH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's touch screen supports
multitouch sufficient for basic two-finger gesture detection. |
|||||||||
String | FEATURE_TOUCHSCREEN_MULTITOUCH_DISTINCT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's touch screen is capable of
tracking two or more fingers fully independently. |
|||||||||
String | FEATURE_TOUCHSCREEN_MULTITOUCH_JAZZHAND | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's touch screen is capable of
tracking a full hand of fingers fully independently -- that is, 5 or
more simultaneous independent pointers. |
|||||||||
String | FEATURE_USB_ACCESSORY | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports connecting to USB accessories. |
|||||||||
String | FEATURE_USB_HOST | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports connecting to USB devices
as the USB host. |
|||||||||
String | FEATURE_WATCH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : This is a device dedicated to showing UI
on a watch. |
|||||||||
String | FEATURE_WEBVIEW | Feature for getSystemAvailableFeatures() and hasSystemFeature(String) :
The device has a full implementation of the android.webkit.* APIs. |
|||||||||
String | FEATURE_WIFI | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports WiFi (802.11) networking. |
|||||||||
String | FEATURE_WIFI_DIRECT | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports Wi-Fi Direct networking. |
|||||||||
int | GET_ACTIVITIES | PackageInfo flag: return information about
activities in the package in activities . |
|||||||||
int | GET_CONFIGURATIONS | PackageInfo flag: return information about
hardware preferences in
PackageInfo.configPreferences and
requested features in PackageInfo.reqFeatures . |
|||||||||
int | GET_DISABLED_COMPONENTS | PackageInfo flag: include disabled components in the returned info. |
|||||||||
int | GET_DISABLED_UNTIL_USED_COMPONENTS | PackageInfo flag: include disabled components which are in
that state only because of COMPONENT_ENABLED_STATE_DISABLED_UNTIL_USED
in the returned info. |
|||||||||
int | GET_GIDS | PackageInfo flag: return the
group ids that are associated with an
application. |
|||||||||
int | GET_INSTRUMENTATION | PackageInfo flag: return information about
instrumentation in the package in
instrumentation . |
|||||||||
int | GET_INTENT_FILTERS | PackageInfo flag: return information about the
intent filters supported by the activity. |
|||||||||
int | GET_META_DATA | ComponentInfo flag: return the metaData
data Bundle s that are associated with a component. |
|||||||||
int | GET_PERMISSIONS | PackageInfo flag: return information about
permissions in the package in
permissions . |
|||||||||
int | GET_PROVIDERS | PackageInfo flag: return information about
content providers in the package in
providers . |
|||||||||
int | GET_RECEIVERS | PackageInfo flag: return information about
intent receivers in the package in
receivers . |
|||||||||
int | GET_RESOLVED_FILTER | ResolveInfo flag: return the IntentFilter that
was matched for a particular ResolveInfo in
filter . |
|||||||||
int | GET_SERVICES | PackageInfo flag: return information about
services in the package in services . |
|||||||||
int | GET_SHARED_LIBRARY_FILES | ApplicationInfo flag: return the
paths to the shared libraries
that are associated with an application. |
|||||||||
int | GET_SIGNATURES | PackageInfo flag: return information about the
signatures included in the package. |
|||||||||
int | GET_UNINSTALLED_PACKAGES | Flag parameter to retrieve some information about all applications (even uninstalled ones) which have data directories. | |||||||||
int | GET_URI_PERMISSION_PATTERNS | ProviderInfo flag: return the
URI permission patterns
that are associated with a content provider. |
|||||||||
int | MATCH_DEFAULT_ONLY | Resolution and querying flag: if set, only filters that support the
CATEGORY_DEFAULT will be considered for
matching. |
|||||||||
long | MAXIMUM_VERIFICATION_TIMEOUT | Can be used as the millisecondsToDelay argument for
extendVerificationTimeout(int, int, long) . |
|||||||||
int | PERMISSION_DENIED | Permission check result: this is returned by checkPermission(String, String)
if the permission has not been granted to the given package. |
|||||||||
int | PERMISSION_GRANTED | Permission check result: this is returned by checkPermission(String, String)
if the permission has been granted to the given package. |
|||||||||
int | SIGNATURE_FIRST_NOT_SIGNED | Signature check result: this is returned by checkSignatures(int, int)
if the first package is not signed but the second is. |
|||||||||
int | SIGNATURE_MATCH | Signature check result: this is returned by checkSignatures(int, int)
if all signatures on the two packages match. |
|||||||||
int | SIGNATURE_NEITHER_SIGNED | Signature check result: this is returned by checkSignatures(int, int)
if neither of the two packages is signed. |
|||||||||
int | SIGNATURE_NO_MATCH | Signature check result: this is returned by checkSignatures(int, int)
if not all signatures on both packages match. |
|||||||||
int | SIGNATURE_SECOND_NOT_SIGNED | Signature check result: this is returned by checkSignatures(int, int)
if the second package is not signed but the first is. |
|||||||||
int | SIGNATURE_UNKNOWN_PACKAGE | Signature check result: this is returned by checkSignatures(int, int)
if either of the packages are not valid. |
|||||||||
int | VERIFICATION_ALLOW | Used as the verificationCode argument for
verifyPendingInstall(int, int) to indicate that the calling
package verifier allows the installation to proceed. |
|||||||||
int | VERIFICATION_REJECT | Used as the verificationCode argument for
verifyPendingInstall(int, int) to indicate the calling
package verifier does not vote to allow the installation to proceed. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method was deprecated
in API level 7.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
| |||||||||||
Add a new dynamic permission to the system.
| |||||||||||
Like
addPermission(PermissionInfo) but asynchronously
persists the package manager state after returning from the call,
allowing it to return quicker and batch a series of adds at the
expense of no guarantee the added permission will be retained if
the device is rebooted before it is written. | |||||||||||
This method was deprecated
in API level 8.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this cannot be directly modified.
Add a new preferred activity mapping to the system. This will be used
to automatically select the given activity component when
Context.startActivity() finds
multiple matching activities and also matches the given filter. | |||||||||||
Map from a packages canonical name to the current name in use on the device.
| |||||||||||
Check whether a particular package has been granted a particular
permission.
| |||||||||||
Like
checkSignatures(String, String) , but takes UIDs of
the two packages to be checked. | |||||||||||
Compare the signatures of two packages to determine if the same
signature appears in both of them.
| |||||||||||
Remove all preferred activity mappings, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName) , from the
system whose activities are implemented in the given package name. | |||||||||||
Map from the current package names in use on the device to whatever
the current canonical name of that package is.
| |||||||||||
Allows a package listening to the
package verification
broadcast to extend the default timeout for a response and declare what
action to perform after the timeout occurs. | |||||||||||
Retrieve the banner associated with an Intent.
| |||||||||||
Retrieve the banner associated with an activity.
| |||||||||||
Retrieve the icon associated with an Intent.
| |||||||||||
Retrieve the icon associated with an activity.
| |||||||||||
Retrieve all of the information we know about a particular activity
class.
| |||||||||||
Retrieve the logo associated with an Intent.
| |||||||||||
Retrieve the logo associated with an activity.
| |||||||||||
Retrieve all of the known permission groups in the system.
| |||||||||||
Retrieve the banner associated with an application.
| |||||||||||
Retrieve the banner associated with an application.
| |||||||||||
Return the the enabled setting for an application.
| |||||||||||
Retrieve the icon associated with an application.
| |||||||||||
Retrieve the icon associated with an application.
| |||||||||||
Retrieve all of the information we know about a particular
package/application.
| |||||||||||
Return the label to use for this application.
| |||||||||||
Retrieve the logo associated with an application.
| |||||||||||
Retrieve the logo associated with an application.
| |||||||||||
Return the the enabled setting for a package component (activity,
receiver, service, provider).
| |||||||||||
Return the generic icon for an activity that is used when no specific
icon is defined.
| |||||||||||
Retrieve an image from a package.
| |||||||||||
Return a List of all application packages that are installed on the
device.
| |||||||||||
Return a List of all packages that are installed
on the device.
| |||||||||||
Retrieve the package name of the application that installed a package.
| |||||||||||
Retrieve all of the information we know about a particular
instrumentation class.
| |||||||||||
Return a "good" intent to launch a front-door activity in a package,
for use for example to implement an "open" button when browsing through
packages.
| |||||||||||
Return a "good" intent to launch a front-door Leanback activity in a
package, for use for example to implement an "open" button when browsing
through packages.
| |||||||||||
Retrieve the official name associated with a user id.
| |||||||||||
Retrieve overall information about an application package defined
in a package archive file
| |||||||||||
Return an array of all of the secondary group-ids that have been assigned
to a package.
| |||||||||||
Retrieve overall information about an application package that is
installed on the system.
| |||||||||||
Retrieve the names of all packages that are associated with a particular
user id.
| |||||||||||
Return a List of all installed packages that are currently
holding any of the given permissions.
| |||||||||||
Retrieve all of the information we know about a particular group of
permissions.
| |||||||||||
Retrieve all of the information we know about a particular permission.
| |||||||||||
Retrieve all preferred activities, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName) , that are
currently registered with the system. | |||||||||||
Retrieve the list of all currently configured preferred packages.
| |||||||||||
Retrieve all of the information we know about a particular content
provider class.
| |||||||||||
Retrieve all of the information we know about a particular receiver
class.
| |||||||||||
Retrieve the resources associated with an activity.
| |||||||||||
Retrieve the resources associated with an application.
| |||||||||||
Retrieve the resources for an application.
| |||||||||||
Retrieve all of the information we know about a particular service
class.
| |||||||||||
Get a list of features that are available on the
system.
| |||||||||||
Get a list of shared libraries that are available on the
system.
| |||||||||||
Retrieve text from a package.
| |||||||||||
Retrieve an XML file from a package.
| |||||||||||
Check whether the given feature name is one of the available
features as returned by
getSystemAvailableFeatures() . | |||||||||||
Return whether the device has been booted into safe mode.
| |||||||||||
Retrieve all receivers that can handle a broadcast of the given intent.
| |||||||||||
Retrieve content provider information.
| |||||||||||
Retrieve information about available instrumentation code.
| |||||||||||
Retrieve all activities that can be performed for the given intent.
| |||||||||||
Retrieve a set of activities that should be presented to the user as
similar options.
| |||||||||||
Retrieve all providers that can match the given intent.
| |||||||||||
Retrieve all services that can match the given intent.
| |||||||||||
Query for all of the permissions associated with a particular group.
| |||||||||||
This method was deprecated
in API level 7.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
| |||||||||||
Removes a permission that was previously added with
addPermission(PermissionInfo) . | |||||||||||
Determine the best action to perform for a given Intent.
| |||||||||||
Find a single content provider by its base path name.
| |||||||||||
Determine the best service to handle for a given Intent.
| |||||||||||
Set the enabled setting for an application
This setting will override any enabled state which may have been set by the application in
its manifest.
| |||||||||||
Set the enabled setting for a package component (activity, receiver, service, provider).
| |||||||||||
Change the installer associated with a given package.
| |||||||||||
Allows a package listening to the
package verification
broadcast to respond to the package manager. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int)
: This
component or application is in its default enabled state (as specified
in its manifest).
Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int)
: This
component or application has been explicitly disabled, regardless of
what it has specified in its manifest.
Flag for setApplicationEnabledSetting(String, int, int)
only: This
application should be considered, until the point where the user actually
wants to use it. This means that it will not normally show up to the user
(such as in the launcher), but various parts of the user interface can
use GET_DISABLED_UNTIL_USED_COMPONENTS
to still see it and allow
the user to select it (as for example an IME, device admin, etc). Such code,
once the user has selected the app, should at that point also make it enabled.
This option currently can not be used with
setComponentEnabledSetting(ComponentName, int, int)
.
Flag for setApplicationEnabledSetting(String, int, int)
only: The
user has explicitly disabled the application, regardless of what it has
specified in its manifest. Because this is due to the user's request,
they may re-enable it if desired through the appropriate system UI. This
option currently cannot be used with
setComponentEnabledSetting(ComponentName, int, int)
.
Flag for setApplicationEnabledSetting(String, int, int)
and setComponentEnabledSetting(ComponentName, int, int)
: This
component or application has been explictily enabled, regardless of
what it has specified in its manifest.
Flag parameter for
setComponentEnabledSetting(android.content.ComponentName, int, int)
to indicate
that you don't want to kill the app containing the component. Be careful when you set this
since changing component states can make the containing application's behavior unpredictable.
Extra field name for the ID of a package pending verification. Passed to
a package verifier and is used to call back to
verifyPendingInstall(int, int)
Extra field name for the result of a verification, either
VERIFICATION_ALLOW
, or VERIFICATION_REJECT
.
Passed to package verifiers after a package is verified.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports app widgets.
Feature for getSystemAvailableFeatures()
and hasSystemFeature(String)
: The device's
audio pipeline is low-latency, more suitable for audio applications sensitive to delays or
lag in sound input or output.
Feature for getSystemAvailableFeatures()
and hasSystemFeature(String)
:
The device can perform backup and restore operations on installed applications.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device is capable of communicating with
other devices via Bluetooth.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device is capable of communicating with
other devices via Bluetooth Low Energy radio.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a camera facing away
from the screen.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has at least one camera pointing in
some direction, or can support an external camera being connected to it.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's camera supports auto-focus.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: 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.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's camera supports flash.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a front facing camera.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device is capable of communicating with
consumer IR devices.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports device policy enforcement via device admins.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device does not have a touch screen, but
does support touch emulation for basic events. For instance, the
device might use a mouse or remote control to drive a cursor, and
emulate basic touch pointer events like down, up, drag, etc. All
devices that support android.hardware.touchscreen or a sub-feature are
presumed to also support faketouch.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device does not have a touch screen, but
does support touch emulation for basic events that supports distinct
tracking of two or more fingers. This is an extension of
FEATURE_FAKETOUCH
for input devices with this capability. Note
that unlike a distinct multitouch screen as defined by
FEATURE_TOUCHSCREEN_MULTITOUCH_DISTINCT
, these kinds of input
devices will not actually provide full two-finger gestures since the
input is being transformed to cursor movement on the screen. That is,
single finger gestures will move a cursor; two-finger swipes will
result in single-finger touch events; other two-finger gestures will
result in the corresponding two-finger touch event.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device does not have a touch screen, but
does support touch emulation for basic events that supports tracking
a hand of fingers (5 or more fingers) fully independently.
This is an extension of
FEATURE_FAKETOUCH
for input devices with this capability. Note
that unlike a multitouch screen as defined by
FEATURE_TOUCHSCREEN_MULTITOUCH_JAZZHAND
, not all two finger
gestures can be detected due to the limitations described for
FEATURE_FAKETOUCH_MULTITOUCH_DISTINCT
.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports a home screen that is replaceable
by third party applications.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports adding new input methods implemented
with the InputMethodService
API.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports leanback UI. This is
typically used in a living room television experience, but is a software
feature unlike FEATURE_TELEVISION
. Devices running with this
feature will use resources associated with the "television" UI mode.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports live wallpapers.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports one or more methods of
reporting current location.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a Global Positioning System
receiver and can report precise location.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device can report location with coarse
accuracy using a network-based geolocation system.
Feature for getSystemAvailableFeatures()
and hasSystemFeature(String)
:
The device supports managed profiles for enterprise users.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device can record audio via a
microphone.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device can communicate using Near-Field
Communications (NFC).
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports host-
based NFC card emulation.
Feature for getSystemAvailableFeatures()
and hasSystemFeature(String)
:
The device supports printing.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports landscape orientation
screens. For backwards compatibility, you can assume that if neither
this nor FEATURE_SCREEN_PORTRAIT
is set then the device supports
both portrait and landscape.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports portrait orientation
screens. For backwards compatibility, you can assume that if neither
this nor FEATURE_SCREEN_LANDSCAPE
is set then the device supports
both portrait and landscape.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes an accelerometer.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a barometer (air
pressure sensor.)
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a magnetometer (compass).
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a gyroscope.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a heart rate monitor.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a light sensor.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a proximity sensor.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a hardware step counter.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a hardware step detector.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The SIP API is enabled on the device.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports SIP-based VOIP.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a telephony radio with data
communication support.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a CDMA telephony stack.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a GSM telephony stack.
This constant is deprecated.
use FEATURE_LEANBACK
instead.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: This is a device dedicated to showing UI
on a television. Television here is defined to be a typical living
room television experience: displayed on a big screen, where the user
is sitting far away from it, and the dominant form of input will be
something like a DPAD, not through touch or mouse.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's display has a touch screen.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's touch screen supports
multitouch sufficient for basic two-finger gesture detection.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's touch screen is capable of
tracking two or more fingers fully independently.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's touch screen is capable of
tracking a full hand of fingers fully independently -- that is, 5 or
more simultaneous independent pointers.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports connecting to USB accessories.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports connecting to USB devices
as the USB host.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: This is a device dedicated to showing UI
on a watch. A watch here is defined to be a device worn on the body, perhaps on
the wrist. The user is very close when interacting with the device.
Feature for getSystemAvailableFeatures()
and hasSystemFeature(String)
:
The device has a full implementation of the android.webkit.* APIs. Devices
lacking this feature will not have a functioning WebView implementation.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports WiFi (802.11) networking.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device supports Wi-Fi Direct networking.
PackageInfo
flag: return information about
activities in the package in activities
.
PackageInfo
flag: return information about
hardware preferences in
PackageInfo.configPreferences
and
requested features in PackageInfo.reqFeatures
.
PackageInfo
flag: include disabled components in the returned info.
PackageInfo
flag: include disabled components which are in
that state only because of 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.
PackageInfo
flag: return the
group ids
that are associated with an
application.
This applies for any API returning a PackageInfo class, either
directly or nested inside of another.
PackageInfo
flag: return information about
instrumentation in the package in
instrumentation
.
PackageInfo
flag: return information about the
intent filters supported by the activity.
ComponentInfo
flag: return the metaData
data Bundle
s that are associated with a component.
This applies for any API returning a ComponentInfo subclass.
PackageInfo
flag: return information about
permissions in the package in
permissions
.
PackageInfo
flag: return information about
content providers in the package in
providers
.
PackageInfo
flag: return information about
intent receivers in the package in
receivers
.
ResolveInfo
flag: return the IntentFilter that
was matched for a particular ResolveInfo in
filter
.
PackageInfo
flag: return information about
services in the package in services
.
ApplicationInfo
flag: return the
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.
PackageInfo
flag: return information about the
signatures included in the package.
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
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.
ProviderInfo
flag: return the
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.
Resolution and querying flag: if set, only filters that support the
CATEGORY_DEFAULT
will be considered for
matching. This is a synonym for including the CATEGORY_DEFAULT in your
supplied Intent.
Can be used as the millisecondsToDelay
argument for
extendVerificationTimeout(int, int, long)
. This is the
maximum time PackageManager
waits for the verification
agent to return (in milliseconds).
Permission check result: this is returned by checkPermission(String, String)
if the permission has not been granted to the given package.
Permission check result: this is returned by checkPermission(String, String)
if the permission has been granted to the given package.
Signature check result: this is returned by checkSignatures(int, int)
if the first package is not signed but the second is.
Signature check result: this is returned by checkSignatures(int, int)
if all signatures on the two packages match.
Signature check result: this is returned by checkSignatures(int, int)
if neither of the two packages is signed.
Signature check result: this is returned by checkSignatures(int, int)
if not all signatures on both packages match.
Signature check result: this is returned by checkSignatures(int, int)
if the second package is not signed but the first is.
Signature check result: this is returned by checkSignatures(int, int)
if either of the packages are not valid.
Used as the verificationCode
argument for
verifyPendingInstall(int, int)
to indicate that the calling
package verifier allows the installation to proceed.
Used as the verificationCode
argument for
verifyPendingInstall(int, int)
to indicate the calling
package verifier does not vote to allow the installation to proceed.
This method was deprecated
in API level 7.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
Add a new dynamic permission to the system. For this to work, your
package must have defined a permission tree through the
<permission-tree>
tag in its manifest. A package can only add
permissions to trees that were defined by either its own package or
another with the same user id; a permission is in a tree if it
matches the name of the permission tree + ".": for example,
"com.foo.bar" is a member of the permission tree "com.foo".
It is good to make your permission tree name descriptive, because you are taking possession of that entire set of permission names. Thus, it must be under a domain you control, with a suffix that will not match any normal permissions that may be declared in any applications that are part of that domain.
New permissions must be added before any .apks are installed that use those permissions. Permissions you add through this method are remembered across reboots of the device. If the given permission already exists, the info you supply here will be used to update it.
info | Description of the permission to be added. |
---|
SecurityException | if you are not allowed to add the given permission name. |
---|
Like addPermission(PermissionInfo)
but asynchronously
persists the package manager state after returning from the call,
allowing it to return quicker and batch a series of adds at the
expense of no guarantee the added permission will be retained if
the device is rebooted before it is written.
This method was deprecated
in API level 8.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this cannot be directly modified.
Add a new preferred activity mapping to the system. This will be used
to automatically select the given activity component when
Context.startActivity()
finds
multiple matching activities and also matches the given filter.
filter | The set of intents under which this activity will be made preferred. |
---|---|
match | The IntentFilter match category that this preference applies to. |
set | The set of activities that the user was picking from when this preference was made. |
activity | The component name of the activity that is to be preferred. |
Map from a packages canonical name to the current name in use on the device.
names | Array of new names to be mapped. |
---|
Check whether a particular package has been granted a particular permission.
permName | The name of the permission you are checking for, |
---|---|
pkgName | The name of the package you are checking against. |
Like checkSignatures(String, String)
, but takes UIDs of
the two packages to be checked. This can be useful, for example,
when doing the check in an IPC, where the UID is the only identity
available. It is functionally identical to determining the package
associated with the UIDs and checking their signatures.
uid1 | First UID whose signature will be compared. |
---|---|
uid2 | Second UID whose signature will be compared. |
SIGNATURE_MATCH
) if
all signatures match or < 0 if there is not a match (SIGNATURE_NO_MATCH
or SIGNATURE_UNKNOWN_PACKAGE
).Compare the signatures of two packages to determine if the same signature appears in both of them. If they do contain the same signature, then they are allowed special privileges when working with each other: they can share the same user-id, run instrumentation against each other, etc.
pkg1 | First package name whose signature will be compared. |
---|---|
pkg2 | Second package name whose signature will be compared. |
SIGNATURE_MATCH
) if
all signatures match or < 0 if there is not a match (SIGNATURE_NO_MATCH
or SIGNATURE_UNKNOWN_PACKAGE
).Remove all preferred activity mappings, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName)
, from the
system whose activities are implemented in the given package name.
An application can only clear its own package(s).
packageName | The name of the package whose preferred activity mappings are to be removed. |
---|
Map from the current package names in use on the device to whatever the current canonical name of that package is.
names | Array of current names to be mapped. |
---|
Allows a package listening to the
package verification
broadcast
to extend the default timeout for a response and declare what
action to perform after the timeout occurs. The response must include
the verificationCodeAtTimeout
which is one of
VERIFICATION_ALLOW
or
VERIFICATION_REJECT
.
This method may only be called once per package id. Additional calls
will have no effect.
id | pending package identifier as passed via the
EXTRA_VERIFICATION_ID Intent extra. |
---|---|
verificationCodeAtTimeout | either
VERIFICATION_ALLOW or
VERIFICATION_REJECT . If
verificationCodeAtTimeout is neither
VERIFICATION_ALLOW or
VERIFICATION_REJECT , then
verificationCodeAtTimeout will default to
VERIFICATION_REJECT . |
millisecondsToDelay | the amount of time requested for the timeout.
Must be positive and less than
MAXIMUM_VERIFICATION_TIMEOUT . If
millisecondsToDelay is out of bounds,
millisecondsToDelay will be set to the closest in
bounds value; namely, 0 or
MAXIMUM_VERIFICATION_TIMEOUT . |
SecurityException | if the caller does not have the PACKAGE_VERIFICATION_AGENT permission. |
---|
Retrieve the banner associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityBanner(intent.getClassName()). Otherwise it resolves the intent's component and returns the banner associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve a banner. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for application matching the given intent could not be loaded. |
---|
Retrieve the banner associated with an activity. Given the full name of
an activity, retrieves the information about it and calls
ComponentInfo.loadIcon()
to return its
banner. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose banner is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given activity could not be loaded. |
---|
Retrieve the icon associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityIcon(intent.getClassName()). Otherwise it resolves the intent's component and returns the icon associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve an icon. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for application matching the given intent could not be loaded. |
---|
Retrieve the icon associated with an activity. Given the full name of
an activity, retrieves the information about it and calls
ComponentInfo.loadIcon()
to return its icon.
If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose icon is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given activity could not be loaded. |
---|
Retrieve all of the information we know about a particular activity class.
Throws PackageManager.NameNotFoundException
if an activity with the given
class name cannot be found on the system.
component | The full component name (i.e. com.google.apps.contacts/com.google.apps.contacts.ContactsList) of an Activity class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data (in ApplicationInfo) returned. |
ActivityInfo
containing information about the activity.Retrieve the logo associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityLogo(intent.getClassName()). Otherwise it resolves the intent's component and returns the logo associated with the resolved component. If intent.getClassName() cannot be found or the Intent cannot be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve a logo. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for application matching the given intent could not be loaded. |
---|
Retrieve the logo associated with an activity. Given the full name of an
activity, retrieves the information about it and calls
ComponentInfo.loadLogo()
to return its
logo. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose logo is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given activity could not be loaded. |
---|
Retrieve all of the known permission groups in the system.
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission group. |
---|
PermissionGroupInfo
containing
information about all of the known permission groups.
Retrieve the banner associated with an application.
info | Information about application being queried. |
---|
Retrieve the banner associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationIcon() to return its banner. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application banner is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded. |
---|
Return the the enabled setting for an application. This returns
the last value set by
setApplicationEnabledSetting(String, int, int)
; in most
cases this value will be COMPONENT_ENABLED_STATE_DEFAULT
since
the value originally specified in the manifest has not been modified.
packageName | The component to retrieve. |
---|
COMPONENT_ENABLED_STATE_ENABLED
,
COMPONENT_ENABLED_STATE_DISABLED
, or
COMPONENT_ENABLED_STATE_DEFAULT
. The last one means the
application's enabled state is based on the original information in
the manifest as found in ComponentInfo
.IllegalArgumentException | if the named package does not exist. |
---|
Retrieve the icon associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationIcon() to return its icon. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application icon is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded. |
---|
Retrieve the icon associated with an application. If it has not defined an icon, the default app icon is returned. Does not return null.
info | Information about application being queried. |
---|
Retrieve all of the information we know about a particular package/application.
Throws PackageManager.NameNotFoundException
if an application with the given
package name cannot be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of an application. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
ApplicationInfo
Returns ApplicationInfo object containing
information about the package.
If flag GET_UNINSTALLED_PACKAGES is set and if the package is not
found in the list of installed applications,
the application information is retrieved from the
list of uninstalled applications(which includes
installed applications as well as applications
with data directory ie applications which had been
deleted with DONT_DELETE_DATA
flag set).Return the label to use for this application.
info | The application to get the label of. |
---|
Retrieve the logo associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationLogo() to return its logo. If the application cannot be found, NameNotFoundException is thrown.
packageName | Name of the package whose application logo is to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded. |
---|
Retrieve the logo associated with an application. If it has not specified a logo, this method returns null.
info | Information about application being queried. |
---|
Return the the enabled setting for a package component (activity,
receiver, service, provider). This returns the last value set by
setComponentEnabledSetting(ComponentName, int, int)
; in most
cases this value will be COMPONENT_ENABLED_STATE_DEFAULT
since
the value originally specified in the manifest has not been modified.
componentName | The component to retrieve. |
---|
COMPONENT_ENABLED_STATE_ENABLED
,
COMPONENT_ENABLED_STATE_DISABLED
, or
COMPONENT_ENABLED_STATE_DEFAULT
. The last one means the
component's enabled state is based on the original information in
the manifest as found in ComponentInfo
.
Return the generic icon for an activity that is used when no specific icon is defined.
Retrieve an image from a package. This is a low-level API used by
the various package manager info structures (such as
ComponentInfo
to implement retrieval of their associated
icon.
packageName | The name of the package that this icon is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired image. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Return a List of all application packages that are installed on the
device. If flag GET_UNINSTALLED_PACKAGES has been set, a list of all
applications including those deleted with DONT_DELETE_DATA
(partially
installed apps with data directory) will be returned.
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
DONT_DELETE_DATA
(partially installed apps with data directory) will be returned.Return a List of all packages that are installed on the device.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
DONT_DELETE_DATA
(partially installed apps with data directory) will be returned.Retrieve the package name of the application that installed a package. This identifies which market the package came from.
packageName | The name of the package to query |
---|
Retrieve all of the information we know about a particular instrumentation class.
Throws PackageManager.NameNotFoundException
if instrumentation with the
given class name cannot be found on the system.
className | The full name (i.e. com.google.apps.contacts.InstrumentList) of an Instrumentation class. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Return a "good" intent to launch a front-door activity in a package,
for use for example to implement an "open" button when browsing through
packages. The current implementation will look first for a main
activity in the category CATEGORY_INFO
, next for a
main activity in the category CATEGORY_LAUNCHER
, or return
null if neither are found.
Throws PackageManager.NameNotFoundException
if a package with the given
name cannot be found on the system.
packageName | The name of the package to inspect. |
---|
Return a "good" intent to launch a front-door Leanback activity in a
package, for use for example to implement an "open" button when browsing
through packages. The current implementation will look for a main
activity in the category CATEGORY_LEANBACK_LAUNCHER
, or
return null if no main leanback activities are found.
Throws PackageManager.NameNotFoundException
if a package with the given name
cannot be found on the system.
packageName | The name of the package to inspect. |
---|
Retrieve the official name associated with a user id. This name is guaranteed to never change, though it is possibly for the underlying user id to be changed. That is, if you are storing information about user ids in persistent storage, you should use the string returned by this function instead of the raw user-id.
uid | The user id for which you would like to retrieve a name. |
---|
Retrieve overall information about an application package defined in a package archive file
archiveFilePath | The path to the archive file |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES , to modify the data returned. |
Return an array of all of the secondary group-ids that have been assigned to a package.
Throws PackageManager.NameNotFoundException
if a package with the given name
cannot be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|
Retrieve overall information about an application package that is installed on the system.
Throws PackageManager.NameNotFoundException
if a package with the given name can
not be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES , GET_GIDS ,
GET_CONFIGURATIONS , GET_INSTRUMENTATION ,
GET_PERMISSIONS , GET_PROVIDERS ,
GET_RECEIVERS , GET_SERVICES ,
GET_SIGNATURES , GET_UNINSTALLED_PACKAGES to
modify the data returned. |
DONT_DELETE_DATA
flag set).Retrieve the names of all packages that are associated with a particular user id. In most cases, this will be a single package name, the package that has been assigned that user id. Where there are multiple packages sharing the same user id through the "sharedUserId" mechanism, all packages with that id will be returned.
uid | The user id for which you would like to retrieve the associated packages. |
---|
Return a List of all installed packages that are currently holding any of the given permissions.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
Retrieve all of the information we know about a particular group of permissions.
Throws PackageManager.NameNotFoundException
if a permission group with the given
name cannot be found on the system.
name | The fully qualified name (i.e. com.google.permission_group.APPS) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission group. |
PermissionGroupInfo
containing information
about the permission.
Retrieve all of the information we know about a particular permission.
Throws PackageManager.NameNotFoundException
if a permission with the given
name cannot be found on the system.
name | The fully qualified name (i.e. com.google.permission.LOGIN) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission. |
PermissionInfo
containing information about the
permission.
Retrieve all preferred activities, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName)
, that are
currently registered with the system.
outFilters | A list in which to place the filters of all of the preferred activities, or null for none. |
---|---|
outActivities | A list in which to place the component names of all of the preferred activities, or null for none. |
packageName | An option package in which you would like to limit the list. If null, all activities will be returned; if non-null, only those activities in the given package are returned. |
Retrieve the list of all currently configured preferred packages. The first package on the list is the most preferred, the last is the least preferred.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES , to modify the data returned. |
---|
Retrieve all of the information we know about a particular content provider class.
Throws PackageManager.NameNotFoundException
if a provider with the given
class name cannot be found on the system.
component | The full component name (i.e. com.google.providers.media/com.google.providers.media.MediaProvider) of a ContentProvider class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
Retrieve all of the information we know about a particular receiver class.
Throws PackageManager.NameNotFoundException
if a receiver with the given
class name cannot be found on the system.
component | The full component name (i.e. com.google.apps.calendar/com.google.apps.calendar.CalendarAlarm) of a Receiver class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
ActivityInfo
containing information about the receiver.Retrieve the resources associated with an activity. Given the full name of an activity, retrieves the information about it and calls getResources() to return its application's resources. If the activity cannot be found, NameNotFoundException is thrown.
activityName | Name of the activity whose resources are to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded. |
---|
Retrieve the resources associated with an application. Given the full package name of an application, retrieves the information about it and calls getResources() to return its application's resources. If the appPackageName cannot be found, NameNotFoundException is thrown.
appPackageName | Package name of the application whose resources are to be retrieved. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded. |
---|
Retrieve the resources for an application. Throws NameNotFoundException if the package is no longer installed.
app | Information about the desired application. |
---|
PackageManager.NameNotFoundException | Thrown if the resources for the given application could not be loaded (most likely because it was uninstalled). |
---|
Retrieve all of the information we know about a particular service class.
Throws PackageManager.NameNotFoundException
if a service with the given
class name cannot be found on the system.
component | The full component name (i.e. com.google.apps.media/com.google.apps.media.BackgroundPlayback) of a Service class. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
to modify the data returned. |
Get a list of features that are available on the system.
Get a list of shared libraries that are available on the system.
Retrieve text from a package. This is a low-level API used by
the various package manager info structures (such as
ComponentInfo
to implement retrieval of their associated
labels and other text.
packageName | The name of the package that this text is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired text. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Retrieve an XML file from a package. This is a low-level API used to retrieve XML meta data.
packageName | The name of the package that this xml is coming from. Cannot be null. |
---|---|
resid | The resource identifier of the desired xml. Cannot be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Check whether the given feature name is one of the available
features as returned by getSystemAvailableFeatures()
.
Return whether the device has been booted into safe mode.
Retrieve all receivers that can handle a broadcast of the given intent.
intent | The desired intent as per resolveActivity(). |
---|---|
flags | Additional option flags. |
Retrieve content provider information.
Note: unlike most other methods, an empty result set is indicated by a null return instead of an empty list.
processName | If non-null, limits the returned providers to only those that are hosted by the given process. If null, all content providers are returned. |
---|---|
uid | If processName is non-null, this is the required uid owning the requested content providers. |
flags | Additional option flags. Currently should always be 0. |
Retrieve information about available instrumentation code. May be used to retrieve either all instrumentation code, or only the code targeting a particular package.
targetPackage | If null, all instrumentation is returned; only the instrumentation targeting this package name is returned. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Retrieve all activities that can be performed for the given intent.
intent | The desired intent as per resolveActivity(). |
---|---|
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT . |
resolveActivity(Intent, int)
. If there are no matching activities, an empty
list is returned.Retrieve a set of activities that should be presented to the user as
similar options. This is like queryIntentActivities(Intent, int)
, except it
also allows you to supply a list of more explicit Intents that you would
like to resolve to particular options, and takes care of returning the
final ResolveInfo list in a reasonable order, with no duplicates, based
on those inputs.
caller | The class name of the activity that is making the request. This activity will never appear in the output list. Can be null. |
---|---|
specifics | An array of Intents that should be resolved to the first specific results. Can be null. |
intent | The desired intent as per resolveActivity(). |
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT . |
Retrieve all providers that can match the given intent.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. |
Retrieve all services that can match the given intent.
intent | The desired intent as per resolveService(). |
---|---|
flags | Additional option flags. |
Query for all of the permissions associated with a particular group.
Throws PackageManager.NameNotFoundException
if the given group does not
exist.
group | The fully qualified name (i.e. com.google.permission.LOGIN) of the permission group you are interested in. Use null to find all of the permissions not associated with a group. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permissions. |
PermissionInfo
containing information
about all of the permissions in the given group.
This method was deprecated
in API level 7.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superseded
by (and conflicts with) the modern activity-based preferences.
Removes a permission that was previously added with
addPermission(PermissionInfo)
. The same ownership rules apply
-- you are only allowed to remove permissions that you are allowed
to add.
name | The name of the permission to remove. |
---|
SecurityException | if you are not allowed to remove the given permission name. |
---|
Determine the best action to perform for a given Intent. This is how
resolveActivity(PackageManager)
finds an activity if a class has not
been explicitly specified.
Note: if using an implicit Intent (without an explicit ComponentName
specified), be sure to consider whether to set the MATCH_DEFAULT_ONLY
only flag. You need to do so to resolve the activity in the same way
that startActivity(Intent)
and
Intent.resolveActivity(PackageManager)
do.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. The most important is
MATCH_DEFAULT_ONLY , to limit the resolution to only
those activities that support the CATEGORY_DEFAULT . |
Find a single content provider by its base path name.
name | The name of the provider to find. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Determine the best service to handle for a given Intent.
intent | An intent containing all of the desired specification (action, data, type, category, and/or component). |
---|---|
flags | Additional option flags. |
Set the enabled setting for an application
This setting will override any enabled state which may have been set by the application in
its manifest. It also overrides the enabled state set in the manifest for any of the
application's components. It does not override any enabled state set by
setComponentEnabledSetting(ComponentName, int, int)
for any of the application's components.
packageName | The package name of the application to enable |
---|---|
newState | The new enabled state for the component. The legal values for this state
are:
COMPONENT_ENABLED_STATE_ENABLED ,
COMPONENT_ENABLED_STATE_DISABLED
and
COMPONENT_ENABLED_STATE_DEFAULT
The last one removes the setting, thereby restoring the applications's state to
whatever was set in its manifest (or enabled, by default). |
flags | Optional behavior flags: DONT_KILL_APP or 0.
|
Set the enabled setting for a package component (activity, receiver, service, provider). This setting will override any enabled state which may have been set by the component in its manifest.
componentName | The component to enable |
---|---|
newState | The new enabled state for the component. The legal values for this state
are:
COMPONENT_ENABLED_STATE_ENABLED ,
COMPONENT_ENABLED_STATE_DISABLED
and
COMPONENT_ENABLED_STATE_DEFAULT
The last one removes the setting, thereby restoring the component's state to
whatever was set in it's manifest (or enabled, by default). |
flags | Optional behavior flags: DONT_KILL_APP or 0.
|
Change the installer associated with a given package. There are limitations on how the installer package can be changed; in particular:
targetPackage | The installed package whose installer will be changed. |
---|---|
installerPackageName | The package name of the new installer. May be null to clear the association. |
Allows a package listening to the
package verification
broadcast
to respond to the package manager. The response must include
the verificationCode
which is one of
VERIFICATION_ALLOW
or
VERIFICATION_REJECT
.
id | pending package identifier as passed via the
EXTRA_VERIFICATION_ID Intent extra. |
---|---|
verificationCode | either VERIFICATION_ALLOW
or VERIFICATION_REJECT . |
SecurityException | if the caller does not have the PACKAGE_VERIFICATION_AGENT permission. |
---|