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

Commit 91fa0b12 authored by Sumedh Sen's avatar Sumedh Sen
Browse files

Expose new APIs required by Package Installer. 

This change contains those constants and methods that were exposed to
@SystemApi or public, with appropriate documentation and permission enforcements.
This allows Package Installer become an updatable module.

Test: atest CtsContentTestCases:PackageManagerTest CtsPackageInstallTestCases:SessionInfoTest CtsPackageInstallTestCases:InstallPromptDetailsTest PackageManagerServiceUnitTests:UninstallCompleteCallbackTest CtsPackageUninstallTestCases
Bug: 241139604
Bug: 239722738
Change-Id: I938d87fc266ff4268aa3fef1cd1405c1598d5ca8
parent 1697a83b

core/api/current.txt

+4 −0
Original line number Diff line number Diff line
@@ -11765,6 +11765,7 @@ package android.content.pm { 
    method public void registerSessionCallback(@NonNull android.content.pm.PackageInstaller.SessionCallback, @NonNull android.os.Handler);

    method @RequiresPermission(anyOf={android.Manifest.permission.DELETE_PACKAGES, android.Manifest.permission.REQUEST_DELETE_PACKAGES}) public void uninstall(@NonNull String, @NonNull android.content.IntentSender);

    method @RequiresPermission(anyOf={android.Manifest.permission.DELETE_PACKAGES, android.Manifest.permission.REQUEST_DELETE_PACKAGES}) public void uninstall(@NonNull android.content.pm.VersionedPackage, @NonNull android.content.IntentSender);

    method @RequiresPermission(anyOf={android.Manifest.permission.DELETE_PACKAGES, android.Manifest.permission.REQUEST_DELETE_PACKAGES}) public void uninstall(@NonNull android.content.pm.VersionedPackage, int, @NonNull android.content.IntentSender);

    method @RequiresPermission(android.Manifest.permission.DELETE_PACKAGES) public void uninstallExistingPackage(@NonNull String, @Nullable android.content.IntentSender);

    method public void unregisterSessionCallback(@NonNull android.content.pm.PackageInstaller.SessionCallback);

    method public void updateSessionAppIcon(int, @Nullable android.graphics.Bitmap);
@@ -11893,6 +11894,8 @@ package android.content.pm { 
    method public int getInstallReason();

    method @Nullable public String getInstallerAttributionTag();

    method @Nullable public String getInstallerPackageName();

    method public int getInstallerUid();

    method @NonNull public boolean getIsPreApprovalRequested();

    method public int getMode();

    method public int getOriginatingUid();

    method @Nullable public android.net.Uri getOriginatingUri();
@@ -11943,6 +11946,7 @@ package android.content.pm { 
    method public void setInstallLocation(int);

    method public void setInstallReason(int);

    method public void setInstallScenario(int);

    method public void setInstallerPackageName(@Nullable String);

    method public void setKeepApplicationEnabledSetting();

    method public void setMultiPackage();

    method public void setOriginatingUid(int);

core/api/system-current.txt

+36 −0
Original line number Diff line number Diff line
@@ -3331,6 +3331,7 @@ package android.content { 
    field public static final String CATEGORY_LEANBACK_SETTINGS = "android.intent.category.LEANBACK_SETTINGS";

    field public static final String EXTRA_CALLING_PACKAGE = "android.intent.extra.CALLING_PACKAGE";

    field public static final String EXTRA_FORCE_FACTORY_RESET = "android.intent.extra.FORCE_FACTORY_RESET";

    field public static final String EXTRA_INSTALL_RESULT = "android.intent.extra.INSTALL_RESULT";

    field public static final String EXTRA_INSTANT_APP_ACTION = "android.intent.extra.INSTANT_APP_ACTION";

    field public static final String EXTRA_INSTANT_APP_BUNDLES = "android.intent.extra.INSTANT_APP_BUNDLES";

    field public static final String EXTRA_INSTANT_APP_EXTRAS = "android.intent.extra.INSTANT_APP_EXTRAS";
@@ -3346,6 +3347,7 @@ package android.content { 
    field public static final String EXTRA_RESULT_NEEDED = "android.intent.extra.RESULT_NEEDED";

    field public static final String EXTRA_ROLE_NAME = "android.intent.extra.ROLE_NAME";

    field public static final String EXTRA_SHOWING_ATTRIBUTION = "android.intent.extra.SHOWING_ATTRIBUTION";

    field public static final String EXTRA_UNINSTALL_ALL_USERS = "android.intent.extra.UNINSTALL_ALL_USERS";

    field public static final String EXTRA_UNKNOWN_INSTANT_APP = "android.intent.extra.UNKNOWN_INSTANT_APP";

    field public static final String EXTRA_USER_HANDLE = "android.intent.extra.user_handle";

    field public static final String EXTRA_VERIFICATION_BUNDLE = "android.intent.extra.VERIFICATION_BUNDLE";
@@ -3452,9 +3454,11 @@ package android.content.om { 
package android.content.pm {















  public class ApplicationInfo extends android.content.pm.PackageItemInfo implements android.os.Parcelable {













    method @RequiresPermission(android.Manifest.permission.DELETE_PACKAGES) public boolean hasFragileUserData();















    method public boolean isEncryptionAware();















    method public boolean isInstantApp();















    method public boolean isOem();













    method @RequiresPermission(android.Manifest.permission.INSTALL_PACKAGES) public boolean isPrivilegedApp();















    method public boolean isProduct();















    method public boolean isVendor();















    field public String credentialProtectedDataDir;










@@ -3572,16 +3576,32 @@ package android.content.pm {













  }





























  public class PackageInstaller {













    method @NonNull public android.content.pm.PackageInstaller.InstallInfo getInstallInfo(@NonNull java.io.File, int) throws android.content.pm.PackageInstaller.PackageParsingException;















    method @RequiresPermission(android.Manifest.permission.INSTALL_PACKAGES) public void setPermissionsResult(int, boolean);













    field public static final String ACTION_CONFIRM_INSTALL = "android.content.pm.action.CONFIRM_INSTALL";













    field public static final String ACTION_CONFIRM_PRE_APPROVAL = "android.content.pm.action.CONFIRM_PRE_APPROVAL";















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















    field public static final int DATA_LOADER_TYPE_NONE = 0; // 0x0















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













    field public static final String EXTRA_CALLBACK = "android.content.pm.extra.CALLBACK";















    field public static final String EXTRA_DATA_LOADER_TYPE = "android.content.pm.extra.DATA_LOADER_TYPE";













    field public static final String EXTRA_LEGACY_STATUS = "android.content.pm.extra.LEGACY_STATUS";













    field public static final String EXTRA_RESOLVED_BASE_PATH = "android.content.pm.extra.RESOLVED_BASE_PATH";















    field public static final int LOCATION_DATA_APP = 0; // 0x0















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















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















  }



























  public static class PackageInstaller.InstallInfo {













    method public long calculateInstalledSize(@NonNull android.content.pm.PackageInstaller.SessionParams) throws java.io.IOException;













    method public int getInstallLocation();













    method @NonNull public String getPackageName();













  }

























  public static class PackageInstaller.PackageParsingException extends java.lang.Exception {













    method public int getErrorCode();













  }



























  public static class PackageInstaller.Session implements java.io.Closeable {















    method @RequiresPermission("com.android.permission.USE_INSTALLER_V2") public void addFile(int, @NonNull String, long, @NonNull byte[], @Nullable byte[]);















    method @RequiresPermission(android.Manifest.permission.INSTALL_PACKAGES) public void commitTransferred(@NonNull android.content.IntentSender);










@@ -3628,6 +3648,7 @@ package android.content.pm {













  public abstract class PackageManager {















    method @RequiresPermission("android.permission.OBSERVE_GRANT_REVOKE_PERMISSIONS") public abstract void addOnPermissionsChangeListener(@NonNull android.content.pm.PackageManager.OnPermissionsChangedListener);















    method public abstract boolean arePermissionsIndividuallyControlled();













    method @NonNull public boolean canUserUninstall(@NonNull String, @NonNull android.os.UserHandle);















    method @NonNull public abstract java.util.List<android.content.IntentFilter> getAllIntentFilters(@NonNull String);















    method @NonNull @RequiresPermission("android.permission.GET_APP_METADATA") public android.os.PersistableBundle getAppMetadata(@NonNull String) throws android.content.pm.PackageManager.NameNotFoundException;















    method @Deprecated @NonNull @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS) public android.content.pm.ApplicationInfo getApplicationInfoAsUser(@NonNull String, int, @NonNull android.os.UserHandle) throws android.content.pm.PackageManager.NameNotFoundException;









@@ -3646,6 +3667,7 @@ package android.content.pm {













    method @NonNull @RequiresPermission(android.Manifest.permission.ACCESS_INSTANT_APPS) public abstract java.util.List<android.content.pm.InstantAppInfo> getInstantApps();















    method @Deprecated @NonNull public abstract java.util.List<android.content.pm.IntentFilterVerificationInfo> getIntentFilterVerifications(@NonNull String);















    method @Deprecated @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL) public abstract int getIntentVerificationStatusAsUser(@NonNull String, int);













    method @RequiresPermission(android.Manifest.permission.INTERACT_ACROSS_USERS_FULL) public int getPackageUidAsUser(@NonNull String, @NonNull android.content.pm.PackageManager.PackageInfoFlags, int) throws android.content.pm.PackageManager.NameNotFoundException;















    method @android.content.pm.PackageManager.PermissionFlags @RequiresPermission(anyOf={android.Manifest.permission.GRANT_RUNTIME_PERMISSIONS, android.Manifest.permission.REVOKE_RUNTIME_PERMISSIONS, android.Manifest.permission.GET_RUNTIME_PERMISSIONS}) public abstract int getPermissionFlags(@NonNull String, @NonNull String, @NonNull android.os.UserHandle);















    method @NonNull @RequiresPermission(android.Manifest.permission.SUSPEND_APPS) public String[] getUnsuspendablePackages(@NonNull String[]);















    method @RequiresPermission(android.Manifest.permission.GRANT_RUNTIME_PERMISSIONS) public abstract void grantRuntimePermission(@NonNull String, @NonNull String, @NonNull android.os.UserHandle);










@@ -3673,11 +3695,19 @@ package android.content.pm {













    method @RequiresPermission(value=android.Manifest.permission.CHANGE_COMPONENT_ENABLED_STATE, conditional=true) public void setSyntheticAppDetailsActivityEnabled(@NonNull String, boolean);















    method public void setSystemAppState(@NonNull String, int);















    method @RequiresPermission(android.Manifest.permission.INSTALL_PACKAGES) public abstract void setUpdateAvailable(@NonNull String, boolean);













    method @NonNull public boolean shouldShowNewAppInstalledNotification();















    method @Deprecated @RequiresPermission(android.Manifest.permission.SET_PREFERRED_APPLICATIONS) public abstract boolean updateIntentVerificationStatusAsUser(@NonNull String, int, int);















    method @RequiresPermission(anyOf={android.Manifest.permission.GRANT_RUNTIME_PERMISSIONS, android.Manifest.permission.REVOKE_RUNTIME_PERMISSIONS}) public abstract void updatePermissionFlags(@NonNull String, @NonNull String, @android.content.pm.PackageManager.PermissionFlags int, @android.content.pm.PackageManager.PermissionFlags int, @NonNull android.os.UserHandle);















    method @Deprecated @RequiresPermission(android.Manifest.permission.INTENT_FILTER_VERIFICATION_AGENT) public abstract void verifyIntentFilter(int, int, @NonNull java.util.List<java.lang.String>);















    field public static final String ACTION_REQUEST_PERMISSIONS = "android.content.pm.action.REQUEST_PERMISSIONS";















    field public static final String ACTION_REQUEST_PERMISSIONS_FOR_OTHER = "android.content.pm.action.REQUEST_PERMISSIONS_FOR_OTHER";













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













    field public static final int DELETE_FAILED_ABORTED = -5; // 0xfffffffb













    field public static final int DELETE_FAILED_DEVICE_POLICY_MANAGER = -2; // 0xfffffffe













    field public static final int DELETE_FAILED_INTERNAL_ERROR = -1; // 0xffffffff













    field public static final int DELETE_FAILED_OWNER_BLOCKED = -4; // 0xfffffffc













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













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















    field public static final String EXTRA_REQUEST_PERMISSIONS_LEGACY_ACCESS_PERMISSION_NAMES = "android.content.pm.extra.REQUEST_PERMISSIONS_LEGACY_ACCESS_PERMISSION_NAMES";















    field public static final String EXTRA_REQUEST_PERMISSIONS_NAMES = "android.content.pm.extra.REQUEST_PERMISSIONS_NAMES";















    field public static final String EXTRA_REQUEST_PERMISSIONS_RESULTS = "android.content.pm.extra.REQUEST_PERMISSIONS_RESULTS";










@@ -3785,6 +3815,11 @@ package android.content.pm {













  @IntDef(prefix={"FLAG_PERMISSION_"}, value={android.content.pm.PackageManager.FLAG_PERMISSION_USER_SET, android.content.pm.PackageManager.FLAG_PERMISSION_USER_FIXED, android.content.pm.PackageManager.FLAG_PERMISSION_POLICY_FIXED, android.content.pm.PackageManager.FLAG_PERMISSION_REVOKE_ON_UPGRADE, android.content.pm.PackageManager.FLAG_PERMISSION_SYSTEM_FIXED, android.content.pm.PackageManager.FLAG_PERMISSION_GRANTED_BY_DEFAULT, android.content.pm.PackageManager.FLAG_PERMISSION_USER_SENSITIVE_WHEN_GRANTED, android.content.pm.PackageManager.FLAG_PERMISSION_USER_SENSITIVE_WHEN_DENIED, android.content.pm.PackageManager.FLAG_PERMISSION_RESTRICTION_UPGRADE_EXEMPT, android.content.pm.PackageManager.FLAG_PERMISSION_RESTRICTION_SYSTEM_EXEMPT, android.content.pm.PackageManager.FLAG_PERMISSION_RESTRICTION_INSTALLER_EXEMPT, android.content.pm.PackageManager.FLAG_PERMISSION_APPLY_RESTRICTION, android.content.pm.PackageManager.FLAG_PERMISSION_GRANTED_BY_ROLE, android.content.pm.PackageManager.FLAG_PERMISSION_REVOKED_COMPAT, android.content.pm.PackageManager.FLAG_PERMISSION_ONE_TIME, android.content.pm.PackageManager.FLAG_PERMISSION_AUTO_REVOKED}) @java.lang.annotation.Retention(java.lang.annotation.RetentionPolicy.SOURCE) public static @interface PackageManager.PermissionFlags {















  }



























  public static final class PackageManager.UninstallCompleteCallback implements android.os.Parcelable {













    method public void onUninstallComplete(@NonNull String, int, @Nullable String);













    field @NonNull public static final android.os.Parcelable.Creator<android.content.pm.PackageManager.UninstallCompleteCallback> CREATOR;













  }



























  public class PermissionGroupInfo extends android.content.pm.PackageItemInfo implements android.os.Parcelable {















    field @StringRes public final int backgroundRequestDetailResourceId;















    field @StringRes public final int backgroundRequestResourceId;










@@ -10924,6 +10959,7 @@ package android.provider {













    field public static final String ACTION_TETHER_PROVISIONING_UI = "android.settings.TETHER_PROVISIONING_UI";















    field public static final String ACTION_TETHER_SETTINGS = "android.settings.TETHER_SETTINGS";















    field public static final String ACTION_TETHER_UNSUPPORTED_CARRIER_UI = "android.settings.TETHER_UNSUPPORTED_CARRIER_UI";













    field public static final String ACTION_USER_SETTINGS = "android.settings.USER_SETTINGS";















  }





























  public static final class Settings.Global extends android.provider.Settings.NameValueTable {

























core/api/test-current.txt



+1
−2






























Original line number
Diff line number
Diff line








@@ -814,7 +814,7 @@ package android.content.pm {













  public class ApplicationInfo extends android.content.pm.PackageItemInfo implements android.os.Parcelable {















    method public boolean hasRequestForegroundServiceExemption();















    method public boolean isOnBackInvokedCallbackEnabled();













    method public boolean isPrivilegedApp();













    method @RequiresPermission(android.Manifest.permission.INSTALL_PACKAGES) public boolean isPrivilegedApp();















    method public boolean isSystemApp();















    method public void setEnableOnBackInvokedCallback(boolean);















    field public static final int PRIVATE_FLAG_PRIVILEGED = 8; // 0x8









@@ -831,7 +831,6 @@ package android.content.pm {





























  public static class PackageInstaller.SessionParams implements android.os.Parcelable {















    method public void setInstallFlagAllowTest();













    method public void setInstallerPackageName(@Nullable String);















  }































  public abstract class PackageManager {

































core/java/android/app/ApplicationPackageManager.java



+15
−0






























Original line number
Diff line number
Diff line








@@ -3875,4 +3875,19 @@ public class ApplicationPackageManager extends PackageManager {













            throw e.rethrowAsRuntimeException();















        }















    }



























    @Override













    public boolean canUserUninstall(String packageName, UserHandle user) {













        try {













            return mPM.getBlockUninstallForUser(packageName, user.getIdentifier());













        } catch (RemoteException e) {













            throw e.rethrowAsRuntimeException();













        }













    }



























    @Override













    public boolean shouldShowNewAppInstalledNotification() {













        return Settings.Global.getInt(mContext.getContentResolver(),













                Settings.Global.SHOW_NEW_APP_INSTALLED_NOTIFICATION_ENABLED, 0) == 1;













    }















}
























core/java/android/content/Intent.java



+3
−2






























Original line number
Diff line number
Diff line








@@ -1814,8 +1814,8 @@ public class Intent implements Parcelable, Cloneable {













     * Package manager install result code.  @hide because result codes are not















     * yet ready to be exposed.















     */













    public static final String EXTRA_INSTALL_RESULT













            = "android.intent.extra.INSTALL_RESULT";













    @SystemApi













    public static final String EXTRA_INSTALL_RESULT = "android.intent.extra.INSTALL_RESULT";































    /**















     * Activity Action: Launch application uninstaller.









@@ -1841,6 +1841,7 @@ public class Intent implements Parcelable, Cloneable {













     * Specify whether the package should be uninstalled for all users.















     * @hide because these should not be part of normal application flow.















     */













    @SystemApi















    public static final String EXTRA_UNINSTALL_ALL_USERS















            = "android.intent.extra.UNINSTALL_ALL_USERS";