PackageInfo


public class PackageInfo
extends Object implements Parcelable

java.lang.Object
   ↳ android.content.pm.PackageInfo


Overall information about the contents of a package. This corresponds to all of the information collected from AndroidManifest.xml.

Summary

Constants

int INSTALL_LOCATION_AUTO

Constant corresponding to auto in the R.attr.installLocation attribute.

int INSTALL_LOCATION_INTERNAL_ONLY

Constant corresponding to internalOnly in the R.attr.installLocation attribute.

int INSTALL_LOCATION_PREFER_EXTERNAL

Constant corresponding to preferExternal in the R.attr.installLocation attribute.

int REQUESTED_PERMISSION_GRANTED

Flag for requestedPermissionsFlags: the requested permission is currently granted to the application.

int REQUESTED_PERMISSION_IMPLICIT

Flag for requestedPermissionsFlags: the requested permission was not explicitly requested via uses-permission, but was instead implicitly requested (e.g., for version compatibility reasons).

int REQUESTED_PERMISSION_NEVER_FOR_LOCATION

Flag for requestedPermissionsFlags: the requested permission has declared neverForLocation in their manifest as a strong assertion by a developer that they will never use this permission to derive the physical location of the device, regardless of Manifest.permission.ACCESS_FINE_LOCATION and/or Manifest.permission.ACCESS_COARSE_LOCATION being granted.

Inherited constants

Fields

public static final Creator<PackageInfo> CREATOR

public ActivityInfo[] activities

Array of all <activity> tags included under <application>, or null if there were none.

public ApplicationInfo applicationInfo

Information collected from the <application> tag, or null if there was none.

public Attribution[] attributions

Array of all <attribution> tags included under <manifest>, or null if there were none.

public int baseRevisionCode

The revision number of the base APK for this package, as specified by the <manifest> tag's revisionCode attribute.

public ConfigurationInfo[] configPreferences

Application specified preferred configuration <uses-configuration> tags included under <manifest>, or null if there were none.

public FeatureGroupInfo[] featureGroups

Groups of features that this application has requested.

public long firstInstallTime

The time at which the app was first installed.

public int[] gids

All kernel group-IDs that have been assigned to this package.

public int installLocation

The install location requested by the package.

public InstrumentationInfo[] instrumentation

Array of all <instrumentation> tags included under <manifest>, or null if there were none.

public boolean isApex

Whether the package is an APEX package.

public long lastUpdateTime

The time at which the app was last updated.

public String packageName

The name of this package.

public PermissionInfo[] permissions

Array of all <permission> tags included under <manifest>, or null if there were none.

public ProviderInfo[] providers

Array of all <provider> tags included under <application>, or null if there were none.

public ActivityInfo[] receivers

Array of all <receiver> tags included under <application>, or null if there were none.

public FeatureInfo[] reqFeatures

Features that this application has requested.

public String[] requestedPermissions

Array of all <uses-permission> tags included under <manifest>, or null if there were none.

public int[] requestedPermissionsFlags

Array of flags of all <uses-permission> tags included under <manifest>, or null if there were none.

public ServiceInfo[] services

Array of all <service> tags included under <application>, or null if there were none.

public String sharedUserId

The shared user ID name of this package, as specified by the <manifest> tag's sharedUserId attribute.

public int sharedUserLabel

The shared user ID label of this package, as specified by the <manifest> tag's sharedUserLabel attribute.

public Signature[] signatures

This field was deprecated in API level 28. use signingInfo instead

public SigningInfo signingInfo

Signing information read from the package file, potentially including past signing certificates no longer used after signing certificate rotation.

public String[] splitNames

The names of any installed split APKs for this package.

public int[] splitRevisionCodes

The revision number of any split APKs for this package, as specified by the <manifest> tag's revisionCode attribute.

public int versionCode

This field was deprecated in API level 28. Use getLongVersionCode() instead, which includes both this and the additional versionCodeMajor attribute. The version number of this package, as specified by the <manifest> tag's versionCode attribute.

public String versionName

The version name of this package, as specified by the <manifest> tag's versionName attribute, or null if there was none.

Public constructors

PackageInfo()

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

String getApexPackageName()

If the package is an APEX package (i.e.

long getArchiveTimeMillis()

Returns the time at which the app was archived for the user.

long getLongVersionCode()

Return versionCode and versionCodeMajor combined together as a single long value.

void setLongVersionCode(long longVersionCode)

Set the full version code in this PackageInfo, updating versionCode with the lower bits.

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel dest, int parcelableFlags)

Flatten this object in to a Parcel.

Inherited methods

Constants

INSTALL_LOCATION_AUTO

Added in API level 21
public static final int INSTALL_LOCATION_AUTO

Constant corresponding to auto in the R.attr.installLocation attribute.

