App-Widgets können konfigurierbar sein. In einem Uhr-Widget können Nutzer beispielsweise festlegen, welche Zeitzone angezeigt werden soll.
Wenn Sie Nutzern die Möglichkeit geben möchten, die Einstellungen Ihres Widgets zu konfigurieren, erstellen Sie eine Widget-Konfiguration Activity.
Konfigurationsaktivität deklarieren
Die Deklaration der Konfigurationsaktivität im Manifest und die Verknüpfung in den XML-Metadaten des Anbieters sind bei ansichtsbasierten und Glance-basierten App-Widgets identisch.
Informationen zum Deklarieren der Konfigurationsaktivität finden Sie im Abschnitt Konfigurationsaktivität deklarieren in der Glance-Konfigurationsdokumentation.
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 entsprechen.
Informationen zum Implementieren einer Konfigurationsaktivität finden Sie in der Glance-Dokumentation im Abschnitt Konfigurationsaktivität implementieren.
Widget über die Konfigurationsaktivität aktualisieren
In herkömmlichen ansichtsbasierten Widgets aktualisieren Sie das Widget nach Abschluss der Konfiguration mit der AppWidgetManager und einer RemoteViews-Layoutinstanz.
Wenn Sie ein älteres, ansichtenbasiertes Widget erstellen und das RemoteViews-Layout aktualisieren müssen, finden Sie im Beispielcode für die Aktualisierung von Ansichten auf GitHub weitere Informationen. 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 Widget-Verhalten (z. B. die Möglichkeit, die Konfiguration später zu ändern, oder das Überspringen der ersten Konfigurationsschritte) wird in Metadatenattributen mit Standard-Android 12-Flags registriert.
Informationen zur Nutzung dynamischer Widget-Optionen finden Sie in der Glance-Konfigurationsdokumentation im Abschnitt Widget-Konfigurationsoptionen für Compose-First.
Nutzer können platzierte Widgets neu konfigurieren
Informationen zum Hinzufügen benutzerdefinierter rekonfigurierbarer Einrichtungstrigger finden Sie im Abschnitt Nutzer die Möglichkeit geben, platzierte Widgets neu zu konfigurieren in der Glance-Dokumentation.
Standardkonfiguration des Widgets verwenden
Informationen dazu, wie Sie Konfigurationseinrichtungen standardmäßig überspringen, finden Sie in der Glance-Dokumentation im Abschnitt Standardkonfiguration des Widgets verwenden.