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

Commit 8b2f6ecf authored by Thomas Vannet's avatar Thomas Vannet
Browse files

Update self-revocation doc: revoke by permission, not group 

Test: None, this is just a doc update
Bug: 210387494
Change-Id: Ib6555c9c419e2f5b890d31c249f09207632d7724
parent 9346e533

core/java/android/content/Context.java

+16 −5
Original line number Diff line number Diff line
@@ -6504,15 +6504,26 @@ public abstract class Context { 
     * <li>Each permission in {@code permissions} must be a runtime permission.

     * </ul>

     * <p>

     * For every permission in {@code permissions}, the entire permission group it belongs to will

     * be revoked. The revocation happens asynchronously and kills all processes running in the

     * calling UID. It will be triggered once it is safe to do so. In particular, it will not be

     * triggered as long as the package remains in the foreground, or has any active manifest

     * components (e.g. when another app is accessing a content provider in the package).

     * Background permissions which have no corresponding foreground permission still granted once

     * the revocation is effective will also be revoked.

     * <p>

     * The revocation happens asynchronously and kills all processes running in the calling UID. It

     * will be triggered once it is safe to do so. In particular, it will not be triggered as long

     * as the package remains in the foreground, or has any active manifest components (e.g. when

     * another app is accessing a content provider in the package).

     * <p>

     * If you want to revoke the permissions right away, you could call {@code System.exit()}, but

     * this could affect other apps that are accessing your app at the moment. For example, apps

     * accessing a content provider in your app will all crash.

     * <p>

     * Note that the settings UI shows a permission group as granted as long as at least one

     * permission in the group is granted. If you want the user to observe the revocation in the

     * settings, you should revoke every permission in the target group. To learn the current list

     * of permissions in a group, you may use

     * {@link PackageManager#getGroupOfPlatformPermission(String, Executor, Consumer)} and

     * {@link PackageManager#getPlatformPermissionsForGroup(String, Executor, Consumer)}. This list

     * of permissions may evolve over time, so it is recommended to check whether it contains any

     * permission you wish to retain before trying to revoke an entire group.

     *

     * @param permissions Collection of permissions to be revoked.

     * @see PackageManager#getGroupOfPlatformPermission(String, Executor, Consumer)

core/java/android/permission/PermissionControllerManager.java

+5 −3
Original line number Diff line number Diff line
@@ -907,9 +907,11 @@ public final class PermissionControllerManager { 
     * <li>Each permission in {@code permissions} must be a runtime permission.

     * </ul>

     * <p>

     * For every permission in {@code permissions}, the entire permission group it belongs to will

     * be revoked. This revocation happens asynchronously and kills all processes running in the

     * same UID as {@code packageName}. It will be triggered once it is safe to do so.

     * Background permissions which have no corresponding foreground permission still granted once

     * the revocation is effective will also be revoked.

     * <p>

     * This revocation happens asynchronously and kills all processes running in the same UID as

     * {@code packageName}. It will be triggered once it is safe to do so.

     *

     * @param packageName The name of the package for which the permissions will be revoked.

     * @param permissions List of permissions to be revoked.

core/java/android/permission/PermissionControllerService.java

+5 −3
Original line number Diff line number Diff line
@@ -329,9 +329,11 @@ public abstract class PermissionControllerService extends Service { 
     * Triggers the revocation of one or more permissions for a package. This should only be called

     * at the request of {@code packageName}.

     * <p>

     * For every permission in {@code permissions}, the entire permission group it belongs to will

     * be revoked. This revocation happens asynchronously and kills all processes running in the

     * same UID as {@code packageName}. It will be triggered once it is safe to do so.

     * Background permissions which have no corresponding foreground permission still granted once

     * the revocation is effective will also be revoked.

     * <p>

     * This revocation happens asynchronously and kills all processes running in the same UID as

     * {@code packageName}. It will be triggered once it is safe to do so.

     *

     * @param packageName The name of the package for which the permissions will be revoked.

     * @param permissions List of permissions to be revoked.

services/core/java/com/android/server/pm/permission/PermissionManagerServiceInterface.java

+5 −3
Original line number Diff line number Diff line
@@ -337,9 +337,11 @@ public interface PermissionManagerServiceInterface extends PermissionManagerInte 
     * <li>Each permission in {@code permissions} must be a runtime permission.

     * </ul>

     * <p>

     * For every permission in {@code permissions}, the entire permission group it belongs to will

     * be revoked. This revocation happens asynchronously and kills all processes running in the

     * same UID as {@code packageName}. It will be triggered once it is safe to do so.

     * Background permissions which have no corresponding foreground permission still granted once

     * the revocation is effective will also be revoked.

     * <p>

     * This revocation happens asynchronously and kills all processes running in the same UID as

     * {@code packageName}. It will be triggered once it is safe to do so.

     *

     * @param packageName The name of the package for which the permissions will be revoked.

     * @param permissions List of permissions to be revoked.