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

Commit 6523feee authored by Song Chun Fan's avatar Song Chun Fan
Browse files

[ADI][36/N] update javadoc for EXTRA_DEVELOPER_VERIFICATION_FAILURE_REASON 

Updating the API levels and adding links.

Test: n/a just javadoc change
BUG: 360129657
FLAG: android.content.pm.verification_service
Change-Id: I0e1b9fa1b68aad132882c52be5b8568ca9df53a5
parent 65105889

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

+8 −3
Original line number Diff line number Diff line
@@ -452,7 +452,9 @@ public class PackageInstaller { 
     * receive different status codes from {@link #EXTRA_STATUS} depending on their target SDK and

     * privileged status:

     * <p>

     *      Non-privileged installers targeting 36 or less will first receive the

     *      Non-privileged installers targeting

     *      {@link android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM API 35}

     *      or less will first receive the

     *      {@link #STATUS_PENDING_USER_ACTION} status code without this reason code. They will be

     *      forced through the user action flow to allow the OS to inform the user of such

     *      verification context before continuing to fail the install. If the user has the option
@@ -461,14 +463,17 @@ public class PackageInstaller { 
     *      along with this reason code that explains why the verification had failed.

     * </p>

     * <p>

     *     Privileged installer targeting 36 or less will directly receive the

     *     Privileged installer targeting

     *     {@link android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM API 35}

     *     or less will directly receive the

     *     {@link #STATUS_FAILURE_ABORTED} status code. This is because they are not expected to

     *     have the capability of handling the {@link #STATUS_PENDING_USER_ACTION} flow, so the

     *     installation will directly fail. This reason code will be supplied to them for

     *     providing additional information.

     * </p>

     * <p>

     *     All installers targeting 37 and higher will receive a {@link #STATUS_FAILURE_ABORTED}

     *     All installers targeting {@link android.os.Build.VERSION_CODES#BAKLAVA API 36}

     *     or higher will receive a {@link #STATUS_FAILURE_ABORTED}

     *     status code along with this reason code, so the installers can explain the failure to the

     *     user accordingly. An {@link Intent#EXTRA_INTENT} will also be populated with an intent

     *     that can provide additional context where appropriate, should the installer prefer to