MODE_FULL_INSTALL

public static final int MODE_FULL_INSTALL

Mode for an install session whose staged APKs should fully replace any existing APKs for the target app.

Constant Value: 1 (0x00000001)

MODE_INHERIT_EXISTING

public static final int MODE_INHERIT_EXISTING

Mode for an install session that should inherit any existing APKs for the target app, unless they have been explicitly overridden (based on split name) by the session. For example, this can be used to add one or more split APKs to an existing installation.

If there are no existing APKs for the target app, this behaves like MODE_FULL_INSTALL.

Constant Value: 2 (0x00000002)

PERMISSION_STATE_DEFAULT

public static final int PERMISSION_STATE_DEFAULT

Value is passed by the installer to setPermissionState(java.lang.String, int) to set the state of a permission. This indicates no preference by the installer, relying on the device's default policy to set the grant state of the permission.

Constant Value: 0 (0x00000000)

PERMISSION_STATE_DENIED

public static final int PERMISSION_STATE_DENIED

Value is passed by the installer to setPermissionState(java.lang.String, int) to set the state of a permission. This indicates the installers wants to deny the permission by default to the package being installed. The user and other actors in the system may still be able to grant the permission after installation.

Constant Value: 2 (0x00000002)

PERMISSION_STATE_GRANTED

public static final int PERMISSION_STATE_GRANTED

Value is passed by the installer to setPermissionState(java.lang.String, int) to set the state of a permission. This indicates the installers wants to automatically grant the permission to the package being installed. The user and other actors in the system may still be able to deny the permission after installation.

Constant Value: 1 (0x00000001)

USER_ACTION_NOT_REQUIRED

public static final int USER_ACTION_NOT_REQUIRED

This value is passed by the installer to SessionParams.setRequireUserAction(int) to indicate that user action is not required for this install.

Constant Value: 2 (0x00000002)

USER_ACTION_REQUIRED

public static final int USER_ACTION_REQUIRED

This value is passed by the installer to SessionParams.setRequireUserAction(int) to indicate that user action is required for this install.

Constant Value: 1 (0x00000001)

RESTRICTED_PERMISSIONS_ALL

public static final Set<String> RESTRICTED_PERMISSIONS_ALL

Special constant to refer to all restricted permissions.

SessionParams

public SessionParams (int mode)

Construct parameters for a new package install session.

describeContents

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.

setAppIcon

public void setAppIcon (Bitmap appIcon)

Optionally set an icon representing the app being installed. This should be roughly ActivityManager.getLauncherLargeIconSize() in both dimensions.

setAppLabel

public void setAppLabel (CharSequence appLabel)

Optionally set a label representing the app being installed. This value will be trimmed to the first 1000 characters.

setAppPackageName

public void setAppPackageName (String appPackageName)

Optionally set the package name of the app being installed. It's strongly recommended that you provide this value when known, so that observers can communicate installing apps to users.

If the APKs staged in the session aren't consistent with this package name, the install will fail. Regardless of this value, all APKs in the app must have the same package name.

setApplicationEnabledSettingPersistent

public void setApplicationEnabledSettingPersistent ()

Request to keep the original application enabled setting. This will prevent the application from being enabled if it was previously in a disabled state.

setAutoInstallDependenciesEnabled

public void setAutoInstallDependenciesEnabled (boolean enableAutoInstallDependencies)

This method is deprecated.
The automatic dependency installation feature is no longer supported.

Optionally indicate whether missing SDK or static shared library dependencies should be automatically fetched and installed when installing an app that wants to use these dependencies.

This feature is enabled by default. Note that in the case of a multi-package installation session, no dependencies will be automatically installed even if this field is set to true.

setAutoRevokePermissionsMode

public void setAutoRevokePermissionsMode (boolean shouldAutoRevoke)

This method was deprecated in API level 31.
No longer used

Sets whether permissions should be auto-revoked if this package is unused for an extended periodd of time. It's disabled by default but generally the installer should enable it for most packages, excluding only those where doing so might cause breakage that cannot be easily addressed by simply re-requesting the permission(s). If user explicitly enabled or disabled it via settings, this call is ignored.

