https://github.com/google/glance-experimental-tools

Z przyjemnością informujemy, że nowy framework Jetpack Glance , który pozwala tworzyć widżety aplikacji i nosić kafelki z kodem podobnym do Jetpack Compose, osiągnął poziom alpha-04 .

To wydanie przyniosło nowe funkcje, przełomowe zmiany i nowe API:

Właśnie wydaliśmy również samodzielne eksperymentalne repozytorium , aby uzupełnić Jetpack Glance o narzędzia, które są powszechnie wymagane do rozwoju, ale jeszcze nie są dostępne.

Ważne: ten projekt jest niezależny od repozytorium i rozwoju AndroidX Glance . Interfejs GlanceRemoteViewsAPI i dowolne funkcje w repozytorium eksperymentalnym mogą w przyszłości ulec zmianie lub stać się przestarzałe (a zatem prawdopodobnie przestarzałe).

Dlaczego nie mogą być w systemie AndroidX?

Chcemy swobodniej iterować, eksplorować i eksperymentować z niektórymi nowymi interfejsami API i narzędziami, bez obciążania głównego interfejsu API i unikania zobowiązań dotyczących interfejsu API. Ponadto niektóre z tych funkcji mogą być niedozwolone w systemie AndroidX.

Uwaga: to repozytorium jest zgodne z wzorcem Akompaniator , ale w znacznie węższym zakresie (więcej na ten temat przeczytasz tutaj )

Rzuć okiem na narzędzia eksperymentalne

Pierwotnym pomysłem jest użycie nowego eksperymentalnego GlanceRemoteViews interfejsu API, aby włączyć nowe funkcje wraz z Jetpack Compose. Przyjrzyjmy się pierwszym dostępnym modułom:

Możliwość komponowania hosta AppWidget

Możesz użyć elementu AppWidgetHostkomponującego do hostowania i wyświetlania widoków zdalnych w swojej aplikacji. Ten moduł, wraz z nowym GlanceRemoteViewsinterfejsem API, zasila inne moduły prostym interfejsem API, który wyświetla obiekt RemoteViews, oddzielony od AppWidgets i Glance.

Spójrzmy na przykład:

Aktualizuje AppWidgetHostStatehosta o podane RemoteViews. W tym miejscu możemy użyć nowego GlanceRemoteViewsAPI do wygenerowania ich z funkcji, którą można komponować Glance.

Przeczytaj więcej o tym module tutaj .

Uwaga: Możesz bezpośrednio używać RemoteViews bez Glance, ponieważ ten moduł nie jest zależny od widgetu podglądu.

Przeglądarka podglądu-appwidget

Jeśli chodzi o testowanie i debugowanie AppWidgets, głównym problemem był żmudny proces wymagany do wdrożenia pojedynczej iteracji :

1. Zbuduj swój projekt.
2. Uruchom aplikację.
3. Zamknij aplikację.
4. Usuń i dodaj widżet aplikacji w programie uruchamiającym (lub użyj tego obejścia ☹️)
5. Gotowe!

… poczekaj chwilę, „Edycja na żywo” działa z Glance?

Zgadza się: nie musisz już czekać na skompilowanie i uruchomienie aplikacji. Rozszerzając GlancePreviewActivitykompilacje debugowania, możesz przyspieszyć iteracje interfejsu użytkownika. Rozszerzona aktywność wyświetla widżety Twojej aplikacji w Twojej aplikacji (zamiast programu uruchamiającego), zapewniając znacznie szybszy podgląd i włączając funkcje Zastosuj zmiany i Edycja na żywo z Android Studio.

Przeglądarka look-appwidget nie polega na AppWidgetManager; zamiast tego używa AppWidgetHostViewbezpośrednio do pominięcia BroadcastReceivermechanizmu renderowania RemoteViews wewnątrz aktywności aplikacji (istnieją pewne ograniczenia ).

Używając tej przeglądarki, razem z Compose i Live Edit , możemy osiągnąć ( w większości sytuacji ) mechanizm aktualizacji w czasie rzeczywistym, wyświetlając zmiany w kodzie w twoich komponowacjach Glance niemal natychmiast.

Co więcej, aktywność przeglądarki umożliwia korzystanie z innych dostępnych narzędzi programistycznych, takich jak Inspektor układu .

Ponadto aktywność widza zapewnia następujące funkcje:

• Przełączanie między różnymi widżetami
• Zmiana rozmiaru i odzwierciedlanie zmian dostępnego miejsca na widget (z uwzględnieniem SizeMode )
• ℹ️ Podświetlanie brakujących metadanych widgetu
• Prośba o przypięcie bieżącego podglądu przez program uruchamiający
• ️ Wyodrębnianie i udostępnianie bieżącego podglądu ( android:previewImage )

Korzystanie z tworzenia @Podgląd

Aktywność Przeglądarka zapewnia użyteczną funkcjonalność, ale wymaga dodatkowej konfiguracji i zależności materiałowych. Jeśli chcesz wyświetlać tylko podgląd swoich GlanceAppWidgets z wbudowanym mechanizmem Preview w Android Studio , jest to również możliwe przy użyciu GlanceAppWidgetHostPreview .

Uwaga: podczas gdy podgląd będzie renderowany w Android Studio, RemoteViews nie. Musisz zawsze uruchomić go w urządzeniu. Lepsze wsparcie w tym zakresie zostanie zapewnione później.

Możliwość komponowania konfiguracji GlanceAppWidget

Ten moduł do komponowania GlanceAppWidget Configuration oferuje opiniowany moduł do komponowania do użycia w działaniach konfiguracyjnych dla widżetów aplikacji. W skrócie, opiera się na rusztowaniu Material3 , aby wyświetlać i obsługiwać logikę konfiguracji aktywności appwidget dla Glance.

Ten materiał do komponowania doskonale nadaje się do:

• Płynniejsze i wyrównane przejście między programem uruchamiającym a ekranem konfiguracji ( Materiał Ty! )
• Wyświetlanie realistycznego podglądu widżetu aplikacji (zachowuje rozmiar), aby pomóc użytkownikom go skonfigurować
• Włączanie GlanceAppWidget do odzwierciedlania zmian stanu bez faktycznego ich stosowania

Co dalej?

Odkrywamy inne narzędzia, które pomogą Ci tworzyć lepsze lookables za pomocą Glance. Tymczasem czekamy na Wasze opinie. Proszę korzystać z GitHub, aby zgłaszać problemy lub prośby o nowe funkcje ( wkłady psst! są mile widziane!).