Added in API level 1

Summary: Constants | Inherited Constants | Fields | Ctors | Methods | Inherited Methods

PackageInfo

---

Kotlin |Java

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

From interface android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor. int PARCELABLE_WRITE_RETURN_VALUE Flag for use with writeToParcel(Parcel, int): the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)".

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.
boolean	isAppMetadataVerified() Returns the verification status of the App Metadata of the package.
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
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed. final void wait() Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
From interface android.os.Parcelable abstract int describeContents() Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. abstract void writeToParcel(Parcel dest, int flags) Flatten this object in to a Parcel.

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.

See also:

• FeatureInfo.FLAG_REQUIRED

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.

See also:

• FeatureInfo.FLAG_REQUIRED

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.

See also:

• getLongVersionCode()

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

isAppMetadataVerified

Added in version 36.1

public boolean isAppMetadataVerified ()

Returns the verification status of the App Metadata of the package. This status is set at the package installation time by the developer verification service provider.

Returns
boolean

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

See also:

• getLongVersionCode()

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