setDontKillApp

public void setDontKillApp (boolean dontKillApp)

Requests that the system not kill any of the package's running processes as part of a SessionParams.MODE_INHERIT_EXISTING session in which splits being added. By default, all installs will result in the package's running processes being killed before the install completes.

setExtensionParams

public void setExtensionParams (PersistableBundle extensionParams)

Optionally called to provide a set of parameters to pass directly to the developer verification service provider (a.k.a., the verifier) to provide any additional context regarding the pending verification. The structure of this bundle will be specific to the implementation of the verifier, so callers can determine the verifier by calling PackageInstaller.getDeveloperVerificationServiceProvider().

setInstallerPackageName

public void setInstallerPackageName (String installerPackageName)

Set the installer package for the app. By default this is the app that created the PackageInstaller object. Note: Only applications with Manifest.permission.INSTALL_PACKAGES permission are allowed to set an installer that is not the caller's own installer package name, otherwise it will cause a SecurityException when creating the install session.

setMultiPackage

public void setMultiPackage ()

Set this session to be the parent of a multi-package install. A multi-package install session contains no APKs and only references other install sessions via ID. When a multi-package session is committed, all of its children are committed to the system in an atomic manner. If any children fail to install, all of them do, including the multi-package session.

setOriginatingUid

public void setOriginatingUid (int originatingUid)

Sets the UID that initiated the package installation. This is informational and may be used as a signal for anti-malware purposes.

setOriginatingUri

public void setOriginatingUri (Uri originatingUri)

Optionally set the URI where this package was downloaded from. This is informational and may be used as a signal for anti-malware purposes.

setReferrerUri

public void setReferrerUri (Uri referrerUri)

Optionally set the URI that referred you to install this package. This is informational and may be used as a signal for anti-malware purposes.

setRequestUpdateOwnership

public void setRequestUpdateOwnership (boolean enable)

Optionally indicate whether the package being installed needs the update ownership enforcement. Once the update ownership enforcement is enabled, the other installers will need the user action to update the package even if the installers have been granted the INSTALL_PACKAGES permission. Default to false. The update ownership enforcement can only be enabled on initial installation. Set this to true on package update is a no-op. Note: To enable the update ownership enforcement, the installer must have the ENFORCE_UPDATE_OWNERSHIP permission.
Requires Manifest.permission.ENFORCE_UPDATE_OWNERSHIP

setSize

public void setSize (long sizeBytes)

Optionally indicate the total size (in bytes) of all APKs that will be delivered in this session. The system may use this to ensure enough disk space exists before proceeding, or to estimate container size for installations living on external storage.

setUnarchiveId

public void setUnarchiveId (int unarchiveId)

Used to set the unarchive ID received as part of an Intent.ACTION_UNARCHIVE_PACKAGE.

The ID should be retrieved from the unarchive intent and passed into the session that's being created to unarchive the app in question. Used to link the unarchive intent and the install session to disambiguate.

setWhitelistedRestrictedPermissions

public void setWhitelistedRestrictedPermissions (Set<String> permissions)

Sets which restricted permissions to be allowlisted for the app. Allowlisting is not granting the permissions, rather it allows the app to hold permissions which are otherwise restricted. Allowlisting a non restricted permission has no effect.

Permissions can be hard restricted which means that the app cannot hold them or soft restricted where the app can hold the permission but in a weaker form. Whether a permission is hard restricted or soft restricted depends on the permission declaration. Allowlisting a hard restricted permission allows the app to hold that permission and allowlisting a soft restricted permission allows the app to hold the permission in its full, unrestricted form.

Permissions can also be immutably restricted which means that the allowlist state of the permission can be determined only at install time and cannot be changed on updated or at a later point via the package manager APIs.

Initially, all restricted permissions are allowlisted but you can change which ones are allowlisted by calling this method or the corresponding ones on the PackageManager. Only soft or hard restricted permissions on the current Android version are supported and any invalid entries will be removed.