Sichtbarkeit von Widgets

Auf Geräten mit Android 8.0 (API-Level 26) und höher können Nutzer mit Launchern, die das Erstellen von angepinnten Verknüpfungen ermöglichen, auch Widgets auf dem Startbildschirm anpinnen. Ähnlich wie angepinnte Verknüpfungen ermöglichen diese angehefteten Widgets Nutzern den Zugriff auf bestimmte Aufgaben in Ihrer App und können direkt über die App dem 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 erlauben, ein Widget anzupinnen

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

  1. Deklarieren Sie ein Widget in der Manifestdatei Ihrer App.

  2. Rufen Sie die Methode requestPinAppWidget() 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 dein Widget über die Widget-Auswahl oder in deiner App finden und hinzufügen, wenn die Funktionen des Widgets am relevantesten sind. Weitere Informationen finden Sie unter Erkennung und Hochstufung.