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 zezwolić użytkownikom na konfigurowanie ustawień 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 identyczne w przypadku widżetów aplikacji opartych na widokach i widżetów opartych na Glance.
Aby dowiedzieć się, jak zadeklarować aktywność związaną z konfiguracją, zapoznaj się z sekcją Deklarowanie aktywności związanej z konfiguracją w artykule Konfiguracja Glance.
Wdrażanie aktywności konfiguracyjnej
Ponieważ działania konfiguracyjne są standardowymi komponentami wywoływanymi przez moduł uruchamiający platformy, ich podstawowe wywołania zwrotne cyklu życia muszą być zgodne z zasadami dotyczącymi wartości zwracanych przez system.
Aby dowiedzieć się, jak zaimplementować działanie konfiguracji, zapoznaj się z sekcją Implementowanie działania konfiguracji 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 za pomocą elementu AppWidgetManager i instancji układu RemoteViews.
Jeśli tworzysz starszy widżet oparty na widokach i musisz zaktualizować układ RemoteViews, skorzystaj z tradycyjnego przykładowego kodu aktualizacji widoków w GitHubie. W przypadku nowoczesnych widżetów opartych na Compose zapoznaj się z sekcją Aktualizowanie z poziomu aktywności konfiguracji w dokumentacji Glance.
Opcje konfiguracji widżetu
Zachowania widżetów (np. możliwość późniejszej rekonfiguracji 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 dynamicznych opcji widżetu, zapoznaj się z sekcją Opcje konfiguracji widżetu w dokumentacji konfiguracji Glance.
Umożliwianie użytkownikom ponownej konfiguracji umieszczonych widżetów
Aby dowiedzieć się, jak dodawać niestandardowe wyzwalacze konfiguracji, przeczytaj sekcję Umożliwianie użytkownikom ponownej konfiguracji umieszczonych widżetów w dokumentacji Glance.
Użyj domyślnej konfiguracji widżetu
Aby dowiedzieć się, jak domyślnie pomijać konfigurację, zapoznaj się z sekcją Używanie domyślnej konfiguracji widżetu w dokumentacji Glance.