Widżety aplikacji można konfigurować. Na przykład widżet zegara może umożliwiać użytkownikom skonfigurowanie strefy czasowej, która ma być wyświetlana.
Jeśli chcesz, aby użytkownicy mogli konfigurować ustawienia widżetu, utwórz konfigurację widżetu Activity.
Deklarowanie aktywności związanej z konfiguracją
Deklarowanie aktywności konfiguracyjnej w pliku manifestu i łączenie jej w metadanych XML dostawcy jest takie samo w przypadku widżetów aplikacji opartych na widokach i widżetów opartych na Glance.
Aby dowiedzieć się, jak zadeklarować aktywność konfiguracji, zapoznaj się z sekcją Deklarowanie aktywności konfiguracji w dokumentacji konfiguracji Glance.
Implementowanie aktywności konfiguracyjnej
Aktywności konfiguracyjne są standardowymi komponentami wywoływanymi przez program uruchamiający platformy, dlatego ich podstawowe wywołania zwrotne cyklu życia muszą być zgodne z regułami wartości zwracanych przez system.
Aby dowiedzieć się, jak wdrożyć aktywność konfiguracyjną, zapoznaj się z sekcją Implement the configuration activity (Wdrażanie aktywności konfiguracyjnej) w dokumentacji Glance.
Aktualizowanie widżetu z poziomu aktywności konfiguracji
W tradycyjnych widżetach opartych na widokach aktualizujesz widżet po zakończeniu konfiguracji, używając instancji układu AppWidgetManager i RemoteViews.
Jeśli tworzysz starszy widżet oparty na widokach i musisz zaktualizować układ RemoteViews, zapoznaj się z tradycyjnym przykładowym kodem aktualizacji widoków na GitHubie. Informacje o nowoczesnych widżetach opartych na Compose znajdziesz w sekcji Aktualizowanie z poziomu aktywności konfiguracji w dokumentacji Glance.
Opcje konfiguracji widżetu
Zachowania widżetów (takie jak zezwalanie na późniejszą ponowną konfigurację lub całkowite pominięcie początkowych kroków konfiguracji) są rejestrowane w atrybutach metadanych za pomocą standardowych flag Androida 12.
Aby dowiedzieć się, jak korzystać z opcji dynamicznych widżetów, zapoznaj się z sekcją opcji konfiguracji widżetów w dokumentacji konfiguracji Glance.
Zezwalaj użytkownikom na ponowne konfigurowanie umieszczonych widżetów
Aby dowiedzieć się, jak dodawać niestandardowe aktywatory konfiguracji, które można ponownie konfigurować, zapoznaj się z sekcją Umożliwianie użytkownikom ponownego konfigurowania widżetów miejsc w dokumentacji Glance.
Użyj domyślnej konfiguracji widżetu
Aby dowiedzieć się, jak domyślnie pomijać konfiguracje, zapoznaj się z sekcją Używanie domyślnej konfiguracji widżetu w dokumentacji Glance.