Sichtbarkeit von Widgets

Auf Geräten mit Android 8.0 (API-Ebene 26) und höher können Nutzer in Launchern, mit denen sie angeheftete Verknüpfungen erstellen können, auch Widgets auf dem Startbildschirm anheften. Ähnlich wie bei angepinnten Verknüpfungen können Nutzer mit diesen angepinnten Widgets auf bestimmte Aufgaben in Ihrer App zugreifen. Sie können direkt über die App zum Startbildschirm hinzugefügt werden, wie im folgenden Video gezeigt.

Beispiel für das Anpinnen eines Widgets
Abbildung 1. Beispiel für das Anpinnen eines Widgets.

Nutzern das Anpinnen eines Widgets ermöglichen

In Ihrer App können Sie eine Anfrage an das System senden, um ein Widget in einem unterstützten Launcher anzupinnen. Gehen Sie dazu so vor:

  1. Achten Sie darauf, dass Sie ein Widget in der Manifestdatei Ihrer App deklarieren.

  2. Rufen Sie die requestPinAppWidget() Methode auf, wie im folgenden Code-Snippet gezeigt:

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 or PendingIntent.FLAG_IMMUTABLE
    )

    appWidgetManager.requestPinAppWidget(myProvider, null, successCallback)
}

Nutzer können Ihr Widget über die Widget-Auswahl oder in Ihrer App finden und hinzufügen, wenn die Funktion des Widgets am relevantesten ist. Weitere Informationen finden Sie unter Auffindbarkeit und Promotion.