/*
 * Copyright (C) 2007 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package android.content.pm;

import android.annotation.Nullable;
import android.os.Parcel;
import android.os.Parcelable;

Overall information about the contents of a package. This corresponds to all of the information collected from AndroidManifest.xml.
/** * Overall information about the contents of a package. This corresponds * to all of the information collected from AndroidManifest.xml. */
public class PackageInfo implements Parcelable {
The name of this package. From the <manifest> tag's "name" attribute.
/** * The name of this package. From the &lt;manifest&gt; tag's "name" * attribute. */
public String packageName;
The names of any installed split APKs for this package.
/** * The names of any installed split APKs for this package. */
public String[] splitNames;
See Also:
Deprecated: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.
/** * @deprecated Use {@link #getLongVersionCode()} instead, which includes both * this and the additional * {@link android.R.styleable#AndroidManifest_versionCodeMajor versionCodeMajor} attribute. * The version number of this package, as specified by the &lt;manifest&gt; * tag's {@link android.R.styleable#AndroidManifest_versionCode versionCode} * attribute. * @see #getLongVersionCode() */
@Deprecated public int versionCode;
See Also:
@hide The major version number of this package, as specified by the <manifest> tag's versionCodeMajor attribute.
/** * @hide * The major version number of this package, as specified by the &lt;manifest&gt; * tag's {@link android.R.styleable#AndroidManifest_versionCode versionCodeMajor} * attribute. * @see #getLongVersionCode() */
public int versionCodeMajor;
Return versionCode and versionCodeMajor combined together as a single long value. The versionCodeMajor is placed in the upper 32 bits.
/** * Return {@link android.R.styleable#AndroidManifest_versionCode versionCode} and * {@link android.R.styleable#AndroidManifest_versionCodeMajor versionCodeMajor} combined * together as a single long value. The * {@link android.R.styleable#AndroidManifest_versionCodeMajor versionCodeMajor} is placed in * the upper 32 bits. */
public long getLongVersionCode() { return composeLongVersionCode(versionCodeMajor, versionCode); }
Set the full version code in this PackageInfo, updating versionCode with the lower bits.
See Also:
/** * Set the full version code in this PackageInfo, updating {@link #versionCode} * with the lower bits. * @see #getLongVersionCode() */
public void setLongVersionCode(long longVersionCode) { versionCodeMajor = (int) (longVersionCode>>32); versionCode = (int) longVersionCode; }
@hideInternal implementation for composing a minor and major version code in to a single long version code.
/** * @hide Internal implementation for composing a minor and major version code in to * a single long version code. */
public static long composeLongVersionCode(int major, int minor) { return (((long) major) << 32) | (((long) minor) & 0xffffffffL); }
The version name of this package, as specified by the <manifest> tag's versionName attribute.
/** * The version name of this package, as specified by the &lt;manifest&gt; * tag's {@link android.R.styleable#AndroidManifest_versionName versionName} * attribute. */
public String versionName;
The revision number of the base APK for this package, as specified by the <manifest> tag's revisionCode attribute.
/** * The revision number of the base APK for this package, as specified by the * &lt;manifest&gt; tag's * {@link android.R.styleable#AndroidManifest_revisionCode revisionCode} * attribute. */
public int baseRevisionCode;
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.
/** * The revision number of any split APKs for this package, as specified by * the &lt;manifest&gt; tag's * {@link android.R.styleable#AndroidManifest_revisionCode revisionCode} * attribute. Indexes are a 1:1 mapping against {@link #splitNames}. */
public int[] splitRevisionCodes;
The shared user ID name of this package, as specified by the <manifest> tag's sharedUserId attribute.
/** * The shared user ID name of this package, as specified by the &lt;manifest&gt; * tag's {@link android.R.styleable#AndroidManifest_sharedUserId sharedUserId} * attribute. */
public String sharedUserId;
The shared user ID label of this package, as specified by the <manifest> tag's sharedUserLabel attribute.
/** * The shared user ID label of this package, as specified by the &lt;manifest&gt; * tag's {@link android.R.styleable#AndroidManifest_sharedUserLabel sharedUserLabel} * attribute. */
public int sharedUserLabel;
Information collected from the <application> tag, or null if there was none.
/** * Information collected from the &lt;application&gt; tag, or null if * there was none. */
public ApplicationInfo applicationInfo;
The time at which the app was first installed. Units are as per System.currentTimeMillis().
/** * The time at which the app was first installed. Units are as * per {@link System#currentTimeMillis()}. */
public long firstInstallTime;
The time at which the app was last updated. Units are as per System.currentTimeMillis().
/** * The time at which the app was last updated. Units are as * per {@link System#currentTimeMillis()}. */
public long lastUpdateTime;
All kernel group-IDs that have been assigned to this package. This is only filled in if the flag PackageManager.GET_GIDS was set.
/** * All kernel group-IDs that have been assigned to this package. * This is only filled in if the flag {@link PackageManager#GET_GIDS} was set. */
public int[] gids;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestActivity * &lt;activity&gt;} tags included under &lt;application&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_ACTIVITIES} was set. */
public ActivityInfo[] activities;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestReceiver * &lt;receiver&gt;} tags included under &lt;application&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_RECEIVERS} was set. */
public ActivityInfo[] receivers;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestService * &lt;service&gt;} tags included under &lt;application&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_SERVICES} was set. */
public ServiceInfo[] services;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestProvider * &lt;provider&gt;} tags included under &lt;application&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_PROVIDERS} was set. */
public ProviderInfo[] providers;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestInstrumentation * &lt;instrumentation&gt;} tags included under &lt;manifest&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_INSTRUMENTATION} was set. */
public InstrumentationInfo[] instrumentation;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestPermission * &lt;permission&gt;} tags included under &lt;manifest&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_PERMISSIONS} was set. */
public PermissionInfo[] permissions;
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.
/** * Array of all {@link android.R.styleable#AndroidManifestUsesPermission * &lt;uses-permission&gt;} tags included under &lt;manifest&gt;, * or null if there were none. This is only filled in if the flag * {@link 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. */
public String[] requestedPermissions;
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 flag REQUESTED_PERMISSION_GRANTED set as appropriate.
/** * Array of flags of all {@link android.R.styleable#AndroidManifestUsesPermission * &lt;uses-permission&gt;} tags included under &lt;manifest&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_PERMISSIONS} was set. Each value matches * the corresponding entry in {@link #requestedPermissions}, and will have * the flag {@link #REQUESTED_PERMISSION_GRANTED} set as appropriate. */
public int[] requestedPermissionsFlags;
Flag for requestedPermissionsFlags: the requested permission is required for the application to run; the user can not optionally disable it. Currently all permissions are required.
@removedWe do not support required permissions.
/** * Flag for {@link #requestedPermissionsFlags}: the requested permission * is required for the application to run; the user can not optionally * disable it. Currently all permissions are required. * * @removed We do not support required permissions. */
public static final int REQUESTED_PERMISSION_REQUIRED = 1<<0;
Flag for requestedPermissionsFlags: the requested permission is currently granted to the application.
/** * Flag for {@link #requestedPermissionsFlags}: the requested permission * is currently granted to the application. */
public static final int REQUESTED_PERMISSION_GRANTED = 1<<1;
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 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.
Deprecated:use signingInfo instead
/** * Array of all signatures read from the package file. This is only filled * in if the flag {@link 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. * * <strong>Note:</strong> 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. * * <strong>Deprecated</strong> This has been replaced by the * {@link 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. * * @deprecated use {@code signingInfo} instead */
@Deprecated public Signature[] signatures;
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.
/** * 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 {@link PackageManager#GET_SIGNING_CERTIFICATES} was set. * * Use this field instead of the deprecated {@code signatures} field. * See {@link SigningInfo} for more information on its contents. */
public SigningInfo signingInfo;
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.
/** * Application specified preferred configuration * {@link android.R.styleable#AndroidManifestUsesConfiguration * &lt;uses-configuration&gt;} tags included under &lt;manifest&gt;, * or null if there were none. This is only filled in if the flag * {@link PackageManager#GET_CONFIGURATIONS} was set. */
public ConfigurationInfo[] configPreferences;
Features that this application has requested.
See Also:
  • FLAG_REQUIRED.FLAG_REQUIRED
