ShortcutAdapter

public static final String DEFAULT_NAMESPACE = "__shortcut_adapter_ns__"

Represents the default namespace which should be used as the androidx.appsearch.annotation.Document.Namespace for documents that are meant to be donated as a shortcut through androidx.core.content.pm.ShortcutManagerCompat.

public static @NonNull ShortcutInfoCompat.Builder createShortcutBuilderFromDocument(
    @NonNull Context context,
    @NonNull Object document
)

Converts given document to a ShortcutInfoCompat.Builder, which can be used to construct a shortcut for donation through androidx.core.content.pm.ShortcutManagerCompat. Applicable data in the given document will be used to populate corresponding fields in ShortcutInfoCompat.Builder.

Note: Namespace of the given document is required to be set to DEFAULT_NAMESPACE if it will be used to create a shortcut; Otherwise an exception would be thrown.

See androidx.appsearch.annotation.Document.Namespace

Note: The ShortcutID in ShortcutInfoCompat.Builder will be set to match the id of given document. So an unique id across all documents should be chosen if the document is to be used to create a shortcut.

see getId

see androidx.appsearch.annotation.Document.Id

ShortcutInfoCompat.Builder created this way by default will be set to hidden from launcher. If remain hidden, they will not appear in launcher's surfaces (e.g. long press menu) nor do they count toward the quota defined in getMaxShortcutCountPerActivity

See setExcludedFromSurfaces.

Given document object will be stored in the form of Bundle in ShortcutInfoCompat.

The document that was stored in ShortcutInfoCompat is discarded when the shortcut is converted into android.content.pm.ShortcutInfo, meaning that the document will not be persisted in the shortcut object itself once the shortcut is published. i.e. Any shortcut returned from queries toward androidx.core.content.pm.ShortcutManagerCompat would not carry any document at all.

public static @NonNull Uri getDocumentUri(@NonNull Object document)

Returns an uri that uniquely identifies the given document object.

public static @NonNull Uri getDocumentUri(@NonNull String id)

Returns an uri that identifies to the document associated with given document id.