Rilevabilità del widget

Sui dispositivi con Android 8.0 (livello API 26) e versioni successive, i lanci che consentono agli utenti di creare scorciatoie bloccate consentono anche di bloccare i widget nella schermata Home. Come le scorciatoie bloccate, questi widget bloccati consentono agli utenti di accedere ad attività specifiche nella tua app e possono essere aggiunti alla schermata Home direttamente dall'app, come mostrato nel video seguente.

Figura 2. Esempio di blocco di un widget.

Consentire agli utenti di bloccare un widget

Nella tua app, puoi creare una richiesta affinché il sistema blocchi un widget su un avviatore supportato completando i seguenti passaggi:

1. Assicurati di dichiarare un widget nel file manifest dell'app.

2. Chiama il metodo requestPinAppWidget() come mostrato nello snippet di codice seguente:

Kotlin

val appWidgetManager = AppWidgetManager.getInstance(context)
val myProvider = ComponentName(context, ExampleAppWidgetProvider::class.java)

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    val successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT)

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Java

AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
ComponentName myProvider = new ComponentName(context, ExampleAppWidgetProvider.class);

if (appWidgetManager.isRequestPinAppWidgetSupported()) {
    // Create the PendingIntent object only if your app needs to be notified
    // when the user chooses to pin the widget. Note that if the pinning
    // operation fails, your app isn't notified. This callback receives the ID
    // of the newly pinned widget (EXTRA_APPWIDGET_ID).
    PendingIntent successCallback = PendingIntent.getBroadcast(
            /* context = */ context,
            /* requestCode = */ 0,
            /* intent = */ new Intent(...),
            /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT);

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback);
}

Nota: se la tua app non ha bisogno di essere avvisata se il sistema fissa correttamente un widget su un Avvio app supportato, puoi passare null come terzo argomento a requestPinAppWidget().

Linee guida per il design correlate

Gli utenti scoprono e aggiungono il tuo widget tramite il selettore dei widget o dall'app quando la funzionalità del widget è più pertinente. Per ulteriori informazioni, consulta Rilevamento e promozione.