Constant Value: 0 (0x00000000)

INSTALL_LOCATION_INTERNAL_ONLY

Added in API level 21
public static final int INSTALL_LOCATION_INTERNAL_ONLY

Constant corresponding to internalOnly in the R.attr.installLocation attribute.

Constant Value: 1 (0x00000001)

INSTALL_LOCATION_PREFER_EXTERNAL

Added in API level 21
public static final int INSTALL_LOCATION_PREFER_EXTERNAL

Constant corresponding to preferExternal in the R.attr.installLocation attribute.

Constant Value: 2 (0x00000002)

REQUESTED_PERMISSION_GRANTED

Added in API level 16
public static final int REQUESTED_PERMISSION_GRANTED

Flag for requestedPermissionsFlags: the requested permission is currently granted to the application.

Constant Value: 2 (0x00000002)

REQUESTED_PERMISSION_IMPLICIT

Added in API level 34
public static final int REQUESTED_PERMISSION_IMPLICIT

Flag for requestedPermissionsFlags: the requested permission was not explicitly requested via uses-permission, but was instead implicitly requested (e.g., for version compatibility reasons).

Constant Value: 4 (0x00000004)

REQUESTED_PERMISSION_NEVER_FOR_LOCATION

Added in API level 31
public static final int REQUESTED_PERMISSION_NEVER_FOR_LOCATION

Flag for requestedPermissionsFlags: the requested permission has declared neverForLocation in their manifest as a strong assertion by a developer that they will never use this permission to derive the physical location of the device, regardless of Manifest.permission.ACCESS_FINE_LOCATION and/or Manifest.permission.ACCESS_COARSE_LOCATION being granted.

Constant Value: 65536 (0x00010000)

Fields

CREATOR

Added in API level 1
public static final Creator<PackageInfo> CREATOR

activities

Added in API level 1
public ActivityInfo[] activities

Array of all <activity> tags included under <application>, or null if there were none. This is only filled in if the flag PackageManager#GET_ACTIVITIES was set.

applicationInfo

Added in API level 1
public ApplicationInfo applicationInfo

Information collected from the <application> tag, or null if there was none.

attributions

Added in API level 31
public Attribution[] attributions

Array of all <attribution> tags included under <manifest>, or null if there were none. This is only filled if the flag PackageManager#GET_ATTRIBUTIONS_LONG was set.

baseRevisionCode

Added in API level 22
public int baseRevisionCode

The revision number of the base APK for this package, as specified by the <manifest> tag's revisionCode attribute.

configPreferences

Added in API level 3
public ConfigurationInfo[] configPreferences

Application specified preferred configuration <uses-configuration> tags included under <manifest>, or null if there were none. This is only filled in if the flag PackageManager#GET_CONFIGURATIONS was set.

featureGroups

Added in API level 21
public FeatureGroupInfo[] featureGroups

Groups of features that this application has requested. Each group contains a set of features that are required. A device must match the features listed in reqFeatures and one or more FeatureGroups in order to have satisfied the feature requirement.

firstInstallTime

Added in API level 9
public long firstInstallTime

The time at which the app was first installed. Units are as per System#currentTimeMillis().

gids

Added in API level 1
public int[] gids

All kernel group-IDs that have been assigned to this package. This is only filled in if the flag PackageManager#GET_GIDS was set.

installLocation

Added in API level 21
public int installLocation

The install location requested by the package. From the R.attr.installLocation attribute, one of INSTALL_LOCATION_AUTO, INSTALL_LOCATION_INTERNAL_ONLY, INSTALL_LOCATION_PREFER_EXTERNAL

instrumentation

Added in API level 1
public InstrumentationInfo[] instrumentation

Array of all <instrumentation> tags included under <manifest>, or null if there were none. This is only filled in if the flag PackageManager#GET_INSTRUMENTATION was set.

isApex

Added in API level 29
public boolean isApex

Whether the package is an APEX package.

lastUpdateTime

Added in API level 9
public long lastUpdateTime

The time at which the app was last updated. Units are as per System#currentTimeMillis().

packageName

Added in API level 1
public String packageName

The name of this package. From the <manifest> tag's "name" attribute.

permissions

Added in API level 1
public PermissionInfo[] permissions

Array of all <permission> tags included under <manifest>, or null if there were none. This is only filled in if the flag PackageManager#GET_PERMISSIONS was set.

providers

Added in API level 1
public ProviderInfo[] providers

Array of all <provider> tags included under <application>, or null if there were none. This is only filled in if the flag PackageManager#GET_PROVIDERS was set.

receivers

Added in API level 1
public ActivityInfo[] receivers

Array of all <receiver> tags included under <application>, or null if there were none. This is only filled in if the flag PackageManager#GET_RECEIVERS was set.

