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

Commit 14d070e9 authored by George Chan's avatar George Chan
Browse files

Added push API and System API client for BackgroundInstallControlService 

and added permission restriction to service APIs.

Bug: 296060433
Test: atest BackgroundInstallControlServiceHostTest
 BackgroundInstallControlServiceTest
 BackgroundInstallControlCallbackHelperTest
 CtsBackgroundInstallControlManagerTestCases
 CtsBackgroundInstallControlManagerNoPermissionsTestCases

Change-Id: I248ee1e6a95e6eb9995c4dfb688a9903387f2e48
parent 65732901

core/api/system-current.txt

+12 −0
Original line number Diff line number Diff line
@@ -853,6 +853,18 @@ package android.app { 
    field @NonNull public static final android.os.Parcelable.Creator<android.app.AppOpsManager.PackageOps> CREATOR;

  }













  @FlaggedApi("android.app.bic_client") public final class BackgroundInstallControlManager {













    method @FlaggedApi("android.app.bic_client") @NonNull @RequiresPermission(allOf={android.Manifest.permission.QUERY_ALL_PACKAGES, android.Manifest.permission.INTERACT_ACROSS_USERS_FULL}) public java.util.List<android.content.pm.PackageInfo> getBackgroundInstalledPackages(long);













    method @FlaggedApi("android.app.bic_client") @RequiresPermission(allOf={android.Manifest.permission.QUERY_ALL_PACKAGES, android.Manifest.permission.INTERACT_ACROSS_USERS_FULL}) public void registerBackgroundInstallCallback(@NonNull java.util.concurrent.Executor, @NonNull java.util.function.Consumer<android.app.BackgroundInstallControlManager.InstallEvent>);













    method @FlaggedApi("android.app.bic_client") @RequiresPermission(allOf={android.Manifest.permission.QUERY_ALL_PACKAGES, android.Manifest.permission.INTERACT_ACROSS_USERS_FULL}) public void unregisterBackgroundInstallCallback(@NonNull java.util.function.Consumer<android.app.BackgroundInstallControlManager.InstallEvent>);













  }

























  public static final class BackgroundInstallControlManager.InstallEvent {













    ctor public BackgroundInstallControlManager.InstallEvent(@NonNull int, @NonNull String);













    method @NonNull public String getPackageName();













    method @NonNull public int getUserId();













  }



























  public class BroadcastOptions {















    method public void clearRequireCompatChange();















    method public int getPendingIntentBackgroundActivityStartMode();

























core/java/android/app/BackgroundInstallControlManager.java
0 → 100644



+227
−0




























Original line number
Diff line number
Diff line













/*













 * Copyright (C) 2023 The Android Open Source Project













 *













 * Licensed under the Apache License, Version 2.0 (the "License");













 * you may not use this file except in compliance with the License.













 * You may obtain a copy of the License at













 *













 *      http://www.apache.org/licenses/LICENSE-2.0













 *













 * Unless required by applicable law or agreed to in writing, software













 * distributed under the License is distributed on an "AS IS" BASIS,













 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.













 * See the License for the specific language governing permissions and













 * limitations under the License.













 */



























package android.app;



























import static android.Manifest.permission.INTERACT_ACROSS_USERS_FULL;













import static android.Manifest.permission.QUERY_ALL_PACKAGES;













import static android.annotation.SystemApi.Client.PRIVILEGED_APPS;



























import android.annotation.CallbackExecutor;













import android.annotation.FlaggedApi;













import android.annotation.NonNull;













import android.annotation.RequiresPermission;













import android.annotation.SystemApi;













import android.annotation.SystemService;













import android.content.Context;













import android.content.pm.IBackgroundInstallControlService;













import android.content.pm.PackageInfo;













import android.content.pm.PackageManager;













import android.os.Bundle;













import android.os.IRemoteCallback;













import android.os.ServiceManager;



























import java.util.ArrayList;













import java.util.Iterator;













import java.util.List;













import java.util.concurrent.Executor;













import java.util.function.Consumer;



























/**













 * BackgroundInstallControlManager client allows apps to query apps installed in background.













 *













 * <p>Apps are considered to be installed in background is determined by analysis of user-activity













 * logs. Any applications that was installed without an accompanying installer UI activity paired













 * with recorded user interaction event is considered background installed.













 *













 * <p>Warning: BackgroundInstallControl should not be considered a reliable or accurate













 * determination of background install application. Consumers can use this as a supplementary













 * signal, but must perform additional due diligence to confirm the install nature of the package.













 *













 * @hide













 */













@FlaggedApi(Flags.FLAG_BIC_CLIENT)













@SystemApi(client = PRIVILEGED_APPS)













@SystemService(Context.BACKGROUND_INSTALL_CONTROL_SERVICE)













public final class BackgroundInstallControlManager {



























    private static final String TAG = "BackgroundInstallControlManager";













    private static IBackgroundInstallControlService sService;













    private static ArrayList<CallbackDelegate> sRegisteredDelegates = new ArrayList<>();



























    private final Context mContext;



























    BackgroundInstallControlManager(Context context) {













        mContext = context;













    }



























    private static IBackgroundInstallControlService getService() {













        if (sService == null) {













            sService =













                    IBackgroundInstallControlService.Stub.asInterface(













                            ServiceManager.getService(Context.BACKGROUND_INSTALL_CONTROL_SERVICE));













        }













        return sService;













    }



























    /**













     * Returns a list of {@link PackageInfo} that are considered installed in the background.













     *













     * <p>Refer to top level doc {@link BackgroundInstallControlManager} for more details on













     * background-installed applications.













     *













     * @hide













     */













    @FlaggedApi(Flags.FLAG_BIC_CLIENT)













    @SystemApi













    @RequiresPermission(allOf = {QUERY_ALL_PACKAGES, INTERACT_ACROSS_USERS_FULL})













    public @NonNull List<PackageInfo> getBackgroundInstalledPackages(













            @PackageManager.PackageInfoFlagsBits long flags) {













        try {













            return getService()













                    .getBackgroundInstalledPackages(flags, mContext.getUserId())













                    .getList();













        } catch (SecurityException e) {













            throw e;













        } catch (Exception e) {













            throw new RuntimeException(e);













        }













    }



























    /**













     * Registers user supplied callback function for invocation in the event of an app installed in













     * the background.













     *













     * <p>Note: This API does not back-propagate events prior to successful registration. If client













     * is looking for historical background installs, use getBackgroundInstalledPackages retrieve













     * those records.













     *













     * <p>Relevant event details passed back to callback via {@link InstallEvent} object.













     *













     * @hide













     */













    @FlaggedApi(Flags.FLAG_BIC_CLIENT)













    @SystemApi













    @RequiresPermission(allOf = {QUERY_ALL_PACKAGES, INTERACT_ACROSS_USERS_FULL})













    public void registerBackgroundInstallCallback(













            @NonNull @CallbackExecutor Executor executor,













            @NonNull Consumer<InstallEvent> callback) {













        CallbackDelegate delegate = new CallbackDelegate(executor, callback);













        try {













            getService().registerBackgroundInstallCallback(delegate.mBicCallback);













            sRegisteredDelegates.add(delegate);













        } catch (SecurityException e) {













            throw e;













        } catch (Exception e) {













            throw new RuntimeException(e);













        }













    }



























    /** Unregisters the provided callback from {@link BackgroundInstallControlManager}.













     *













     * @hide













     */













    @FlaggedApi(Flags.FLAG_BIC_CLIENT)













    @SystemApi













    @RequiresPermission(allOf = {QUERY_ALL_PACKAGES, INTERACT_ACROSS_USERS_FULL})













    public void unregisterBackgroundInstallCallback(@NonNull Consumer<InstallEvent> callback) {













        try {













            Iterator<CallbackDelegate> it = sRegisteredDelegates.iterator();













            CallbackDelegate delegate;













            while (it.hasNext()) {













                delegate = it.next();













                if (delegate.mCallback.equals(callback)) {













                    getService().unregisterBackgroundInstallCallback(delegate.mBicCallback);













                    it.remove();













                    return;













                }













            }













        } catch (SecurityException e) {













            throw e;













        } catch (Exception e) {













            throw new RuntimeException(e);













        }













    }



























    /**













     * Passed-in parameter for BackgroundInstallControlManager callbacks.













     *













     * <p>User provided callbacks access to relevant info of the install event is access through













     * this class.













     */













    public static final class InstallEvent {













        @NonNull private String mPackageName;



























        @NonNull private int mUserId;



























        /**













         * Constructor for InstallEvent parameter. Used and instantiated by CallbackDelegate to pass













         * into user provided callback.













         *













         * @param packageName - package name of the background installed app.













         * @param userId - ID of user the package was installed for.













         */













        public InstallEvent(@NonNull int userId, @NonNull String packageName) {













            mUserId = userId;













            mPackageName = packageName;













        }



























        /**













         * Getter for package name of the background installed app.













         *













         * @return packageName













         */













        @NonNull













        public String getPackageName() {













            return mPackageName;













        }



























        /**













         * Getter for user ID the app was installed for.













         *













         * @return userId













         */













        @NonNull













        public int getUserId() {













            return mUserId;













        }













    }



























    private static class CallbackDelegate {













        static final String FLAGGED_PACKAGE_NAME_KEY = "packageName";













        static final String FLAGGED_USER_ID_KEY = "userId";













        final Executor mExecutor;













        final Consumer<InstallEvent> mCallback;













        final IRemoteCallback mBicCallback =













                new IRemoteCallback.Stub() {













                    @Override













                    public void sendResult(Bundle extras) {













                        mExecutor.execute(













                                () ->













                                        mCallback.accept(













                                                new InstallEvent(













                                                        extras.getInt(FLAGGED_USER_ID_KEY),













                                                        extras.getString(













                                                                FLAGGED_PACKAGE_NAME_KEY))));













                    }













                };



























        CallbackDelegate(Executor executor, Consumer<InstallEvent> callback) {













            mExecutor = executor;













            mCallback = callback;













        }













    }













}
























core/java/android/app/OWNERS



+4
−0




























Original line number
Diff line number
Diff line








@@ -84,6 +84,10 @@ per-file IEphemeralResolver.aidl = file:/services/core/java/com/android/server/p













per-file IInstantAppResolver.aidl = file:/services/core/java/com/android/server/pm/OWNERS















per-file InstantAppResolveInfo.aidl = file:/services/core/java/com/android/server/pm/OWNERS





























# BackgroundInstallControlManager













per-file BackgroundInstallControlManager.java = file:/services/core/java/com/android/server/pm/OWNERS













per-file background_install_control_manager.aconfig = file:/services/core/java/com/android/server/pm/OWNERS





























# ResourcesManager















per-file ResourcesManager.java = file:RESOURCES_OWNERS

















































core/java/android/app/SystemServiceRegistry.java



+9
−0




























Original line number
Diff line number
Diff line








@@ -1571,6 +1571,15 @@ public final class SystemServiceRegistry {













                    }















                });





























        registerService(Context.BACKGROUND_INSTALL_CONTROL_SERVICE,













                BackgroundInstallControlManager.class,













                new CachedServiceFetcher<BackgroundInstallControlManager>() {













                    @Override













                    public BackgroundInstallControlManager createService(ContextImpl ctx) {













                        return new BackgroundInstallControlManager(ctx);













                    }













                });





























        sInitializing = true;















        try {















            // Note: the following functions need to be @SystemApis, once they become mainline

































core/java/android/app/background_install_control_manager.aconfig
0 → 100644



+8
−0




























Original line number
Diff line number
Diff line













package: "android.app"



























flag {













     namespace: "background_install_control"













     name: "bic_client"













     description: "System API for background install control."













     bug: "287507984"













}