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 can not be found. |
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | COMPONENT_ENABLED_STATE_DEFAULT | ||||||||||
int | COMPONENT_ENABLED_STATE_DISABLED | ||||||||||
int | COMPONENT_ENABLED_STATE_ENABLED | ||||||||||
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 | 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_BLUETOOTH | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device is capable of communicating with
other devices via Bluetooth. |
|||||||||
String | FEATURE_CAMERA | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device has a camera facing away
from the screen. |
|||||||||
String | FEATURE_CAMERA_AUTOFOCUS | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device's camera supports auto-focus. |
|||||||||
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_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_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_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_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_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_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_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_WIFI | Feature for getSystemAvailableFeatures() and
hasSystemFeature(String) : The device supports WiFi (802.11) 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_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 all applications(even uninstalled ones) with 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. |
|||||||||
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. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superceeded
(and conflicts with) the modern activity-based preferences.
| |||||||||||
Add a new dynamic permission to the system.
| |||||||||||
Like
addPermission(PermissionInfo) but asynchronously
persists the package manager state after returning from the call,
allowing it to return quicker and batch a series of adds at the
expense of no guarantee the added permission will be retained if
the device is rebooted before it is written. | |||||||||||
This method is deprecated.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this can not 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.
| |||||||||||
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.
| |||||||||||
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.
| |||||||||||
Retrieve the official name associated with a user id.
| |||||||||||
Retrieve overall information about an application package defined
in a package archive file
| |||||||||||
Return an array of all of the secondary group-ids that have been
assigned to a package.
| |||||||||||
Retrieve overall information about an application package that is
installed on the system.
| |||||||||||
Retrieve the names of all packages that are associated with a particular
user id.
| |||||||||||
Retrieve all of the information we know about a particular group of
permissions.
| |||||||||||
Retrieve all of the information we know about a particular permission.
| |||||||||||
Retrieve all preferred activities, previously added with
addPreferredActivity(IntentFilter, int, ComponentName[], ComponentName) , that are
currently registered with the system. | |||||||||||
Retrieve the list of all currently configured preferred packages.
| |||||||||||
Retrieve all of the information we know about a particular 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 services that can match the given intent.
| |||||||||||
Query for all of the permissions associated with a particular group.
| |||||||||||
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superceeded
(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.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
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.
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 is capable of communicating with
other devices via Bluetooth.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device has a camera facing away
from the screen.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device's camera supports auto-focus.
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 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 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 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 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 light sensor.
Feature for getSystemAvailableFeatures()
and
hasSystemFeature(String)
: The device includes a proximity sensor.
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.
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 WiFi (802.11) 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: return the
group ids
that are associated with an
application.
This applies for any API returning an 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 all applications(even uninstalled ones) with 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
ProviderInfo
flag: return the
URI permission patterns
that are associated with a content provider.
This applies for any API returning an 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.
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.
This method is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superceeded
(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 is deprecated.
This is a protected API that should not have been available
to third party applications. It is the platform's responsibility for
assigning preferred activities and this can not 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. |
---|
Retrieve the icon associated with an Intent. If intent.getClassName() is set, this simply returns the result of getActivityIcon(intent.getClassName()). Otherwise it resolves the intent's component and returns the icon associated with the resolved component. If intent.getClassName() can not be found or the Intent can not be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve an icon. |
---|
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 can not 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 can not 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() can not be found or the Intent can not be resolved to a component, NameNotFoundException is thrown.
intent | The intent for which you would like to retrieve 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 can not 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.
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
.
Retrieve the icon associated with an application. Given the name of the application's package, retrieves the information about it and calls getApplicationIcon() to return its icon. If the application can not be found, NameNotFoundException is thrown.
packageName | Name of the package whose application icon is to be retrieved. |
---|
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 can not be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of an application. |
---|---|
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
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_DELTE_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 can not 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. Can not be null. |
---|---|
resid | The resource identifier of the desired image. Can not be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Return a List of all application packages that are installed on the device. If flag GET_UNINSTALLED_PACKAGES has been set, a list of all applications including those deleted with DONT_DELETE_DATA(partially installed apps with data directory) will be returned.
flags | Additional option flags. Use any combination of
GET_META_DATA , GET_SHARED_LIBRARY_FILES ,
{link #GET_UNINSTALLED_PACKAGES} to modify the data returned. |
---|
Return a List of all packages that are installed on the device.
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
---|
Retrieve 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 can not be found on the system.
className | The full name (i.e. com.google.apps.contacts.InstrumentList) of an Instrumentation class. |
---|---|
flags | Additional option flags. Currently should always be 0. |
Return a "good" intent to launch a front-door activity in a package,
for use for example to implement an "open" button when browsing through
packages. The current implementation will look first for a main
activity in the category CATEGORY_INFO
, next for a
main activity in the category CATEGORY_LAUNCHER
, or return
null if neither are found.
Throws PackageManager.NameNotFoundException
if a package with the given
name can not be found on the system.
packageName | The name of the package to inspect. |
---|
Retrieve the official name associated with a user id. This name is guaranteed to never change, though it is possibly for the underlying user id to be changed. That is, if you are storing information about user ids in persistent storage, you should use the string returned by this function instead of the raw user-id.
uid | The user id for which you would like to retrieve a name. |
---|
Retrieve overall information about an application package defined in a package archive file
archiveFilePath | The path to the archive file |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES , to modify the data returned. |
Return an array of all of the secondary group-ids that have been assigned to a package.
Throws PackageManager.NameNotFoundException
if a package with the given
name can not be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|
Retrieve overall information about an application package that is installed on the system.
Throws PackageManager.NameNotFoundException
if a package with the given
name can not be found on the system.
packageName | The full name (i.e. com.google.apps.contacts) of the desired package. |
---|---|
flags | Additional option flags. Use any combination of
GET_ACTIVITIES ,
GET_GIDS ,
GET_CONFIGURATIONS ,
GET_INSTRUMENTATION ,
GET_PERMISSIONS ,
GET_PROVIDERS ,
GET_RECEIVERS ,
GET_SERVICES ,
GET_SIGNATURES ,
GET_UNINSTALLED_PACKAGES to modify the data returned. |
Retrieve the names of all packages that are associated with a particular user id. In most cases, this will be a single package name, the package that has been assigned that user id. Where there are multiple packages sharing the same user id through the "sharedUserId" mechanism, all packages with that id will be returned.
uid | The user id for which you would like to retrieve the associated packages. |
---|
Retrieve all of the information we know about a particular group of permissions.
Throws PackageManager.NameNotFoundException
if a permission group with the given
name can not be found on the system.
name | The fully qualified name (i.e. com.google.permission_group.APPS) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission group. |
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 can not be found on the system.
name | The fully qualified name (i.e. com.google.permission.LOGIN) of the permission you are interested in. |
---|---|
flags | Additional option flags. Use GET_META_DATA to
retrieve any meta-data associated with the permission. |
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 can not 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 can not 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 can not 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 can not 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 can not 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. Can not be null. |
---|---|
resid | The resource identifier of the desired text. Can not be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
Retrieve an XML file from a package. This is a low-level API used to retrieve XML meta data.
packageName | The name of the package that this xml is coming from. Can not be null. |
---|---|
resid | The resource identifier of the desired xml. Can not be 0. |
appInfo | Overall information about packageName. This may be null, in which case the application information will be retrieved for you if needed; if you already have this information around, it can be much more efficient to supply it here. |
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 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 is deprecated.
This function no longer does anything; it was an old
approach to managing preferred activities, which has been superceeded
(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. |