/** * Features that this application has requested. * * @see FeatureInfo#FLAG_REQUIRED */
public FeatureInfo[] reqFeatures;
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:
/** * 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 {@link #reqFeatures} and one * or more FeatureGroups in order to have satisfied the feature requirement. * * @see FeatureInfo#FLAG_REQUIRED */
public FeatureGroupInfo[] featureGroups;
Constant corresponding to auto in the installLocation.installLocation attribute.
@hide
/** * Constant corresponding to <code>auto</code> in * the {@link android.R.attr#installLocation} attribute. * @hide */
public static final int INSTALL_LOCATION_UNSPECIFIED = -1;
Constant corresponding to auto in the installLocation.installLocation attribute.
/** * Constant corresponding to <code>auto</code> in the * {@link android.R.attr#installLocation} attribute. */
public static final int INSTALL_LOCATION_AUTO = 0;
Constant corresponding to internalOnly in the installLocation.installLocation attribute.
/** * Constant corresponding to <code>internalOnly</code> in the * {@link android.R.attr#installLocation} attribute. */
public static final int INSTALL_LOCATION_INTERNAL_ONLY = 1;
Constant corresponding to preferExternal in the installLocation.installLocation attribute.
/** * Constant corresponding to <code>preferExternal</code> in the * {@link android.R.attr#installLocation} attribute. */
public static final int INSTALL_LOCATION_PREFER_EXTERNAL = 2;
The install location requested by the package. From the installLocation.installLocation attribute, one of INSTALL_LOCATION_AUTO, INSTALL_LOCATION_INTERNAL_ONLY, INSTALL_LOCATION_PREFER_EXTERNAL
/** * The install location requested by the package. From the * {@link android.R.attr#installLocation} attribute, one of * {@link #INSTALL_LOCATION_AUTO}, {@link #INSTALL_LOCATION_INTERNAL_ONLY}, * {@link #INSTALL_LOCATION_PREFER_EXTERNAL} */
public int installLocation = INSTALL_LOCATION_INTERNAL_ONLY;
@hide
/** @hide */
public boolean isStub;
@hide
/** @hide */
public boolean coreApp;
@hide
/** @hide */
public boolean requiredForAllUsers;
@hide
/** @hide */
public String restrictedAccountType;
@hide
/** @hide */
public String requiredAccountType;
What package, if any, this package will overlay. Package name of target package, or null.
@hide
/** * What package, if any, this package will overlay. * * Package name of target package, or null. * @hide */
public String overlayTarget;
The overlay category, if any, of this package
@hide
/** * The overlay category, if any, of this package * * @hide */
public String overlayCategory;
@hide
/** @hide */
public int overlayPriority;
Whether the overlay is static, meaning it cannot be enabled/disabled at runtime.
/** * Whether the overlay is static, meaning it cannot be enabled/disabled at runtime. */
boolean mOverlayIsStatic;
The user-visible SDK version (ex. 26) of the framework against which the application claims to have been compiled, or 0 if not specified.

