App-Widgets können konfiguriert werden. In einem Uhr-Widget können Nutzer beispielsweise die anzuzeigende Zeitzone konfigurieren.
Wenn Sie Nutzern erlauben möchten, die Einstellungen Ihres Widgets zu konfigurieren, erstellen Sie eine Widgetkonfiguration Activity.
Konfigurationsaktivität deklarieren
Die Konfigurationsaktivität im Manifest deklarieren und in den XML-Metadaten des Providers verknüpfen ist für App-Widgets, die auf Views und Glance basieren, identisch.
Informationen zum Deklarieren der Konfigurationsaktivität finden Sie in der Dokumentation zur Glance-Konfiguration im Abschnitt Konfigurationsaktivität deklarieren.
Konfigurationsaktivität implementieren
Da Konfigurationsaktivitäten Standardkomponenten sind, die vom Plattform-Launcher aufgerufen werden, müssen ihre grundlegenden Lebenszyklus-Callbacks den Rückgabewertregeln des Systems folgen.
Informationen zum Implementieren einer Konfigurationsaktivität finden Sie in der Glance-Dokumentation im Abschnitt Konfigurationsaktivität implementieren.
Widget über die Konfigurationsaktivität aktualisieren
Bei herkömmlichen auf Ansichten basierenden Widgets aktualisieren Sie das Widget nach Abschluss der Konfiguration mit AppWidgetManager und einer RemoteViews-Layoutinstanz.
Wenn Sie ein altes, auf Views basierendes Widget erstellen und das RemoteViews-Layout aktualisieren müssen, sehen Sie sich den traditionellen Beispielcode für Views-Updates auf GitHub an. Informationen zu modernen Compose-First-Widgets finden Sie in der Glance-Dokumentation im Abschnitt Über die Konfigurationsaktivität aktualisieren.
Optionen für die Widget-Konfiguration
Das Verhalten von Widgets (z. B. spätere Neukonfiguration oder Überspringen der ersten Konfigurationseinrichtung) wird in Metadatenattributen mit Standard-Android 12-Flags registriert.
Informationen zur Verwendung dynamischer Widget-Optionen finden Sie in der Glance-Konfigurationsdokumentation im Abschnitt Widget-Konfigurationsoptionen.
Nutzern ermöglichen, platzierte Widgets neu zu konfigurieren
Informationen zum Hinzufügen benutzerdefinierter rekonfigurierbarer Einrichtungstrigger finden Sie in der Glance-Dokumentation im Abschnitt Enable users to reconfigure placed widgets (Nutzern ermöglichen, platzierte Widgets neu zu konfigurieren).
Standardkonfiguration des Widgets verwenden
Informationen dazu, wie Sie Konfigurationseinrichtungen standardmäßig überspringen, finden Sie in der Glance-Dokumentation im Abschnitt Standardkonfiguration des Widgets verwenden.