diff options
| author | 2017-01-10 14:18:47 -0800 | |
|---|---|---|
| committer | 2017-01-10 15:43:20 -0800 | |
| commit | db3b10a95e18d918927e61fa983c30de7bf069a4 (patch) | |
| tree | cb5d89189788264d777f40dcb7f5b56045968d46 | |
| parent | a2b61657c4bfbc9d13cf1414c2eb7a1f99557d3e (diff) | |
Update the javadoc on requestPinShortcut() about multiple...
requests in a row form the same app.
Bug 34175917
Test: Javadoc change only; presubmit test.
Change-Id: Ibf33010dbd9080c557112e15efcadd30d95b121f
| -rw-r--r-- | core/java/android/appwidget/AppWidgetManager.java | 5 | ||||
| -rw-r--r-- | core/java/android/content/pm/LauncherApps.java | 2 | ||||
| -rw-r--r-- | core/java/android/content/pm/ShortcutManager.java | 5 |
3 files changed, 7 insertions, 5 deletions
diff --git a/core/java/android/appwidget/AppWidgetManager.java b/core/java/android/appwidget/AppWidgetManager.java index 318968158559..31e779f0dc4b 100644 --- a/core/java/android/appwidget/AppWidgetManager.java +++ b/core/java/android/appwidget/AppWidgetManager.java @@ -1094,8 +1094,9 @@ public class AppWidgetManager { * <p>Only apps with a foreground activity or a foreground service can call it. Otherwise * it'll throw {@link IllegalStateException}. * - * <p>When an app calls this API when a previous request is still waiting for a response, - * the previous request will be canceled. + * <p>It's up to the launcher how to handle previous pending requests when the same package + * calls this API multiple times in a row. It may ignore the previous requests, + * for example. * * @param provider The {@link ComponentName} for the {@link * android.content.BroadcastReceiver BroadcastReceiver} provider for your AppWidget. diff --git a/core/java/android/content/pm/LauncherApps.java b/core/java/android/content/pm/LauncherApps.java index 4b5b995cd218..afd757877603 100644 --- a/core/java/android/content/pm/LauncherApps.java +++ b/core/java/android/content/pm/LauncherApps.java @@ -1200,7 +1200,7 @@ public class LauncherApps { /** * Return {@code TRUE} if a request is valid -- i.e. {@link #accept(Bundle)} has not been - * called, and it has not been canceled. + * called yet. */ public boolean isValid() { try { diff --git a/core/java/android/content/pm/ShortcutManager.java b/core/java/android/content/pm/ShortcutManager.java index c8fb3d174fe0..385340000d83 100644 --- a/core/java/android/content/pm/ShortcutManager.java +++ b/core/java/android/content/pm/ShortcutManager.java @@ -846,8 +846,9 @@ public class ShortcutManager { * <p>Only apps with a foreground activity or a foreground service can call it. Otherwise * it'll throw {@link IllegalStateException}. * - * <p>When an app calls this API when a previous request is still waiting for a response, - * the previous request will be canceled. + * <p>It's up to the launcher how to handle previous pending requests when the same package + * calls this API multiple times in a row. It may ignore the previous requests, + * for example. * * @param shortcut New shortcut to pin. If an app wants to pin an existing (either dynamic * or manifest) shortcut, then it only needs to have an ID, and other fields don't have to |