docs: Updated ShortcutManager and ShortcutInfo class references.

import java.util.Set;

/**

 * Represents a "launcher shortcut" that can be published via {@link ShortcutManager}.

 * Represents a shortcut that can be published via {@link ShortcutManager}.

 *

 * @see ShortcutManager

 */

         * activity is published using

         * {@link ShortcutManager#addDynamicShortcuts(List)} or

         * {@link ShortcutManager#setDynamicShortcuts(List)},

         * the first main activity defined in the application's <code>AndroidManifest.xml</code>

         * the first main activity defined in the app's <code>AndroidManifest.xml</code>

         * file is used.

         *

         * <li>Only "main" activities&mdash;ones that define the {@link Intent#ACTION_MAIN}

         * and {@link Intent#CATEGORY_LAUNCHER} intent filters—can be target

         * activities.

         *

         * <li>By default, the first main activity defined in the application manifest is

         * <li>By default, the first main activity defined in the app's manifest is

         * the target activity.

         *

         * <li>A target activity must belong to the publisher application.

         * <li>A target activity must belong to the publisher app.

         * </ul>

         *

         * @see ShortcutInfo#getActivity()

         *

         * <p>Icons are not available on {@link ShortcutInfo} instances

         * returned by {@link ShortcutManager} or {@link LauncherApps}.  The default launcher

         * application can use {@link LauncherApps#getShortcutIconDrawable(ShortcutInfo, int)}

         * app can use {@link LauncherApps#getShortcutIconDrawable(ShortcutInfo, int)}

         * or {@link LauncherApps#getShortcutBadgedIconDrawable(ShortcutInfo, int)} to fetch

         * shortcut icons.

         *

        }

        /**

         * Sets categories for a shortcut.  Launcher applications may use this information to

         * categorise shortcuts.

         * Sets categories for a shortcut.  Launcher apps may use this information to

         * categorize shortcuts.

         *

         * @see #SHORTCUT_CATEGORY_CONVERSATION

         * @see ShortcutInfo#getCategories()

         * {@link ShortcutManager#addDynamicShortcuts(List)} or

         * {@link ShortcutManager#setDynamicShortcuts(List)}.

         *

         * <p>A shortcut can launch any intent that the publisher application has permission to

         * <p>A shortcut can launch any intent that the publisher app has permission to

         * launch.  For example, a shortcut can launch an unexported activity within the publisher

         * application.  A shortcut intent doesn't have to point at the target activity.

         * app.  A shortcut intent doesn't have to point at the target activity.

         *

         * <p>The given {@code intent} can contain extras, but these extras must contain values

         * of primitive types in order for the system to persist these values.

        /**

         * Sets multiple intents instead of a single intent, in order to launch an activity with

         * other activities in back stack.  Use {@link TaskStackBuilder} to build intents.

         * other activities in back stack.  Use {@link TaskStackBuilder} to build intents. The

         * last element in the list represents the only intent that doesn't place an activity on

         * the back stack.

         * See the {@link ShortcutManager} javadoc for details.

         *

         * @see Builder#setIntent(Intent)

        }

        /**

         * Extras that application can set for any purpose.

         * Extras that the app can set for any purpose.

         *

         * <p>Applications can store arbitrary shortcut metadata in extras and retrieve the

         * <p>Apps can store arbitrary shortcut metadata in extras and retrieve the

         * metadata later using {@link ShortcutInfo#getExtras()}.

         */

        @NonNull

    /**

     * Returns the ID of a shortcut.

     *

     * <p>Shortcut IDs are unique within each publisher application and must be stable across

     * <p>Shortcut IDs are unique within each publisher app and must be stable across

     * devices so that shortcuts will still be valid when restored on a different device.

     * See {@link ShortcutManager} for details.

     */

    }

    /**

     * Return the package name of the publisher application.

     * Return the package name of the publisher app.

     */

    @NonNull

    public String getPackage() {

     * Return the target activity.

     *

     * <p>This has nothing to do with the activity that this shortcut will launch.

     * Launcher applications should show the launcher icon for the returned activity alongside

     * Launcher apps should show the launcher icon for the returned activity alongside

     * this shortcut.

     *

     * @see Builder#setActivity

    }

    /**

     * Return the shorter description of a shortcut.

     * Return the short description of a shortcut.

     *

     * @see Builder#setShortLabel(CharSequence)

     */

    }

    /**

     * Return the longer description of a shortcut.

     * Return the long description of a shortcut.

     *

     * @see Builder#setLongLabel(CharSequence)

     */

     * Returns the intent that is executed when the user selects this shortcut.

     * If setIntents() was used, then return the last intent in the array.

     *

     * <p>Launcher applications <b>cannot</b> see the intent.  If a {@link ShortcutInfo} is

     * <p>Launcher apps <b>cannot</b> see the intent.  If a {@link ShortcutInfo} is

     * obtained via {@link LauncherApps}, then this method will always return null.

     * Launchers can only start a shortcut intent with {@link LauncherApps#startShortcut}.

     *

    /**

     * Return the intent set with {@link Builder#setIntents(Intent[])}.

     *

     * <p>Launcher applications <b>cannot</b> see the intents.  If a {@link ShortcutInfo} is

     * <p>Launcher apps <b>cannot</b> see the intents.  If a {@link ShortcutInfo} is

     * obtained via {@link LauncherApps}, then this method will always return null.

     * Launchers can only start a shortcut intent with {@link LauncherApps#startShortcut}.

     *

    /**

     * "Rank" of a shortcut, which is a non-negative, sequential value that's unique for each

     * {@link #getActivity} for each of the two kinds, dynamic shortcuts and manifest shortcuts.

     * {@link #getActivity} for each of the two types of shortcuts (static and dynamic).

     *

     * <p>Because manifest shortcuts and dynamic shortcuts have overlapping ranks,

     * when a launcher application shows shortcuts for an activity, it should first show

     * the manifest shortcuts followed by the dynamic shortcuts.  Within each of those categories,

     * <p>Because static shortcuts and dynamic shortcuts have overlapping ranks,

     * when a launcher app shows shortcuts for an activity, it should first show

     * the static shortcuts, followed by the dynamic shortcuts.  Within each of those categories,

     * shortcuts should be sorted by rank in ascending order.

     *

     * <p>"Floating" shortcuts (i.e. shortcuts that are neither dynamic nor manifest) will all

     * have rank 0, because there's no sorting for them.

     * <p><em>Floating shortcuts</em>, or shortcuts that are neither static nor dynamic, will all

     * have rank 0, because they aren't sorted.

     *

     * See the {@link ShortcutManager}'s class javadoc for details.

     *

    }

    /**

     * Extras that application can set to any purposes.

     * Extras that the app can set for any purpose.

     *

     * @see Builder#setExtras(PersistableBundle)

     */

    }

    /**

     * Return whether a shortcut is published from AndroidManifest.xml or not.  If {@code true},

     * it's also {@link #isImmutable()}.

     * Return whether a shortcut is static; that is, whether a shortcut is

     * published from AndroidManifest.xml.  If {@code true}, the shortcut is

     * also {@link #isImmutable()}.

     *

     * <p>When an app is upgraded and a shortcut is no longer published from AndroidManifest.xml,

     * this will be set to {@code false}.  If the shortcut is not pinned, then it'll just disappear.

     * However, if it's pinned, it will still be alive, and {@link #isEnabled()} will be

     * this will be set to {@code false}.  If the shortcut is not pinned, then it'll disappear.

     * However, if it's pinned, it will still be visible, {@link #isEnabled()} will be

     * {@code false} and {@link #isImmutable()} will be {@code true}.

     */

    public boolean isDeclaredInManifest() {

    }

    /**

     * @return true if pinned but neither dynamic nor manifest.

     * @return true if pinned but neither static nor dynamic.

     * @hide

     */

    public boolean isFloating() {

     * Return if a shortcut is immutable, in which case it cannot be modified with any of

     * {@link ShortcutManager} APIs.

     *

     * <p>All manifest shortcuts are immutable.  When a manifest shortcut is pinned and then

     * disabled because the app is upgraded and its AndroidManifest.xml no longer publishes it,

     * {@link #isDeclaredInManifest()} returns {@code false}, but it is still immutable.

     * <p>All static shortcuts are immutable.  When a static shortcut is pinned and is then

     * disabled because it doesn't appear in AndroidManifest.xml for a newer version of the

     * app, {@link #isDeclaredInManifest()} returns {@code false}, but the shortcut

     * is still immutable.

     *

     * <p>All shortcuts originally published via the {@link ShortcutManager} APIs

     * are all mutable.

    }

    /**

     * Replaces the intent

     * Replaces the intent.

     *

     * @throws IllegalArgumentException when extra is not compatible with {@link PersistableBundle}.

     *