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

Commit 38139550 authored by Himanshu Gupta's avatar Himanshu Gupta
Browse files

Update Javadoc for Launcher API changes. 

In ag/26226975 Some Apis in frameworks were
updated to support hidden profiles.

The flag behind those changes are now in
trunkfood full, so now we are updating the
javadoc.

Bug: 287975131
Test: atest FrameworksServicesTests
Flag: ACONFIG android.multiuser.disable_private_space_items_on_home
TRUNKFOOD

Change-Id: Ie3f5e37e3769c89d8ce4d7ca6cc915a05694de78
parent fd9010cd

core/api/current.txt

+1 −1
Original line number Diff line number Diff line
@@ -12506,7 +12506,7 @@ package android.content.pm { 
    method public boolean hasShortcutHostPermission();

    method @RequiresPermission(conditional=true, anyOf={"android.permission.ACCESS_HIDDEN_PROFILES_FULL", android.Manifest.permission.ACCESS_HIDDEN_PROFILES}) public boolean isActivityEnabled(android.content.ComponentName, android.os.UserHandle);

    method @RequiresPermission(conditional=true, anyOf={"android.permission.ACCESS_HIDDEN_PROFILES_FULL", android.Manifest.permission.ACCESS_HIDDEN_PROFILES}) public boolean isPackageEnabled(String, android.os.UserHandle);

    method public void pinShortcuts(@NonNull String, @NonNull java.util.List<java.lang.String>, @NonNull android.os.UserHandle);

    method @RequiresPermission(conditional=true, value="android.permission.ACCESS_SHORTCUTS") public void pinShortcuts(@NonNull String, @NonNull java.util.List<java.lang.String>, @NonNull android.os.UserHandle);

    method @RequiresPermission(conditional=true, anyOf={"android.permission.ACCESS_HIDDEN_PROFILES_FULL", android.Manifest.permission.ACCESS_HIDDEN_PROFILES}) public void registerCallback(android.content.pm.LauncherApps.Callback);

    method @RequiresPermission(conditional=true, anyOf={"android.permission.ACCESS_HIDDEN_PROFILES_FULL", android.Manifest.permission.ACCESS_HIDDEN_PROFILES}) public void registerCallback(android.content.pm.LauncherApps.Callback, android.os.Handler);

    method public void registerPackageInstallerSessionCallback(@NonNull java.util.concurrent.Executor, @NonNull android.content.pm.PackageInstaller.SessionCallback);

core/java/android/appwidget/AppWidgetManager.java

+2 −1
Original line number Diff line number Diff line
@@ -1384,7 +1384,8 @@ public class AppWidgetManager { 
     *

     * @return {@code TRUE} if the launcher supports this feature. Note the API will return without

     *    waiting for the user to respond, so getting {@code TRUE} from this API does *not* mean

     *    the shortcut is pinned. {@code FALSE} if the launcher doesn't support this feature.

     *    the shortcut is pinned. {@code FALSE} if the launcher doesn't support this feature or if

     *    calling app belongs to a user-profile with items restricted on home screen.

     *

     * @see android.content.pm.ShortcutManager#isRequestPinShortcutSupported()

     * @see android.content.pm.ShortcutManager#requestPinShortcut(ShortcutInfo, IntentSender)

core/java/android/content/pm/LauncherApps.java

+9 −1
Original line number Diff line number Diff line
@@ -1097,7 +1097,8 @@ public class LauncherApps { 
     * @param packageName The specific package to query. If null, it checks all installed packages

     *            in the profile.

     * @param user The UserHandle of the profile.

     * @return List of config activities. Can be an empty list but will not be null.

     * @return List of config activities. Can be an empty list but will not be null. Empty list will

     * be returned for user-profiles that have items restricted on home screen.

     *

     * @see Intent#ACTION_CREATE_SHORTCUT

     * @see #getShortcutConfigActivityIntent(LauncherActivityInfo)
@@ -1488,6 +1489,9 @@ public class LauncherApps { 
     * <p>The calling launcher application must be allowed to access the shortcut information,

     * as defined in {@link #hasShortcutHostPermission()}.

     *

     * <p>For user-profiles with items restricted on home screen, caller must have the required

     * permission.

     *

     * @param packageName The target package name.

     * @param shortcutIds The IDs of the shortcut to be pinned.

     * @param user The UserHandle of the profile.
@@ -1496,6 +1500,7 @@ public class LauncherApps { 
     *

     * @see ShortcutManager

     */

    @RequiresPermission(conditional = true, value = android.Manifest.permission.ACCESS_SHORTCUTS)

    public void pinShortcuts(@NonNull String packageName, @NonNull List<String> shortcutIds,

            @NonNull UserHandle user) {

        logErrorForInvalidProfileAccess(user);
@@ -2298,6 +2303,9 @@ public class LauncherApps { 
     * app's manifest, have the android.permission.QUERY_ALL_PACKAGES, or be the session owner to

     * watch for these events.

     *

     * <p> Session callbacks are not sent for user-profiles that have items restricted on home

     * screen.

     *

     * @param callback The callback to register.

     * @param executor {@link Executor} to handle the callbacks, cannot be null.

     *

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

+4 −0
Original line number Diff line number Diff line
@@ -177,6 +177,10 @@ public class PackageInstaller { 
     * Broadcast Action: Explicit broadcast sent to the last known default launcher when a session

     * for a new install is committed. For managed profile, this is sent to the default launcher

     * of the primary profile.

     * For user-profiles that have items restricted on home screen, this broadcast is sent to

     * the default launcher of the primary profile, only if it has either

     * {@link Manifest.permission.ACCESS_HIDDEN_PROFILES_FULL} or

     * {@link Manifest.permission.ACCESS_HIDDEN_PROFILES} permission.

     * <p>

     * The associated session is defined in {@link #EXTRA_SESSION} and the user for which this

     * session was created in {@link Intent#EXTRA_USER}.

core/java/android/content/pm/ShortcutManager.java

+2 −2
Original line number Diff line number Diff line
@@ -584,7 +584,7 @@ public class ShortcutManager { 
     * @return {@code TRUE} if the launcher supports this feature.  Note the API will return without

     *    waiting for the user to respond, so getting {@code TRUE} from this API does *not* mean

     *    the shortcut was pinned successfully. {@code FALSE} if the launcher doesn't support this

     *    feature.

     *    feature or if calling app belongs to a user-profile with items restricted on home screen.

     *

     * @see #isRequestPinShortcutSupported()

     * @see IntentSender