App-Widgets können konfiguriert werden. Bei einem Uhr-Widget können Nutzer beispielsweise konfigurieren, 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.
Konfigurations-Activity deklarieren
Die Deklaration der Konfigurations-Activity im Manifest und die Verknüpfung in den XML-Metadaten Ihres Anbieters sind sowohl für auf Views als auch für auf Glance basierende App-Widgets identisch.
Informationen zum Deklarieren der Konfigurations-Activity finden Sie im Abschnitt Compose-first Konfigurations-Activity deklarieren in der Glance-Konfigurations dokumentation.
Konfigurations-Activity implementieren
Da Konfigurations-Activities Standardkomponenten sind, die vom Launcher der Plattform aufgerufen werden, müssen ihre grundlegenden Lebenszyklus-Callbacks den Regeln für Rückgabewerte des Systems folgen.
Informationen zum Implementieren einer Konfigurations-Activity finden Sie im Abschnitt Compose-first Konfigurations-Activity implementieren in der Glance-Dokumentation.
Widget über die Konfigurations-Activity aktualisieren
Bei herkömmlichen auf Views basierenden Widgets aktualisieren Sie das Widget nach Abschluss der Konfiguration mit AppWidgetManager und einer RemoteViews-Layoutinstanz.
Wenn Sie ein älteres auf Views basierendes Widget erstellen und das RemoteViews-Layout aktualisieren müssen, finden Sie den Beispielcode für die Aktualisierung von herkömmlichen Views auf GitHub. Informationen zu modernen Compose-first-Widgets finden Sie im Abschnitt Über die Konfigurations-Activity aktualisieren in der Glance-Dokumentation.
Widgetkonfigurationsoptionen
Widgetverhalten wie die Möglichkeit, die Konfiguration später zu ändern, oder das Überspringen der ersten Konfigurationseinrichtungsschritte werden in Metadatenattributen mit Standard-Android 12-Flags registriert.
Informationen zur Verwendung dynamischer Widgetoptionen finden Sie im Abschnitt Compose-first Widget konfigurationsoptionen in der Glance-Konfigurationsdokumentation.
Nutzern ermöglichen, platzierte Widgets neu zu konfigurieren
Informationen zum Hinzufügen benutzerdefinierter neu konfigurierbarer Einrichtungstrigger finden Sie im Compose-first Abschnitt Nutzern ermöglichen, platzierte Widgets neu zu konfigurieren in der Glance-Dokumentation.
Standardkonfiguration des Widgets verwenden
Informationen zum standardmäßigen Überspringen von Konfigurationseinrichtungen finden Sie im Abschnitt Standardkonfiguration des Widgets verwenden in der Glance-Dokumentation.