This property is the compile-time equivalent of Build.VERSION.SDK_INT.

@hideFor platform use only; we don't expect developers to need to read this value.
/** * The user-visible SDK version (ex. 26) of the framework against which the application claims * to have been compiled, or {@code 0} if not specified. * <p> * This property is the compile-time equivalent of * {@link android.os.Build.VERSION#SDK_INT Build.VERSION.SDK_INT}. * * @hide For platform use only; we don't expect developers to need to read this value. */
public int compileSdkVersion;
The development codename (ex. "O", "REL") of the framework against which the application claims to have been compiled, or null if not specified.

This property is the compile-time equivalent of Build.VERSION.CODENAME.

@hideFor platform use only; we don't expect developers to need to read this value.
/** * The development codename (ex. "O", "REL") of the framework against which the application * claims to have been compiled, or {@code null} if not specified. * <p> * This property is the compile-time equivalent of * {@link android.os.Build.VERSION#CODENAME Build.VERSION.CODENAME}. * * @hide For platform use only; we don't expect developers to need to read this value. */
@Nullable public String compileSdkVersionCodename; public PackageInfo() { }
Returns true if the package is a valid Runtime Overlay package.
@hide
/** * Returns true if the package is a valid Runtime Overlay package. * @hide */
public boolean isOverlayPackage() { return overlayTarget != null; }
Returns true if the package is a valid static Runtime Overlay package. Static overlays are not updatable outside of a system update and are safe to load in the system process.
@hide
/** * Returns true if the package is a valid static Runtime Overlay package. Static overlays * are not updatable outside of a system update and are safe to load in the system process. * @hide */
public boolean isStaticOverlayPackage() { return overlayTarget != null && mOverlayIsStatic; } @Override public String toString() { return "PackageInfo{" + Integer.toHexString(System.identityHashCode(this)) + " " + packageName + "}"; } @Override public int describeContents() { return 0; } @Override public void writeToParcel(Parcel dest, int parcelableFlags) { dest.writeString(packageName); dest.writeStringArray(splitNames); dest.writeInt(versionCode); dest.writeInt(versionCodeMajor); dest.writeString(versionName); dest.writeInt(baseRevisionCode); dest.writeIntArray(splitRevisionCodes); dest.writeString(sharedUserId); dest.writeInt(sharedUserLabel); if (applicationInfo != null) { dest.writeInt(1); applicationInfo.writeToParcel(dest, parcelableFlags); } else { dest.writeInt(0); } dest.writeLong(firstInstallTime); dest.writeLong(lastUpdateTime); dest.writeIntArray(gids); dest.writeTypedArray(activities, parcelableFlags | Parcelable.PARCELABLE_ELIDE_DUPLICATES); dest.writeTypedArray(receivers, parcelableFlags | Parcelable.PARCELABLE_ELIDE_DUPLICATES); dest.writeTypedArray(services, parcelableFlags | Parcelable.PARCELABLE_ELIDE_DUPLICATES); dest.writeTypedArray(providers, parcelableFlags | Parcelable.PARCELABLE_ELIDE_DUPLICATES); dest.writeTypedArray(instrumentation, parcelableFlags); dest.writeTypedArray(permissions, parcelableFlags); dest.writeStringArray(requestedPermissions); dest.writeIntArray(requestedPermissionsFlags); dest.writeTypedArray(signatures, parcelableFlags); dest.writeTypedArray(configPreferences, parcelableFlags); dest.writeTypedArray(reqFeatures, parcelableFlags); dest.writeTypedArray(featureGroups, parcelableFlags); dest.writeInt(installLocation); dest.writeInt(isStub ? 1 : 0); dest.writeInt(coreApp ? 1 : 0); dest.writeInt(requiredForAllUsers ? 1 : 0); dest.writeString(restrictedAccountType); dest.writeString(requiredAccountType); dest.writeString(overlayTarget); dest.writeString(overlayCategory); dest.writeInt(overlayPriority); dest.writeBoolean(mOverlayIsStatic); dest.writeInt(compileSdkVersion); dest.writeString(compileSdkVersionCodename); if (signingInfo != null) { dest.writeInt(1); signingInfo.writeToParcel(dest, parcelableFlags); } else { dest.writeInt(0); } } public static final Parcelable.Creator<PackageInfo> CREATOR = new Parcelable.Creator<PackageInfo>() { @Override public PackageInfo createFromParcel(Parcel source) { return new PackageInfo(source); } @Override public PackageInfo[] newArray(int size) { return new PackageInfo[size]; } }; private PackageInfo(Parcel source) { packageName = source.readString(); splitNames = source.createStringArray(); versionCode = source.readInt(); versionCodeMajor = source.readInt(); versionName = source.readString(); baseRevisionCode = source.readInt(); splitRevisionCodes = source.createIntArray(); sharedUserId = source.readString(); sharedUserLabel = source.readInt(); int hasApp = source.readInt(); if (hasApp != 0) { applicationInfo = ApplicationInfo.CREATOR.createFromParcel(source); } firstInstallTime = source.readLong(); lastUpdateTime = source.readLong(); gids = source.createIntArray(); activities = source.createTypedArray(ActivityInfo.CREATOR); receivers = source.createTypedArray(ActivityInfo.CREATOR); services = source.createTypedArray(ServiceInfo.CREATOR); providers = source.createTypedArray(ProviderInfo.CREATOR); instrumentation = source.createTypedArray(InstrumentationInfo.CREATOR); permissions = source.createTypedArray(PermissionInfo.CREATOR); requestedPermissions = source.createStringArray(); requestedPermissionsFlags = source.createIntArray(); signatures = source.createTypedArray(Signature.CREATOR); configPreferences = source.createTypedArray(ConfigurationInfo.CREATOR); reqFeatures = source.createTypedArray(FeatureInfo.CREATOR); featureGroups = source.createTypedArray(FeatureGroupInfo.CREATOR); installLocation = source.readInt(); isStub = source.readInt() != 0; coreApp = source.readInt() != 0; requiredForAllUsers = source.readInt() != 0; restrictedAccountType = source.readString(); requiredAccountType = source.readString(); overlayTarget = source.readString(); overlayCategory = source.readString(); overlayPriority = source.readInt(); mOverlayIsStatic = source.readBoolean(); compileSdkVersion = source.readInt(); compileSdkVersionCodename = source.readString(); int hasSigningInfo = source.readInt(); if (hasSigningInfo != 0) { signingInfo = SigningInfo.CREATOR.createFromParcel(source); } // The component lists were flattened with the redundant ApplicationInfo // instances omitted. Distribute the canonical one here as appropriate. if (applicationInfo != null) { propagateApplicationInfo(applicationInfo, activities); propagateApplicationInfo(applicationInfo, receivers); propagateApplicationInfo(applicationInfo, services); propagateApplicationInfo(applicationInfo, providers); } } private void propagateApplicationInfo(ApplicationInfo appInfo, ComponentInfo[] components) { if (components != null) { for (ComponentInfo ci : components) { ci.applicationInfo = appInfo; } } } }