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

Commit db3b10a9 authored Jan 10, 2017 by Makoto Onuki

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

parent a2b61657

core/java/android/appwidget/AppWidgetManager.java

+3 −2

Original line number	Diff line number	Diff line
		@@ -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.

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

+1 −1

Original line number	Diff line number	Diff line
		@@ -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 {

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

+3 −2

Original line number	Diff line number	Diff line
		@@ -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