reqFeatures

Added in API level 5
public FeatureInfo[] reqFeatures

Features that this application has requested.

requestedPermissions

Added in API level 1
public String[] requestedPermissions

Array of all <uses-permission> tags included under <manifest>, or null if there were none. This is only filled in if the flag PackageManager#GET_PERMISSIONS was set. This list includes all permissions requested, even those that were not granted or known by the system at install time.

requestedPermissionsFlags

Added in API level 16
public int[] requestedPermissionsFlags

Array of flags of all <uses-permission> tags included under <manifest>, or null if there were none. This is only filled in if the flag PackageManager#GET_PERMISSIONS was set. Each value matches the corresponding entry in requestedPermissions, and will have the flags REQUESTED_PERMISSION_GRANTED, REQUESTED_PERMISSION_IMPLICIT, and REQUESTED_PERMISSION_NEVER_FOR_LOCATION set as appropriate.

services

Added in API level 1
public ServiceInfo[] services

Array of all <service> tags included under <application>, or null if there were none. This is only filled in if the flag PackageManager#GET_SERVICES was set.

sharedUserId

Added in API level 3
public String sharedUserId

The shared user ID name of this package, as specified by the <manifest> tag's sharedUserId attribute.

sharedUserLabel

Added in API level 3
public int sharedUserLabel

The shared user ID label of this package, as specified by the <manifest> tag's sharedUserLabel attribute.

signatures

Added in API level 1
Deprecated in API level 28
public Signature[] signatures

This field was deprecated in API level 28.
use signingInfo instead

Array of all signatures read from the package file. This is only filled in if the flag PackageManager#GET_SIGNATURES was set. A package must be signed with at least one certificate which is at position zero. The package can be signed with additional certificates which appear as subsequent entries. Note: Signature ordering is not guaranteed to be stable which means that a package signed with certificates A and B is equivalent to being signed with certificates B and A. This means that in case multiple signatures are reported you cannot assume the one at the first position to be the same across updates. Deprecated This has been replaced by the PackageInfo#signingInfo field, which takes into account signing certificate rotation. For backwards compatibility in the event of signing certificate rotation, this will return the oldest reported signing certificate, so that an application will appear to callers as though no rotation occurred.

signingInfo

Added in API level 28
public SigningInfo signingInfo

Signing information read from the package file, potentially including past signing certificates no longer used after signing certificate rotation. This is only filled in if the flag PackageManager#GET_SIGNING_CERTIFICATES was set. Use this field instead of the deprecated signatures field. See SigningInfo for more information on its contents.

splitNames

Added in API level 21
public String[] splitNames

The names of any installed split APKs for this package.

splitRevisionCodes

Added in API level 22
public int[] splitRevisionCodes

The revision number of any split APKs for this package, as specified by the <manifest> tag's revisionCode attribute. Indexes are a 1:1 mapping against splitNames.

versionCode

Added in API level 1
Deprecated in API level 28
public int versionCode

This field was deprecated in API level 28.
Use getLongVersionCode() instead, which includes both this and the additional versionCodeMajor attribute. The version number of this package, as specified by the <manifest> tag's versionCode attribute.

versionName

Added in API level 1
public String versionName

The version name of this package, as specified by the <manifest> tag's versionName attribute, or null if there was none.

Public constructors

PackageInfo

Added in API level 1
public PackageInfo ()

Public methods

describeContents

Added in API level 1
public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

getApexPackageName

Added in API level 35
public String getApexPackageName ()

If the package is an APEX package (i.e. the value of isApex is true), returns the package name of the APEX. If the package is one APK-in-APEX app, returns the package name of the parent APEX that contains the app. If the package is not one of the above two cases, returns null.

Returns
String

getArchiveTimeMillis

Added in API level 35
public long getArchiveTimeMillis ()

Returns the time at which the app was archived for the user. Units are as per System#currentTimeMillis().
Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.

Returns
long Value is a non-negative timestamp measured as the number of milliseconds since 1970-01-01T00:00:00Z.

getLongVersionCode

Added in API level 28
public long getLongVersionCode ()

Return versionCode and versionCodeMajor combined together as a single long value. The versionCodeMajor is placed in the upper 32 bits.

Returns
long

setLongVersionCode

Added in API level 28
public void setLongVersionCode (long longVersionCode)

Set the full version code in this PackageInfo, updating versionCode with the lower bits.

Parameters
longVersionCode long

toString

Added in API level 1
public String toString ()

Returns a string representation of the object.

Returns
String a string representation of the object.

writeToParcel

Added in API level 1
public void writeToParcel (Parcel dest, 
                int parcelableFlags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written. This value cannot be null.

parcelableFlags int: Additional flags about how the object should be written. May be 0 or Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of Parcelable.PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES