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

Commit c8c3e89d authored by Alex Johnston's avatar Alex Johnston Committed by Automerger Merge Worker
Browse files

Merge "Revert "Revert "Cherrypicking flags and override methods for all..."" am: 5c35d3bc 

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

Change-Id: I90e8a4d567fe2de9ab765806fc7bd3aba4fe0845
parents e18c4d7d 5c35d3bc

core/api/current.txt

+2 −0
Original line number Diff line number Diff line
@@ -10687,6 +10687,8 @@ package android.content { 
    field public static final String PERFORMANCE_HINT_SERVICE = "performance_hint";

    field public static final String POWER_SERVICE = "power";

    field public static final String PRINT_SERVICE = "print";

    field public static final int RECEIVER_EXPORTED = 2; // 0x2

    field public static final int RECEIVER_NOT_EXPORTED = 4; // 0x4

    field public static final int RECEIVER_VISIBLE_TO_INSTANT_APPS = 1; // 0x1

    field public static final String RESTRICTIONS_SERVICE = "restrictions";

    field public static final String ROLE_SERVICE = "role";

core/api/system-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -2340,6 +2340,7 @@ package android.content { 
    method @Nullable public abstract java.io.File getPreloadsFileCache();

    method public abstract boolean isCredentialProtectedStorage();

    method @Nullable @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL) public android.content.Intent registerReceiverForAllUsers(@Nullable android.content.BroadcastReceiver, @NonNull android.content.IntentFilter, @Nullable String, @Nullable android.os.Handler);

    method @Nullable @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL) public android.content.Intent registerReceiverForAllUsers(@Nullable android.content.BroadcastReceiver, @NonNull android.content.IntentFilter, @Nullable String, @Nullable android.os.Handler, int);

    method public abstract void sendBroadcast(android.content.Intent, @Nullable String, @Nullable android.os.Bundle);

    method @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS) public abstract void sendBroadcastAsUser(@RequiresPermission android.content.Intent, android.os.UserHandle, @Nullable String, @Nullable android.os.Bundle);

    method public abstract void sendOrderedBroadcast(@NonNull android.content.Intent, @Nullable String, @Nullable android.os.Bundle, @Nullable android.content.BroadcastReceiver, @Nullable android.os.Handler, int, @Nullable String, @Nullable android.os.Bundle);

core/java/android/app/ContextImpl.java

+14 −0
Original line number Diff line number Diff line
@@ -1738,6 +1738,13 @@ class ContextImpl extends Context { 
                filter, broadcastPermission, scheduler);

    }



    @Override

    public Intent registerReceiverForAllUsers(BroadcastReceiver receiver,

            IntentFilter filter, String broadcastPermission, Handler scheduler, int flags) {

        return registerReceiverAsUser(receiver, UserHandle.ALL,

                filter, broadcastPermission, scheduler, flags);

    }



    @Override

    public Intent registerReceiverAsUser(BroadcastReceiver receiver, UserHandle user,

            IntentFilter filter, String broadcastPermission, Handler scheduler) {
@@ -1745,6 +1752,13 @@ class ContextImpl extends Context { 
                filter, broadcastPermission, scheduler, getOuterContext(), 0);

    }



    @Override

    public Intent registerReceiverAsUser(BroadcastReceiver receiver, UserHandle user,

            IntentFilter filter, String broadcastPermission, Handler scheduler, int flags) {

        return registerReceiverInternal(receiver, user.getIdentifier(),

                filter, broadcastPermission, scheduler, getOuterContext(), flags);

    }



    private Intent registerReceiverInternal(BroadcastReceiver receiver, int userId,

            IntentFilter filter, String broadcastPermission,

            Handler scheduler, Context context, int flags) {

core/java/android/content/Context.java

+97 −6
Original line number Diff line number Diff line
@@ -534,8 +534,8 @@ public abstract class Context { 
                    | Context.BIND_NOT_PERCEPTIBLE | Context.BIND_NOT_VISIBLE;



    /** @hide */

    @IntDef(flag = true, prefix = { "RECEIVER_VISIBLE_" }, value = {

            RECEIVER_VISIBLE_TO_INSTANT_APPS

    @IntDef(flag = true, prefix = { "RECEIVER_VISIBLE" }, value = {

            RECEIVER_VISIBLE_TO_INSTANT_APPS, RECEIVER_EXPORTED, RECEIVER_NOT_EXPORTED

    })

    @Retention(RetentionPolicy.SOURCE)

    public @interface RegisterReceiverFlags {}
@@ -545,6 +545,18 @@ public abstract class Context { 
     */

    public static final int RECEIVER_VISIBLE_TO_INSTANT_APPS = 0x1;



    /**

     * Flag for {@link #registerReceiver}: The receiver can receive broadcasts from other Apps.

     * Has the same behavior as marking a statically registered receiver with "exported=true"

     */

    public static final int RECEIVER_EXPORTED = 0x2;



    /**

     * Flag for {@link #registerReceiver}: The receiver cannot receive broadcasts from other Apps.

     * Has the same behavior as marking a statically registered receiver with "exported=false"

     */

    public static final int RECEIVER_NOT_EXPORTED = 0x4;



    /**

     * Returns an AssetManager instance for the application's package.

     * <p>
@@ -2989,8 +3001,12 @@ public abstract class Context { 
     *

     * @param receiver The BroadcastReceiver to handle the broadcast.

     * @param filter Selects the Intent broadcasts to be received.

     * @param flags Additional options for the receiver. May be 0 or

     *      {@link #RECEIVER_VISIBLE_TO_INSTANT_APPS}.

     * @param flags Additional options for the receiver. As of

     * {@link android.os.Build.VERSION_CODES#TIRAMISU}, either {@link #RECEIVER_EXPORTED} or

     * {@link #RECEIVER_NOT_EXPORTED} must be specified if the receiver isn't being registered

     *            for protected broadcasts, and may additionally specify

     *            {@link #RECEIVER_VISIBLE_TO_INSTANT_APPS} if {@link #RECEIVER_EXPORTED} is

     *            specified.

     *

     * @return The first sticky intent found that matches <var>filter</var>,

     *         or null if there are none.
@@ -3062,8 +3078,12 @@ public abstract class Context { 
     *      no permission is required.

     * @param scheduler Handler identifying the thread that will receive

     *      the Intent.  If null, the main thread of the process will be used.

     * @param flags Additional options for the receiver. May be 0 or

     *      {@link #RECEIVER_VISIBLE_TO_INSTANT_APPS}.

     * @param flags Additional options for the receiver. As of

     * {@link android.os.Build.VERSION_CODES#TIRAMISU}, either {@link #RECEIVER_EXPORTED} or

     * {@link #RECEIVER_NOT_EXPORTED} must be specified if the receiver isn't being registered

     *            for protected broadcasts, and may additionally specify

     *            {@link #RECEIVER_VISIBLE_TO_INSTANT_APPS} if {@link #RECEIVER_EXPORTED} is

     *            specified.

     *

     * @return The first sticky intent found that matches <var>filter</var>,

     *         or null if there are none.
@@ -3109,6 +3129,42 @@ public abstract class Context { 
        throw new RuntimeException("Not implemented. Must override in a subclass.");

    }



    /**

     * Same as {@link #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int)}

     * but this receiver will receive broadcasts that are sent to all users. The receiver can

     * use {@link BroadcastReceiver#getSendingUser} to determine on which user the broadcast

     * was sent.

     *

     * @param receiver The BroadcastReceiver to handle the broadcast.

     * @param filter Selects the Intent broadcasts to be received.

     * @param broadcastPermission String naming a permissions that a

     *      broadcaster must hold in order to send an Intent to you. If {@code null},

     *      no permission is required.

     * @param scheduler Handler identifying the thread that will receive

     *      the Intent. If {@code null}, the main thread of the process will be used.

     * @param flags Additional options for the receiver. As of

     *      {@link android.os.Build.VERSION_CODES#TIRAMISU}, either {@link #RECEIVER_EXPORTED} or

     *      {@link #RECEIVER_NOT_EXPORTED} must be specified if the receiver isn't being

     *      registered for protected broadcasts

     *

     * @return The first sticky intent found that matches <var>filter</var>,

     *         or {@code null} if there are none.

     *

     * @see #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int)

     * @see #sendBroadcast

     * @see #unregisterReceiver

     * @hide

     */

    @SuppressLint("IntentBuilderName")

    @Nullable

    @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL)

    @SystemApi

    public Intent registerReceiverForAllUsers(@Nullable BroadcastReceiver receiver,

            @NonNull IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler, @RegisterReceiverFlags int flags) {

        throw new RuntimeException("Not implemented. Must override in a subclass.");

    }



    /**

     * @hide

     * Same as {@link #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)
@@ -3139,6 +3195,41 @@ public abstract class Context { 
            UserHandle user, IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler);



    /**

     * @hide

     * Same as {@link #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int)

     * but for a specific user.  This receiver will receiver broadcasts that

     * are sent to the requested user.

     *

     * @param receiver The BroadcastReceiver to handle the broadcast.

     * @param user UserHandle to send the intent to.

     * @param filter Selects the Intent broadcasts to be received.

     * @param broadcastPermission String naming a permissions that a

     *      broadcaster must hold in order to send an Intent to you.  If null,

     *      no permission is required.

     * @param scheduler Handler identifying the thread that will receive

     *      the Intent.  If null, the main thread of the process will be used.

     * @param flags Additional options for the receiver. As of

     *      {@link android.os.Build.VERSION_CODES#TIRAMISU}, either {@link #RECEIVER_EXPORTED} or

     *      {@link #RECEIVER_NOT_EXPORTED} must be specified if the receiver isn't being

     *      registered for protected broadcasts

     *

     * @return The first sticky intent found that matches <var>filter</var>,

     *         or null if there are none.

     *

     * @see #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int)

     * @see #sendBroadcast

     * @see #unregisterReceiver

     */

    @SuppressWarnings("HiddenAbstractMethod")

    @SuppressLint("IntentBuilderName")

    @Nullable

    @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL)

    @UnsupportedAppUsage

    public abstract Intent registerReceiverAsUser(BroadcastReceiver receiver,

            UserHandle user, IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler, @RegisterReceiverFlags int flags);



    /**

     * Unregister a previously registered BroadcastReceiver.  <em>All</em>

     * filters that have been registered for this BroadcastReceiver will be

core/java/android/content/ContextWrapper.java

+23 −3
Original line number Diff line number Diff line
@@ -754,16 +754,36 @@ public class ContextWrapper extends Context { 
                scheduler);

    }



    /** @hide */

    @Override

    @Nullable

    public Intent registerReceiverForAllUsers(@Nullable BroadcastReceiver receiver,

            @NonNull IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler, int flags) {

        return mBase.registerReceiverForAllUsers(receiver, filter, broadcastPermission,

                scheduler, flags);

    }



    /** @hide */

    @Override

    @UnsupportedAppUsage

    public Intent registerReceiverAsUser(

        BroadcastReceiver receiver, UserHandle user, IntentFilter filter,

        String broadcastPermission, Handler scheduler) {

    public Intent registerReceiverAsUser(@Nullable BroadcastReceiver receiver, UserHandle user,

            IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler) {

        return mBase.registerReceiverAsUser(receiver, user, filter, broadcastPermission,

                scheduler);

    }



    /** @hide */

    @Override

    @UnsupportedAppUsage

    public Intent registerReceiverAsUser(@Nullable BroadcastReceiver receiver, UserHandle user,

            IntentFilter filter, @Nullable String broadcastPermission,

            @Nullable Handler scheduler, int flags) {

        return mBase.registerReceiverAsUser(receiver, user, filter, broadcastPermission,

                scheduler, flags);

    }



    @Override

    public void unregisterReceiver(BroadcastReceiver receiver) {

        mBase.unregisterReceiver(receiver);