Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit a49ce9ca authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Automerger Merge Worker
Browse files

Merge "Fix links in setRequireUserAction docs" into sc-dev am: f43a7b8d 

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/14921913

Change-Id: Ica81befe8403ae7ab4cdd6c6e1a316ee1c823fa5
parents 1f633a88 f43a7b8d

core/java/android/content/pm/PackageInstaller.java

+13 −13
Original line number Diff line number Diff line
@@ -2111,28 +2111,28 @@ public class PackageInstaller { 
         * <p>

         * Defaults to {@link #USER_ACTION_UNSPECIFIED} unless otherwise set. When unspecified for

         * installers using the

         * {@link android.Manifest.permission#REQUEST_INSTALL_PACKAGES android.permission

         * #REQUEST_INSTALL_PACKAGES} permission will behave as if set to

         * {@link #USER_ACTION_REQUIRED}, and {@link #USER_ACTION_NOT_REQUIRED} otherwise.

         * When {@code requireUserAction} is set to {@link #USER_ACTION_REQUIRED}, installers will

         * receive a {@link #STATUS_PENDING_USER_ACTION} callback once the session is committed,

         * indicating that user action is required for the install to proceed.

         * {@link android.Manifest.permission#REQUEST_INSTALL_PACKAGES REQUEST_INSTALL_PACKAGES}

         * permission will behave as if set to {@link #USER_ACTION_REQUIRED}, and

         * {@link #USER_ACTION_NOT_REQUIRED} otherwise. When {@code requireUserAction} is set to

         * {@link #USER_ACTION_REQUIRED}, installers will receive a

         * {@link #STATUS_PENDING_USER_ACTION} callback once the session is committed, indicating

         * that user action is required for the install to proceed.

         * <p>

         * For installers that have been granted the

         * {@link android.Manifest.permission#REQUEST_INSTALL_PACKAGES android.permission

         * .REQUEST_INSTALL_PACKAGES} permission, user action will not be required when all of

         * the following conditions are met:

         * {@link android.Manifest.permission#REQUEST_INSTALL_PACKAGES REQUEST_INSTALL_PACKAGES}

         * permission, user action will not be required when all of the following conditions are

         * met:

         *

         * <ul>

         *     <li>{@code requireUserAction} is set to {@link #USER_ACTION_NOT_REQUIRED}.</li>

         *     <li>The app being installed targets {@link android.os.Build.VERSION_CODES#Q API 29}

         *     or higher.</li>

         *     <li>The installer is the {@link InstallSourceInfo#getInstallingPackageName()

         *     installer of record} of an existing version of the app (i.e.: this install session

         *     is an app update) or the installer is updating itself.</li>

         *     installer of record} of an existing version of the app (in other words, this install

         *     session is an app update) or the installer is updating itself.</li>

         *     <li>The installer declares the

         *     {@link android.Manifest.permission#UPDATE_PACKAGES_WITHOUT_USER_ACTION android

         *     .permission.UPDATE_PACKAGES_WITHOUT_USER_ACTION} permission.</li>

         *     {@link android.Manifest.permission#UPDATE_PACKAGES_WITHOUT_USER_ACTION

         *     UPDATE_PACKAGES_WITHOUT_USER_ACTION} permission.</li>

         * </ul>

         * <p>

         * Note: The target API level requirement will advance in future Android versions.