Jetpack WindowManager 1.5 w wersji stabilnej

Z przyjemnością informujemy, że Jetpack WindowManager w wersji 1.5.0 jest już stabilny.

Ta wersja opiera się na solidnych podstawach adaptacyjności w WindowManagerze, dzięki czemu tworzenie dopracowanych, adaptacyjnych interfejsów, które świetnie wyglądają na ekranach o różnych rozmiarach, jest jeszcze łatwiejsze. Ekosystem Androida stale się rozwija, a użytkownicy korzystają z aplikacji na coraz większej liczbie urządzeń: od telefonów i urządzeń składanych po tablety, wyświetlacze połączone, Chromebooki, a nawet wyświetlacze samochodowe w trybie parkowania.

Biblioteka WindowManager w wersji 1.5 koncentruje się na udostępnianiu lepszych narzędzi dla tego zróżnicowanego środowiska urządzeń.

Nowości w usłudze WindowManager 1.5

Ta stabilna wersja wprowadza nowe punkty przerwania dla bardzo dużych ekranów, ulepsza interfejs API do osadzania aktywności i zapewnia większą elastyczność w obliczaniu danych okna.

Nowe klasy rozmiarów okien: duże i bardzo duże

Największą zmianą w wersji 1.5 jest dodanie 2 nowych klas rozmiarów okien o różnej szerokości: dużej i bardzo dużej.

Klasy rozmiaru okna to nasz oficjalny, subiektywny zestaw punktów przerwania widocznego obszaru, który pomaga projektować i tworzyć układy adaptacyjne. W wersji 1.5 rozszerzamy te wytyczne na ekrany, które nie są typowymi tabletami.

Oto nowe punkty przerwania szerokości:

• Duży: dla szerokości od 1200 dp do 1600 dp.
• Bardzo duży: dla szerokości ≥1600 dp

Różne klasy rozmiarów okien na podstawie szerokości wyświetlacza. 

Dlaczego są one ważne?

Od wersji beta 2 Androida 16 QPR1 Android obsługuje połączone wyświetlacze, dzięki czemu użytkownicy mogą podłączyć zewnętrzny wyświetlacz do urządzenia i przekształcić je w narzędzie z dużym ekranem, które przypomina komputer.

Telefon podłączony do wyświetlacza zewnętrznego, na którym jest uruchomiona sesja pulpitu. 

W związku z dostępnością tej nowej funkcji kluczowe jest podanie opinii na temat uwzględniania większych wyświetlaczy. 

Na tak dużych urządzeniach zwykłe powiększenie układu rozszerzonego na tablecie nie zawsze zapewnia najlepsze wrażenia użytkownika. Na przykład klient poczty e-mail może wygodnie wyświetlać 2 panele (skrzynkę pocztową i wiadomość) w przypadku klasy rozmiaru okna Rozszerzone. Na bardzo dużym monitorze stacjonarnym klient poczty e-mail może elegancko wyświetlać 3 lub nawet 4 panele – na przykład skrzynkę pocztową, listę wiadomości, pełną treść wiadomości oraz panel kalendarza lub zadań – wszystko naraz.

Dzięki udostępnieniu oficjalnych punktów przerwania dla bardzo dużych wyświetlaczy biblioteka WindowManager 1.5 daje wyraźny sygnał do wprowadzenia układów zaprojektowanych specjalnie z myślą o wydajnej pracy na komputerze z dużą ilością informacji.

Klasy rozmiaru okna można obliczyć za pomocą funkcji computeWindowSizeClass(), która jest funkcją rozszerzającą biblioteki androidx.window.core.layout i rozszerza typ Set<WindowSizeClass>. 

Aby uwzględnić w projekcie nowe klasy rozmiarów okien, wywołaj funkcję z zestawu WindowSizeClass.BREAKPOINTS_V2 zamiast z zestawu WindowSizeClass.BREAKPOINTS_V1:

val currentWindowMetrics =

    WindowMetricsCalculator.getOrCreate()

    .computeCurrentWindowMetrics(LocalContext.current)


val sizeClass = WindowSizeClass.BREAKPOINTS_V2

    .computeWindowSizeClass(currentWindowMetrics)

Następnie zastosuj odpowiedni układ, gdy będziesz mieć pewność, że aplikacja ma co najmniej tyle miejsca:

if(sizeClass.isWidthAtLeastBreakpoint(

    WindowSizeClass.WIDTH_DP_LARGE_LOWER_BOUND)){

    ...

    // window is at least 1200 dp wide


}

Biblioteki adaptacyjne

Biblioteka Compose Material 3 Adaptive pomaga tworzyć adaptacyjne interfejsy, które automatycznie dostosowują się do bieżących konfiguracji okna, takich jak klasy rozmiaru okna czy orientacja urządzenia. 

Dobra wiadomość jest taka, że biblioteka jest już aktualna i zawiera nowe punkty przerwania. Począwszy od wersji 1.2 (obecnie w fazie Release Candidate) domyślne dyrektywy szkieletu panelu obsługują klasy rozmiarów okien o dużej i bardzo dużej szerokości.

Wystarczy, że zadeklarujesz w pliku kompilacji Gradle, że chcesz używać nowych punktów przerwania:

currentWindowAdaptiveInfo(

    supportLargeAndXLargeWidth = true)

Dodatkowe ulepszenia

• Osadzanie aktywności – autozapis i przywracanie: WindowManager może teraz automatycznie zapisywać i przywracać stan podziałów osadzania aktywności. Pomaga to zachować układ użytkownika podczas ponownego tworzenia procesu, co zapewnia większą stabilność i spójność. Deweloperzy nie muszą już ręcznie zapisywać i przywracać stanu, ale mogą po prostu włączyć automatyczne zapisywanie, ustawiając właściwość EmbeddingConfiguration#isAutoSaveEmbeddingState.
• Rozszerzone WindowMetrics: możesz teraz obliczać WindowMetrics w kontekście aplikacji, a nie tylko w kontekście aktywności. Zapewnia to większą elastyczność w dostępie do informacji o oknie z różnych części aplikacji.

Od czego zacząć

Aby zacząć używać w projektach na Androida nowych klas rozmiarów Duży i Bardzo duży oraz innych funkcji w wersji 1.5, zaktualizuj zależności aplikacji w pliku build.gradle.kts do najnowszej stabilnej wersji:

dependencies {
    implementation("androidx.window:window:1.5.0") 

    // or, if you're using the WindowManager testing library:

    testImplementation("androidx.window:window-testing:1.5.0")

}

WindowManager 1.5 to kolejny krok w tworzeniu w pełni adaptacyjnych aplikacji, które działają na różnych urządzeniach z Androidem. Pełną listę zmian i poprawek błędów znajdziesz w oficjalnych informacjach o wersji.

Miłego kodowania!