WindowManager

Biblioteka Jetpack WindowManager umożliwia deweloperom aplikacji obsługę nowych form urządzeń i środowisk z wieloma oknami. Pierwsza wersja jest przeznaczona na urządzenia składane, ale w przyszłości będzie obsługiwać więcej typów wyświetlaczy i funkcji okien.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja Beta Wersja alfa
2 lipca 2025 r. 1.4.0 - 1.5.0-beta01 -

Deklarowanie zależności

Aby dodać zależność od WindowManager, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Groovy

dependencies {
    implementation "androidx.window:window:1.4.0"

    // For Java-friendly APIs to register and unregister callbacks
    implementation "androidx.window:window-java:1.4.0"

    // For RxJava2 integration
    implementation "androidx.window:window-rxjava2:1.4.0"

    // For RxJava3 integration
    implementation "androidx.window:window-rxjava3:1.4.0"

    // For testing
    implementation "androidx.window:window-testing:1.4.0"
}

Kotlin

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

    // For Java-friendly APIs to register and unregister callbacks
    implementation("androidx.window:window-java:1.4.0")

    // For RxJava2 integration
    implementation("androidx.window:window-rxjava2:1.4.0")

    // For RxJava3 integration
    implementation("androidx.window:window-rxjava3:1.4.0")

    // For testing
    implementation("androidx.window:window-testing:1.4.0")
}

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.5

Wersja 1.5.0-beta01

2 lipca 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Wersja 1.5.0-alpha02

7 maja 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj punkty przerwania WindowSizeClass dla dużych i bardzo dużych ekranów. (I40d85)
  • Rozwiń obliczanie WindowMetrics do kontekstu aplikacji. (I8eeeb, b/360934048)
  • Dostawca funkcji pobierającej, która umożliwia bezpośredni dostęp do WindowLayoutInfo (Ie9513)
  • Wprowadzenie interfejsu API do automatycznego zapisywania stanu osadzania i automatycznego przywracania stanu osadzania po ponownym uruchomieniu procesu aplikacji. (Ie0295)
  • Usunięcie eksperymentalnego interfejsu API WindowInsets. (I68a71)
  • Ukrywanie kilku zespołów (I87b8d)

Poprawki błędów

  • Poprawka: w niektórych przypadkach funkcja EmbeddingRule zwracała inne wartości hashCode. (I748cc)

Wersja 1.5.0-alpha01

12 marca 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Pierwsza wersja 1.5.0.

Wersja 1.4

Wersja 1.4.0

20 maja 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0 Wersja 1.4.0 zawiera te zmiany.

Ważne zmiany od wersji 1.3.0

  • Umieszczanie aktywności
    • Interfejs API do dostosowywania animacji uruchamiania
    • Interaktywny separator
    • ActivityStack Przypinanie
    • Przyciemnianie okna pełnoekranowego
    • Wywołanie zwrotne informacji o umieszczonym oknie aktywności
    • Ulepszone ActivityStack zarządzanie
    • Uruchamianie aktywności w określonym ActivityStack
  • WindowMetricsCalculator
    • Ulepszona obsługa testowania
  • WindowMetrics
    • Wygodne metody obliczania wartości withDp i heightDp
    • Zaktualizuj sprawdzanie zakresu do isAtLeast i użyj dolnych granic, aby umożliwić dodawanie nowych wartości
  • WindowSizeClass
    • Dodaj sposób obliczania z usługi WindowMetrics
  • WindowInfoTracker
    • Dodanie interfejsu API do wykrywania obsługiwanych pozycji na urządzeniu

Wersja 1.4.0-rc02

23 kwietnia 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-rc02 Wersja 1.4.0-rc02 zawiera te zmiany.

Poprawki błędów

  • Naprawianie awarii narzędzia ProGuard w przypadku ActivityEmbedding.

Wersja 1.4.0-rc01

12 marca 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-rc01 Wersja 1.4.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Aktualizacje interfejsu WindowSizeClass API.
  • Zmiany w interfejsach API do osadzania aktywności.

Wersja 1.4.0-beta02

12 lutego 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-beta02 Wersja 1.4.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Naprawianie adnotacji, która była tylko w usłudze, ale nie w metodzie pobierającej.

Wersja 1.4.0-beta01

15 stycznia 2025 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Dodaj interfejs API, aby umożliwić dostosowywanie ActivityEmbeddinganimacji.
  • Rozwiń WindowMetricsCalculator test APIs, aby umożliwić fałszowanie danych okna.

Zmiany w interfejsie API

  • Ukrywanie kilku zespołów (I87b8d)
  • Zezwalaj aplikacjom na dostosowywanie animacji ActivityEmbedding (If31a8)
  • Dodano obsługę watchosDeviceArm64 KMP i wersji Kotlin 1.9 (Icf15d, b/364652024)
  • Udostępniaj interfejsy API WindowMetricsCalculator. (I1cebf)

Poprawki błędów

  • Ta biblioteka używa teraz adnotacji o wartości null JSpecify, które są używane w typach. Deweloperzy korzystający z języka Kotlin powinni używać tego argumentu kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict (jest to domyślne ustawienie od wersji 2.1.0 kompilatora Kotlin). (Ie69ac, b/326456246)

Wersja 1.4.0-alpha05

16 października 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-alpha05 Wersja 1.4.0-alpha05 zawiera te zmiany.

Nowe funkcje

  • Dodaj funkcje ułatwiające uzyskanie wartości widthDp i heightDp z WindowMetrics.

Zmiany w interfejsie API

  • Dodaj użytkowników widthDp i heightDp do listy WindowMetrics. (Ide026)
  • Usunięcie eksperymentalnego interfejsu API WindowInsets. (I68a71)
  • Zmiana nazw metod sprawdzania zakresu na isAtLeast (Ib0ab7)

Wersja 1.4.0-alpha04

2 października 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-alpha04 Wersja 1.4.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano metodę obliczania WindowSizeClass na podstawie WindowMetrics. (874dba)
  • Zmień metody WindowSizeClass na containsWidthDp, containsHeightDp i containsWindowSizeDp, aby były bardziej przejrzyste. (fa760d)
  • Przekształć WindowAreaController w abstrakcyjną klasę bazową. (I90893)

Poprawki błędów

  • Dodanie obsługi względnych granic podczas tworzenia testu FoldingFeature. (2e6b3e)
  • Ogólne poprawki błędów podczas wybierania WindowSizeClass.

Wersja 1.4.0-alpha03

18 września 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-alpha03 Wersja 1.4.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Dodaj metodę narzędziową, aby uzyskać WindowSizeClass z WindowMetrics. (I83f1f)
  • Zmień nazwę isAtLeast na containsBreakpoint. (I85b47)
  • Dodaj przeciążenie do computeWindowSizeClass za pomocą liczb zmiennoprzecinkowych. (I3dcb2, b/364677934, b/364677802, b/364680886)

Poprawki błędów

  • Dodaj brakujące punkty przerwania do domyślnego zestawu punktów przerwania WindowSizeClass.
  • Naprawiliśmy błąd, który w niektórych przypadkach powodował nieprawidłowe wybieranie kompaktowych wymiarów.

Wersja 1.4.0-alpha02

4 września 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-alpha02 Wersja 1.4.0-alpha02 zawiera te zmiany.

Nowe funkcje

Dodaliśmy obsługę niestandardowych właściwości WindowSizeClass.

  • Otwórz konstruktor WindowSizeClass, aby programiści mogli używać własnych.
  • Dodaj metody narzędziowe isAtLeast, aby programiści mogli przetwarzać zakres wartości WindowSizeClass.
  • Dodaj funkcję rozszerzenia w Set<WindowSizeClass>, aby obliczyć najlepsze dopasowanie z zestawu.
  • Dodaj stałe dla zalecanych punktów przerwania na Androidzie.
  • Dodaj zestaw punktów przerwania odpowiadający zalecanym punktom przerwania na Androidzie.

Zmiany w interfejsie API

  • Zaktualizuj nazwy metod granic dla WindowSizeClass. (If89a6)
  • Zaktualizuj interfejs API WindowSizeClass, aby w przyszłości można było dodawać nowe wartości punktów przerwania. Zamiast granic bezwzględnych używamy dolnych granic i zalecamy programistom, aby podczas przetwarzania WindowSizeClass sprawdzali dolną granicę. Obecne wersje WindowWidthSizeClass i WindowHeightSizeClass zostaną wycofane, ponieważ nie będą już rozwijane. (I014ce)

Wersja 1.4.0-alpha01

7 sierpnia 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Przypinanie stosu aktywności umożliwia aplikacjom przypinanie treści w jednym kontenerze i odseparowanie nawigacji od drugiego kontenera.
  • Interaktywny separator umożliwia aplikacjom wyświetlanie stałego lub przesuwanego separatora między 2 aktywnościami w prezentacji podzielonej.
  • Przyciemnianie okna dialogowego na pełnym ekranie umożliwia aplikacjom określenie obszaru przyciemniania okna dialogowego, aby przyciemnić całe okno zadania lub tylko kontener, w którym wyświetla się okno dialogowe.
  • Embedded Activity Window Info Callback umożliwia aplikacjom ciągłe otrzymywanie aktualizacji osadzonego okna aktywności.
  • Osadzanie tła animacji umożliwia aplikacjom określanie tła animacji, co poprawia jakość animacji przejścia, gdy używany jest element ActivityEmbedding.
  • Ulepszone zarządzanie ActivityStack umożliwia aplikacjom większą kontrolę nad ActivityStacks, gdy używana jest ActivityEmbedding, w tym:
  • Uruchamianie aktywności w określonym ActivityStack
  • Kończenie ActivityStack

Zmiany w interfejsie API

  • Nowy interfejs API WindowInfoTracker#supportedPostures:

    • Interfejs API, który określa, czy urządzenie obsługuje tryb TableTop w przypadku urządzeń składanych. Dodaje WindowAreaSessionPresenter#getWindow

  • Dodaj interfejsy API, aby obsługiwać ActivityStack przypinanie:

    • SplitPinRule zajęcia
    • SplitController#pinTopActivityStack
    • SplitController#unpinTopActivityStack

  • Dodaj interfejsy API, aby włączyć i skonfigurować interaktywny separator.

    • DividerAttributes zajęcia
    • SplitAttributes.Builder#setDividerAttributes

  • Dodawanie interfejsów API do ustawiania wartości EmbeddingConfiguration i DimAreaBehavior w przypadku okien

    • EmbeddingConfiguration zajęcia
    • DimAreaBehavior zajęcia
    • ActivityEmbeddingController#setEmbeddingConfiguration

  • Dodawanie interfejsów API w celu otrzymywania aktualizacji informacji o oknie aktywności osadzonej

    • EmbeddedActivityWindowInfo zajęcia
    • ActivityEmbeddingController#embeddedActivityWindowInfo

  • Dodawanie interfejsów API do ustawiania tła animacji osadzania

    • EmbeddingAnimationBackground
    • SplitAttributes.Builder#setAnimationBackground

  • Dodaj interfejsy API, aby zakończyć ActivityStacks

    • ActivityEmbeddingController#finishActivityStacks

  • Dodawanie interfejsów API do konfigurowania uruchamiania ActivityStack

    • ActivityEmbeddingOptions#setLaunchingActivityStack

  • Te interfejsy API są stabilne i nie są już eksperymentalne:

    • ActivityEmbeddingController#invalidateVisibleActivityStacks (przeniesiono z SplitController#invalidateTopVisibleSplitAttributes)
    • ActivityEmbeddingController#getActivityStack
    • SplitController#updateSplitAttributes

  • Dodaj interfejsy API dla wersji 1.4. (I56774)

Poprawki błędów

  • Naprawiono błąd na niektórych urządzeniach, w przypadku których w sytuacji, gdy sesja jest aktywna, zwracana była wartość UNAVAILABLE zamiast ACTIVE.
  • Usuwa obsługę transferActivityToWindowArea na urządzeniach z vendorApiLevel 2 ze względu na niestabilną obsługę interfejsu API.
  • Wprowadzenie interfejsu API umożliwiającego przeciąganie do trybu pełnoekranowego w przypadku dzielnika z możliwością przeciągania w osadzaniu aktywności. (I645c9)
  • Zezwalaj aplikacjom na wyłączanie animacji ActivityEmbedding za pomocą parametrów animacji dla SplitAttributes. (Idc01a)
  • Usunęliśmy ręczne określanie dostępu do nowych interfejsów API platformy, ponieważ odbywa się to automatycznie za pomocą modelowania interfejsu API podczas korzystania z R8 z AGP 7.3 lub nowszym (np. R8 w wersji 3.3) oraz w przypadku wszystkich kompilacji podczas korzystania z AGP 8.1 lub nowszego (np. D8 w wersji 8.1). Klienci, którzy nie korzystają z AGP, powinni zaktualizować D8 do wersji 8.1 lub nowszej. Więcej szczegółów znajdziesz w tym artykule. (Ia60e0, b/345472586)
  • Zezwól rozszerzeniom na pobieranie parametrów animacji dla SplitAttributes, aby urządzenie mogło ich używać do przejść animacji. (Iede00)
  • Ukrywanie interfejsów API nakładki (Ic4251)
  • Wprowadzenie interfejsów API do konfigurowania stałego lub przesuwanego separatora w podziale (Ia7a78)
  • Dodano gęstość do WindowMetrics (Id6723)
  • Dodano interfejs API, aby uzyskać SupportedPostures. (If557a)
  • Usuwanie setLaunchingActivityStack z eksperymentalnego interfejsu API (I191cf)
  • Wprowadzenie ActivityEmbeddingController#embeddedActivityWindowInfo (I24312)
  • Wycofaj #getToken i dodaj #getActivityStackToken (Ie0471)
  • Wprowadzenie adaptera wywołania zwrotnego dla interfejsu API przepływu embeddedActivityWindowInfo (Ida77f)
  • Dodanie adaptera wywołania zwrotnego do interfejsu overlayInfo flow API (I7264f)
  • Wprowadź WindowSdkExtensionsRule, aby zastąpić extensionsVersion na potrzeby testowania. (Ifb928)
  • – Przenieś #setLaunchingActivityStack do pakietu, aby zapewnić zgodność z użyciem ActivityOptionsCompat.
    • Użytkownicy powinni przekazywać wartość activityOptions.toBundle zamiast samego znaku ActvityOptions.
    • Usuń #setLaunchingActivityStack(Activity). Użytkownicy powinni przejść na ActivityEmbeddingController#getActivityStac(Activity), aby uzyskać ActivityStack, i przekazać ActivityStack do #setLaunchingActivityStack. (Ie0ccc)
  • – Wprowadź identyfikatory ActivityStack.Token i SpltInfo.Token, aby umożliwić komunikację między WM Jetpack a rozszerzeniami.
    • Wycofanie/zastąpienie interfejsów API, aby przyjmować/zwracać token zamiast IBinder. (I12b24)
  • – Przedstaw ActivityEmbeddingController#invalidateVisibleActivityStacks
    • Usuń SplitController#invalidateTopVisibleSplitAttributes, ponieważ ta funkcja została połączona z funkcją #invalidateVisibleActivityStacks (I02ef5)
  • – dodanie interfejsu API do ustawiania konfiguracji osadzania, (I59a4a)
  • – Dodawanie przypinania i odpinania najpopularniejszych interfejsów API ActivityStack androidx.Window
    • Aktualizacja aplikacji demonstracyjnej, która umożliwia przypinanie i odpinanie u góry ActivityStack (I24dd3)
  • Ponownie dodaj #finishActivityStacks i ActivityEmbeddingOptions (Ic1ab3)
  • Usuń niestabilne interfejsy API. (Ibc534, b/302380585)

Wersja 1.3

Wersja 1.3.0

29 maja 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Ważne zmiany od wersji 1.2.0

  • Obsługa Kotlin Multiplatform w przypadku klas rozmiaru okna.

Wersja 1.3.0-rc01

14 maja 2024 r.

WindowManager Jetpack 1.3 obsługuje Kotlin Multiplatform w przypadku WindowSizeClass funkcji, a także zawiera wiele poprawek błędów.

Zostanie wycofaneandroidx.window:window-*:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te commity.

Wersja 1.3.0-beta02

1 maja 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.3.0-beta02 Wersja 1.3.0-beta02 zawiera te zmiany.

Zmiany w interfejsie API

  • Usunięcie obsługi tworzenia i używania niestandardowych WindowSizeClass. (Id1143)

Poprawki błędów

  • Poprawki KotlinReflectionInternalError spowodowane usunięciem niektórych plików przez ProGuard na niektórych urządzeniach. (I01b02)

Wersja 1.3.0-beta01

3 kwietnia 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

Wersja 1.3.0-alpha03

6 marca 2024 roku

Zostanie wycofaneandroidx.window:window-*:1.3.0-alpha03 Wersja 1.3.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

  • Podziel WindowSizeClassUtil na bardziej szczegółowe metody. (Ie9292)
  • Przywróć WindowSizeClass#compute (I21355, b/324293374)

Poprawki błędów

  • Rozwiązaliśmy problem z awarią, która występowała, gdy kontekst nie był prawidłowo rozpakowywany. (94d10ce , b/318787482)

Wersja 1.3.0-alpha02

7 lutego 2024 r.

Zostanie wycofaneandroidx.window:window-*:1.3.0-alpha02 Wersja 1.3.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Zmiany wprowadzone w interfejsie API klasy rozmiaru okna, aby zwiększyć elastyczność deweloperów, którzy chcą używać własnych klas rozmiaru.

Zmiany w interfejsie API

  • Dodaj ograniczenia wysokości do selektora szerokości. (I23393)
  • Dodaj funkcje narzędziowe do wybierania WindowSizeClass z zestawu. Dodanie eksperymentalnych funkcji oceniania, aby deweloperzy mogli pisać własne selektory. Dodaj funkcję rozszerzenia selektora, aby wybrać najszerszy znak WindowSizeClass w danym zakresie. (I0c944)
  • Otwórz konstruktor WindowSizeClass, aby dodać niestandardowe punkty przerwania. (Ic1ff3)
  • Dodano funkcję ułatwiającą tworzenie klasy rozmiaru na podstawie szerokości, wysokości i gęstości. (If67f4)

Poprawki błędów

  • Naprawiono wyjątek, gdy wartość zmiennoprzecinkowa jest obcinana do 0. (272ffac)

Wersja 1.3.0-alpha01

15 listopada 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do tworzenia FoldingFeature są już stabilne.
  • Interfejsy API do testowania ustawiania fałszywych wartości ActivityEmbedding są już stabilne.
  • WindowLayoutInfoPublisherRule zgłasza teraz zastąpienie podczas pobierania wartości z UiContext.
  • WindowInfoTracker raportuje dane funkcji składania do parametrów UiContext.
  • Udostępnianie wersji rozszerzeń na urządzeniu.
  • WindowProperties stałe dotyczące zastąpień ustawień aplikacji przez użytkownika:
    • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE – informuje system, że aplikacja zrezygnowała z funkcji zastępowania zgodności z formatem obrazu widocznym dla użytkownika.
    • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE– informuje system, że aplikacja zrezygnowała z opcji pełnoekranowej w ustawieniach zastępowania zgodności z proporcjami obrazu użytkownika.

Wersja 1.2

Wersja 1.2.0

15 listopada 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0 Wersja 1.2.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do tworzenia FoldingFeature są już stabilne.
  • Interfejsy API do testowania ustawiania fałszywych wartości ActivityEmbedding są już stabilne.
  • WindowLayoutInfoPublisherRule zgłasza teraz zastąpienie podczas pobierania wartości z UiContext.
  • WindowInfoTracker raportuje dane funkcji składania do parametrów UiContext.
  • Udostępnianie wersji rozszerzeń na urządzeniu.

Wersja 1.2.0-rc01

1 listopada 2023 roku

Zostanie wycofaneandroidx.window:window-*:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do tworzenia FoldingFeature są już stabilne.
  • Interfejsy API do testowania ustawiania fałszywych wartości ActivityEmbedding są już stabilne.
  • WindowLayoutInfoPublisherRule zgłasza teraz zastąpienie podczas pobierania wartości z UiContext.
  • WindowInfoTracker raportuje dane funkcji składania do parametrów UiContext.
  • Udostępnianie wersji rozszerzeń na urządzeniu.

Wersja 1.2.0-beta04

18 października 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-beta04 Wersja 1.2.0-beta04 zawiera te zmiany.

Zmiany w interfejsie API

Wersja 1.2.0-beta03

20 września 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-beta03 Wersja 1.2.0-beta03 zawiera te zmiany.

Nowe funkcje

  • Dodaj sprawdzanie RequiresApi w przypadku interfejsów API, które do prawidłowego działania wymagają określonej wersji rozszerzeń.
  • Dodaj interfejs API, aby udostępnić wersję rozszerzeń na urządzeniu.

Zmiany w interfejsie API

  • Dodaj adnotacje do wymaganej wersji rozszerzenia pakietu SDK okna w publicznych interfejsach API.
    • Usuń isXXXSupported w komponencie osadzania aktywności. (Ie3dae)
  • Wprowadź WindowSdkExtensions, aby zgłosić wersję rozszerzenia na urządzeniu.
    • Wprowadzamy adnotację RequiresWindowSdkExtension, aby oznaczać minimalną wymaganą wersję rozszerzenia. (I05fd4)
  • Sprawia, że WindowAreaInfo#getCapability nie może mieć wartości null. (I17048)

Wersja 1.2.0-beta01

26 lipca 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do tworzenia FoldingFeature są już stabilne.
  • Interfejsy API do testowania ustawiania fałszywych wartości ActivityEmbedding są już stabilne.
  • WindowLayoutInfoPublisherRule zgłasza teraz zastąpienie podczas pobierania wartości z UiContext.
  • WindowInfoTracker raportuje dane funkcji składania do parametrów UiContext.

Zmiany w interfejsie API

  • Oznacza interfejs API WindowArea jako eksperymentalny, aby umożliwić dalsze zmiany interfejsu API w stabilnej wersji 1.3 (I857f5).
  • Zaktualizowano pliki interfejsu API, aby dodać adnotacje dotyczące wyłączenia zgodności (I8e87a, b/287516207).

Wersja 1.2.0-alpha03

21 czerwca 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-alpha03 Wersja 1.2.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Usunięcie wycofanych interfejsów API z powierzchni interfejsu API.
  • Dodaj interfejsy API obsługujące wyświetlanie równoczesne.
  • Dodaj właściwość, aby zrezygnować z wymuszonego zastępowania zmiany rozmiaru.
  • Dodaj właściwość, aby zrezygnować z zastępowania minimalnych proporcji.
  • Stabilizacja ActivityEmbeddingRule na potrzeby testów jednostkowych związanych z osadzaniem aktywności.

Zmiany w interfejsie API

  • Usuwanie wycofanych interfejsów API (I18d39)
  • Dodaliśmy obsługę wyświetlania równoczesnego. (Ifcbb0)

Poprawki błędów

  • Dodawanie właściwości umożliwiającej rezygnację z zastępowania wymuszonego zmiany rozmiaru (Ie7ab1)
  • Usuwa SESSION_STATE_CONTENT_INVISIBLE z interfejsu rozszerzeń. (I6ed19)
  • Stabilizacja ActivityEmbeddingRule na potrzeby testów jednostkowych związanych z osadzaniem aktywności. (I8d6b6)
  • Dodawanie właściwości wykluczenia w celu zastąpienia minimalnego współczynnika proporcji. (I66390)
  • Usuwa wycofane interfejsy WindowArea API (Ieb67c)
  • Zmień nazwę właściwości pętli żądania orientacji na PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED. (Ie2fbd)
  • Aktualizuje nazwy stałych sesji obszaru okna (I83675)
  • Dodanie właściwości zgodności rezygnacji, która ignoruje pętlę żądania orientacji po wykryciu (I0a7a2)
  • Dodaj WindowAreaComponent#STATUS_ACTIVE, aby wskazać, że funkcja jest już aktywna. (I62bc3)
  • Dodawanie interfejsów API RearDisplayPresentationMode (I0401c)
  • Interfejs API do usuwania koloru tła w wersji stabilnej. (I34c3e)
  • Ukryj interfejsy API obszaru okna. (I39de0)
  • Dodaj metody zastępowania SplitInfo w klasie SplitController. Dodaj metody testowe, aby utworzyć podwójne wartości dla SplitInfo i ActivityStack. (Icd69f)
  • Oznacz tag jako opcjonalny dla ActivityRule.Builder. (Ib0b44)
  • Usuń RatioSplitType, ExpandContainersSplit i HingeSplitType. Są SplitType.
    • Zastąp #splitEqually(), #expandContainers() i #splitByHinge stałymi wartościami SplitType SPLIT_TYPE_EQUAL, SPLIT_TYPE_EXPAND i SPLIT_TYPE_HINGE
    • Usunięcie funkcji ustawiania typu rezerwowego dla typu podziału zawiasu. Jeśli typu podziału zawiasu nie można zastosować ze względu na bieżący stan urządzenia lub okna, następuje powrót do równomiernego podziału kontenera zadania nadrzędnego. Użyj SplitController#setSplitAttributesCalculator, aby dostosować typ podziału rezerwowego. (Ifcc59)
  • Wycofaj add/removeSplitCallback
    • Przenieś add/removeSplitCallback do SplitControllerCallbackAdapter
    • Dodaj obsługę Flow, aby uzyskać listę SplitInfo (I7f1b6)
  • Dodaj regułę testową dla ActivityEmbeddingController (I42e9b)
  • Zmieniam nazwę ActivityOptionsCompat na ActivityEmbeddingOptions (I89301)
  • Dodaj splitSupportStatus, aby wskazać, czy osadzanie aktywności jest dostępne. (I10024)
  • Wprowadź SplitAttributes.BackgroundColor, aby lepiej odzwierciedlać wartość DEFAULT. Wyjaśniliśmy, że nieprzezroczysty kolor tła animacji nie jest obsługiwany, więc wszystkie nieprzezroczyste kolory będą traktowane jako domyślne, co oznacza użycie bieżącego koloru tła okna motywu. (Ic6b95)
  • Zastąp alwaysAllow() i alwaysDisallow() znakami ALWAYS_ALLOW i ALWAYS_DISALLOW. (I3057b)
  • Dodaj interfejsy API dla SplitRule, SplitAttributes, SplitAttributesCalculator. (I92d23)
  • Dodaj TestActivityStack, aby utworzyć ActivityStack na potrzeby testowania.
    • Dodaj TestSplitInfo, aby utworzyć SplitInfo na potrzeby testowania. (I8e779)
  • Dodaj możliwość tworzenia fałszywych SplitAttributesCalculatorParams, aby deweloperzy mogli weryfikować dostosowane SplitAttributesCalculator (Id4a6e).
  • Dodaj WindowMetricsCalculator#computeCurrentWindowMetrics(@UiContext context: Context) i WindowMetricsCalculator#computeMaximumWindowMetrics(@UiContext context: Context) (I66c7f)

Wersja 1.2.0-alpha02

7 czerwca 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-alpha02 Wersja 1.2.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Zaktualizuj testowy interfejs API, aby zawierał stałą wartość dla nieokreślonych funkcji składania.
  • Zastąpienie za pomocą WindowLayoutInfoPublishRule spowoduje zastąpienie wszystkich wartości windowLayoutInfo, w tym interfejsu Context API.

Zmiany w interfejsie API

  • Dodano stałą dla nieokreślonej funkcji składania na środku. (I7530c)

Poprawki błędów

  • Zaktualizuj WindowLayoutInfoPublishRule, aby obsługiwać zastąpienia w Context na podstawie WindowLayoutInfo. (I2037a)

Wersja 1.2.0-alpha01

24 maja 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zmiany.

Nowe funkcje

Stabilizacja interfejsów API do testowania w zakresie osadzania aktywności i WindowLayoutInfoTracker. ActivityEmbeddingRule została promowana do wersji stabilnej. WindowMetricsCalculatorRule została promowana do wersji stabilnej. Funkcje narzędziowe do tworzenia FoldingFeature na potrzeby testów zostały przeniesione do wersji stabilnej.

Zmiany w interfejsie API

  • Stabilizacja ActivityEmbeddingRule na potrzeby testów jednostkowych związanych z osadzaniem aktywności. (I8d6b6)
  • WindowMetrisCalculatorTestRule jest stabilna i umożliwia testowanie metryk zastępczych w przypadku testów JVM. Aby uzyskać dokładne wyniki, zalecamy użycie emulatora.
  • Stabilizacja interfejsów API testów dla WindowLayoutInfo w celu obsługi testowania na maszynie JVM. (Ie036e)
  • Dodaj IntRange dla wartości funkcji testowego składania. (I69f7d)

Wersja 1.1

Wersja 1.1.0

7 czerwca 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.1.0 Wersja 1.1.0 zawiera te zmiany.

Ważne zmiany od wersji 1.0.0

Umieszczanie aktywności

  • Dodano PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED jako właściwość logiczną tagu <application> w pliku manifestu aplikacji.
  • Wycofano isSplitSupported i zastąpiono splitSupportStatus, aby podawać bardziej szczegółowe informacje o tym, dlaczego funkcja podziału jest niedostępna.
  • Dodaliśmy zagnieżdżoną klasę SplitController.SplitSupportStatus, aby udostępniać stałe stanu dla właściwości splitSupportStatus.
  • Refaktoryzacja SplitController na kilka modułów:
    • moduł ActivityEmbeddingController dla interfejsów API powiązanych z Activity lub ActivityStack.
    • Element isActivityEmbedded został przeniesiony z SplitController do ActivityEmbeddingController.
    • moduł RuleController do operacji związanych z EmbeddingRule:
    • Usunięte interfejsy API:SplitController
    • clearRegisteredRules()
    • getSplitRules()
    • initialize()
    • registerRule()
    • unregisterRule()
    • Dodano interfejsy API: RuleController
    • addRule() – dodaje regułę lub aktualizuje regułę z tym samym tagiem.
    • removeRule() – usuwa regułę z kolekcji zarejestrowanych reguł.
    • setRules() – tworzy zbiór reguł.
    • clearRules() – usuwa wszystkie zarejestrowane reguły.
    • parseRules() – analizuje reguły z definicji reguł XML.
  • Wszystkie moduły wymagają zainicjowania kontekstu za pomocą metody #getInstance(), w tym:
    • ActivityEmbeddingController#getInstance(Context)
    • SplitController#getInstance(Context)
    • RuleController#getInstance(Context)
  • Dodano klasę EmbeddingAspectRatio, aby zdefiniować stałe zachowania podobne do wyliczeń związane z formatem obrazu.
  • Dodano klasę SplitAttributes, aby zdefiniować układ podzielony.
  • Dodano funkcje kalkulatora SplitAttributes do SplitController, aby dostosować układy podzielone:
    • setSplitAttributesCalculator(Function)
    • clearSplitAttributesCalculator()
    • isSplitAttributesCalculatorSupported(), aby sprawdzić, czy interfejsy API SplitAttributesCalculator są obsługiwane na urządzeniu.
  • Dodano pole EmbeddingRule#tag.
  • Aktualizacje interfejsu API w SplitRule:
    • Dodano defaultSplitAttributes – określa domyślny układ podziału; zastępuje splitRatio i layoutDirection.
    • Dodaliśmy tłumaczenie właściwości XML splitRatio i splitLayoutDirection na język defaultSplitAttributes.
    • Zmieniliśmy definicje minimalnych wymiarów, aby używać pikseli niezależnych od gęstości (dp) zamiast pikseli.
    • Dodano minHeightDp z wartością domyślną 600 dp.
    • Zmieniono minWidth na minWidthDp z wartością domyślną 600 dp.
    • Zmieniono minSmallestWidth na minSmallestWidthDp z wartością domyślną 600 dp.
    • Dodano maxAspectRatioInHorizontal z wartością domyślną ALWAYS_ALLOW.
    • Dodano maxAspectRatioInPortrait z wartością domyślną 1,4.
    • Zdefiniowano zagnieżdżoną klasę FinishBehavior, która zastępuje stałe zachowania zakończenia.
    • Zastosowano zmiany właściwości w zagnieżdżonej klasie Builder w przypadku SplitPairRule i SplitPlaceholderRule.
  • Zastąpiliśmy symbol SplitInfo#getSplitRatio() symbolem SplitInfo#getSplitAttributes(), aby podać dodatkowe informacje dotyczące podziału.

WindowLayout

  • Dodaliśmy eksperymentalną obsługę kontekstu interfejsu użytkownika bez aktywności w WindowInfoTracker.
  • Dodano eksperymentalny kontekst interfejsu bez aktywności do WindowMetricsCalculator.

Etapy migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania aktywności w podziale ekranu, aplikacje muszą dodać właściwość PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED do tagu manifestu <application>: xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" /> Umożliwia to systemowi wcześniejsze zoptymalizowanie zachowań podziału ekranu w przypadku aplikacji.
  • SplitInfo ratio
    • Sprawdź, czy bieżący podział jest ułożony w stos:kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
    • Sprawdź bieżący stosunek:kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
  • Migracje SplitController:
    • SplitController.getInstance() zmienia się na SplitController.getInstance(Context).
    • SplitController.initialize(Context, @ResId int) zmienia się na RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int)).
    • SplitController.getInstance().isActivityEmbedded(Activity) zmienia się na ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity).
    • SplitController.getInstance().registerRule(rule) zmienia się na RuleController.getInstance(Context).addRule(rule).
    • SplitController.getInstance().unregisterRule(rule) zmienia się na RuleController.getInstance(Context).removeRule(rule).
    • SplitController.getInstance().clearRegisteredRules() zmienia się na RuleController.getInstance(Context).clearRules().
    • SplitController.getInstance().getSplitRules() zmienia się na RuleController.getInstance(Context).getRules().
  • SplitRule migracje usługi:
    • minWidth i minSmallestWidth używają teraz jednostek dp zamiast pikseli. Aplikacje mogą używać tego wywołania:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )lub po prostu podzielić minWith w pikselach przez displayMetrics#density.
  • Stałe zachowania zakończenia muszą zostać przeniesione do stałych klasy wyliczeniowej FinishBehavior:
    • FINISH_NEVER zmienia się na FinishBehavior.NEVER.
    • FINISH_ALWAYS zmienia się na FinishBehavior.ALWAYS.
    • FINISH_ADJACENT zmienia się na FinishBehavior.ADJACENT.
  • Kierunek układu musi zostać przeniesiony do SplitAttributes.LayoutDirection:
    • ltr zmienia się na SplitAttributes.LayoutDirection.LEFT_TO_RIGHT.
    • rtl zmienia się na SplitAttributes.LayoutDirection.RIGHT_TO_LEFT.
    • locale zmienia się na SplitAttributes.LayoutDirection.LOCALE.
    • splitRatio musi zostać przeniesiony do SplitAttributes.SplitType.ratio(splitRatio).
  • SplitPairRule.Builder migrations:
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) zmienia się na kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
    • Zmiany setLayoutDirection(layoutDirection) i setSplitRatio(ratio) na kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • setFinishPrimaryWithSecondary i setFinishSecondaryWithPrimary przyjmują FinishBehavior stałe podobne do wyliczeń. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • Naciśnij setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW), aby wyświetlić podziały na urządzeniach w trybie portretowym.
  • SplitPlaceholder.Builder migrations:
    • Ma tylko parametry filters i placeholderIntent. Pozostałe właściwości są przenoszone do funkcji ustawiających. Więcej informacji znajdziesz w sekcji „Migracje SplitPairRule.Builder”.
    • setFinishPrimaryWithPlaceholder przyjmuje stałe wyliczeniowe FinishBehavior. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • setLayoutDirection(layoutDirection) i setSplitRatio(ratio) zmienią się na:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • Naciśnij setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW), aby wyświetlić podziały na urządzeniach w trybie portretowym.

Wersja 1.1.0-rc01

10 maja 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Opublikuj ActivityEmbedding jako stabilny interfejs API.
  • Poprawki różnych błędów.

Wersja 1.1.0-beta02

5 kwietnia 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.1.0-beta02 Wersja 1.1.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Poprawki wewnętrzne i oczyszczenie kodu.

Wersja 1.1.0-beta01

22 marca 2023 r.

Zostanie wycofaneandroidx.window:window-*:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Umieszczanie aktywności

  • Dodano PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED jako właściwość logiczną tagu <application> w pliku manifestu aplikacji.
  • Wycofano isSplitSupported i zastąpiono splitSupportStatus, aby podawać bardziej szczegółowe informacje o tym, dlaczego funkcja podziału jest niedostępna.
  • Dodaliśmy zagnieżdżoną klasę SplitController.SplitSupportStatus, aby udostępniać stałe stanu dla właściwości splitSupportStatus.
  • Refaktoryzacja SplitController na kilka modułów:
    • moduł ActivityEmbeddingController dla interfejsów API powiązanych z Activity lub ActivityStack.
    • Element isActivityEmbedded został przeniesiony z SplitController do ActivityEmbeddingController.
    • moduł RuleController do operacji związanych z EmbeddingRule:
    • Usunięto interfejsy API SplitController:
      • clearRegisteredRules()
      • getSplitRules()
      • initialize()
      • registerRule()
      • unregisterRule()
    • Dodano interfejsy API RuleController:
      • addRule() – dodaje regułę lub aktualizuje regułę z tym samym tagiem.
      • removeRule() – usuwa regułę z kolekcji zarejestrowanych reguł.
      • setRules() – tworzy zbiór reguł.
      • clearRules() – usuwa wszystkie zarejestrowane reguły.
      • `parseRules()` – analizuje reguły z definicji reguł XML.
  • Wszystkie moduły wymagają zainicjowania kontekstu za pomocą metody #getInstance(), w tym:
    • ActivityEmbeddingController#getInstance(Context)
    • SplitController#getInstance(Context)
    • RuleController#getInstance(Context)
  • Dodano klasę EmbeddingAspectRatio, aby zdefiniować stałe zachowania podobne do wyliczeń związane z formatem obrazu.
  • Dodano klasę SplitAttributes, aby zdefiniować układ podzielony.
  • Dodano funkcje kalkulatora SplitAttributes do SplitController, aby dostosować układy podzielone:
    • setSplitAttributesCalculator(Function)
    • clearSplitAttributesCalculator()
    • isSplitAttributesCalculatorSupported() – sprawdź, czy interfejsy SplitAttributesCalculator API są obsługiwane na urządzeniu.
  • Dodano pole EmbeddingRule#tag.
  • Aktualizacje interfejsu API w SplitRule:
    • Dodano defaultSplitAttributes – określa domyślny układ podziału; zastępuje splitRatio i layoutDirection.
    • Dodaliśmy tłumaczenie właściwości XML splitRatio i splitLayoutDirection na język defaultSplitAttributes.
    • Zmieniliśmy definicje minimalnych wymiarów, aby używać pikseli niezależnych od gęstości (dp) zamiast pikseli.
    • Dodano minHeightDp z wartością domyślną 600 dp.
    • Zmieniono minWidth na minWidthDp z wartością domyślną 600 dp.
    • Zmieniono minSmallestWidth na minSmallestWidthDp z wartością domyślną 600 dp.
    • Dodano maxAspectRatioInHorizontal z wartością domyślną ALWAYS_ALLOW.
    • Dodano maxAspectRatioInPortrait z wartością domyślną 1.4.
    • Zdefiniowano zagnieżdżoną klasę FinishBehavior, która zastępuje stałe zachowania zakończenia.
    • Zastosowano zmiany właściwości w klasie zagnieżdżonej Builder w klasach SplitPairRule i SplitPlaceholderRule.
  • Zastąpiliśmy symbol SplitInfo#getSplitRatio() symbolem SplitInfo#getSplitAttributes(), aby podać dodatkowe informacje dotyczące podziału.

WindowLayout

  • Dodaliśmy do WindowInfoTracker obsługę kontekstu interfejsu użytkownika niezwiązanego z aktywnością.
  • Dodano kontekst interfejsu bez aktywności do WindowMetricsCalculator.

Etapy migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania aktywności w podziale ekranu, aplikacje muszą dodać właściwość PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED do tagu manifestu <application>: xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" /> Umożliwia to systemowi wcześniejsze zoptymalizowanie zachowań podziału ekranu w przypadku aplikacji.
  • SplitInfo ratio
    • Sprawdź, czy bieżący podział jest ułożony w stos:kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
    • Sprawdź bieżący stosunek:kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
  • SplitController migrations:
    • SplitController.getInstance() zmienia się na SplitController.getInstance(Context).
    • SplitController.initialize(Context, @ResId int) zmienia się na RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int)).
    • SplitController.getInstance().isActivityEmbedded(Activity) zmienia się na ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity).
    • SplitController.getInstance().registerRule(rule) zmienia się na RuleController.getInstance(Context).addRule(rule).
    • SplitController.getInstance().unregisterRule(rule) zmienia się na RuleController.getInstance(Context).removeRule(rule).
    • SplitController.getInstance().clearRegisteredRules() zmienia się na RuleController.getInstance(Context).clearRules().
    • SplitController.getInstance().getSplitRules() zmienia się na RuleController.getInstance(Context).getRules().
  • SplitRule migracje usługi:
    • minWidth i minSmallestWidth używają teraz jednostek dp zamiast pikseli. Aplikacje mogą używać tego wywołania:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )lub po prostu podzielić minWith w pikselach przez displayMetrics#density.
  • Stałe zachowania zakończenia muszą zostać przeniesione do stałych klasy wyliczeniowej FinishBehavior:
    • FINISH_NEVER zmienia się na FinishBehavior.NEVER.
    • FINISH_ALWAYS zmienia się na FinishBehavior.ALWAYS.
    • FINISH_ADJACENT zmienia się na FinishBehavior.ADJACENT.
  • Kierunek układu musi zostać przeniesiony do SplitAttributes.LayoutDirection:
    • ltr zmienia się na SplitAttributes.LayoutDirection.LEFT_TO_RIGHT.
    • rtl zmienia się na SplitAttributes.LayoutDirection.RIGHT_TO_LEFT.
    • locale zmienia się na SplitAttributes.LayoutDirection.LOCALE.
    • splitRatio musi zostać przeniesiony do SplitAttributes.SplitType.ratio(splitRatio).
  • SplitPairRule.Builder migrations:
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) zmienia się na kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
    • setLayoutDirection(layoutDirection) i setSplitRatio(ratio) zmienią się na kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • setFinishPrimaryWithSecondary i setFinishSecondaryWithPrimary przyjmują FinishBehavior stałe podobne do wyliczeń. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • Naciśnij setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW), aby wyświetlić podziały na urządzeniach w trybie portretowym.
  • SplitPlaceholder.Builder migrations:
    • Ma tylko parametry filters i placeholderIntent. Pozostałe właściwości są przenoszone do funkcji ustawiających. Więcej informacji znajdziesz w sekcji „Migracje SplitPairRule.Builder”.
    • setFinishPrimaryWithPlaceholder przyjmuje stałe wyliczeniowe FinishBehavior. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • setLayoutDirection(layoutDirection) i setSplitRatio(ratio) zmienią się na:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • Naciśnij setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW), aby wyświetlić podziały na urządzeniach w trybie portretowym.

Wersja 1.1.0-alpha06

22 lutego 2023 roku

Zostanie wycofaneandroidx.window:window-*:1.1.0-alpha06 Wersja 1.1.0-alpha06 zawiera te zmiany.

Nowe funkcje

  • Udostępnianie eksperymentalnej wersji pobierania WindowLayoutInfo z kontekstu interfejsu.

Zmiany w interfejsie API

  • Dodaj splitSupportStatus, aby wskazać, czy osadzanie aktywności jest dostępne. (I10024)
  • Oznacz interfejs UI Context WindowLayoutInfo API jako eksperymentalny. (I58ee0)
  • Wprowadza WindowAreaController i interfejsy API, które umożliwiają przeniesienie bieżącego okna do wyświetlacza wyrównanego z tylnym aparatem w RearDisplay. (Iffcbf)
  • Zaktualizuj domyślny kolor tła. (I1ac1b)
  • Dodaj parametry SplitAttributes. (I18bdd)
  • Dodaj interfejsy API dla SplitRule, SplitAttributes, SplitAttributesCalculator. (I92d23)
  • Ulepsz interfejsy API związane z maxAspectRatio:
    1. Zastąp alwaysAllow() i alwaysDisallow() znakami ALWAYS_ALLOW i ALWAYS_DISALLOW.
    2. Zaktualizuj dokumentację API @see za pomocą samodzielnej dokumentacji. (I3057b)
  • Te konstruktory zostały usunięte z publicznych interfejsów API, ponieważ aplikacje nie powinny ich wywoływać.
    • SplitInfo konstruktor
    • ActivityStack konstruktor (Ide534)
  • SplitRule akceptuje teraz maxAspectRatioInPortrait/Landscape. Umożliwia to tylko podział działań, gdy współczynnik proporcji obszaru nadrzędnego jest mniejszy lub równy żądanemu maxAspectRatio. (Ia5990)
  • Zmień wartość RuleController#parseRules na statyczną (I785df)
  • Ulepszanie interfejsów API związanych z ActivityEmbedding
    1. Ujednolicenie nazewnictwa interfejsu API – w przypadku wielu instancji używaj słów „dodaj” i „usuń”:
    2. registerRule zmienia się na addRule
    3. unregisterRule zmienia się na removeRule
    4. Zastąp getSplitRules wartością getRules, ponieważ ActivityRule nie jest regułą podziału.
    5. Dodaj RuleController#setRules, aby ustawić wiele reguł
    6. Wyodrębnij interfejsy API związane z regułą wyodrębniania z SplitController do pojedynczego RuleController. Oto oni:
    7. addRule
    8. removeRule
    9. getRules
    10. setRules
    11. clearRules
    12. parseRules
    13. Wyodrębnij #isActivityEmbedded z SplitController do singletonu ActivityEmbeddingController. Oto oni:
    14. isActivityEmbedded
    15. Usuń SplitController#initialize. Aby skonfigurować reguły z pliku XML, użyj poleceń RuleController#parseRules i #setRules. Przed tą zmianą:SplitController.initialize(context, R.xml.static_rules) Po tej zmianie:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
    16. Nie rozróżniamy już reguł statycznych od reguł czasu działania. Wywołanie #clearRules powoduje usunięcie wszystkich reguł, niezależnie od tego, czy zostały zarejestrowane za pomocą statycznych definicji reguł XML, czy w czasie działania programu. Aby przywrócić starsze działanie funkcji SplitController#clearRegisteredRules, wywołaj funkcję RuleController#parseRules z identyfikatorem zasobów XML i wywołaj funkcję RuleController#setRules, aby ponownie ustawić reguły. Przed zmianą:SplitController.getInstance(context).clearRegisteredRules() Po zmianie:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules) (Ib3967)
  • Ulepsz interfejsy SplitRule API:
    1. W przypadku SplitRule używaj minimalnych wymiarów w jednostkach DP zamiast w pikselach.
    2. Zmiana kodu, aby SplitRule Builder przyjmował minimalne wymiary jako opcjonalne. (I95f17)
  • Przekazywanie kontekstu do inicjowania SplitController (I42549)
  • Zmieniono nazwę SplitRule#layoutDir na #layoutDirection i SplitRule Builder#setLayoutDir na Builder#setLayoutDirection. (I3f6d1)

Wersja 1.1.0-alpha04

9 listopada 2022 r.

Zostanie wycofaneandroidx.window:window-*:1.1.0-alpha04 Wersja 1.1.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • Udostępnij metodę określania, czy element ActivityStack jest pusty w przypadku elementu ActivityEmbedding.
  • Usunięto tagi eksperymentalnych interfejsów API z ActivityEmbedding interfejsów API.
  • Ukryj konstruktor ActivityRule, ponieważ Builder jest preferowanym sposobem konstruowania.
  • Dodaj eksperymentalną metodę, aby uzyskać WindowInsets na WindowMetrics.
  • Zaktualizuj SplitPlaceholderFinishBehavior, aby zapobiec zakończeniu symbolu zastępczego. Ukończenie rezerwacji miejsca powodowało pewne niejasności.

Zmiany w interfejsie API

  • Ustaw wartość isEmpty jako publiczną, aby zastąpić funkcję isEmpty.
  • Zmień nazwy aktywności parametru ActivityStack na activitiesInProcess. (Ia5055)
  • Usuń ActivityFilter#matchesClassName i ActivityFilter#matchesClassNameOrWildCard, ponieważ są mylące.
  • Dodaj znaki ActivityFilter#componentName i ActivityFilter#intentAction, aby umożliwić dzwoniącemu rozróżnianie różnych filtrów (I41f22).
  • Usuń interfejsy API @Deprecated z eksperymentalnego interfejsu API (I216b3).
  • Usuń @ExperimentalWindowApi w przypadku interfejsów API do osadzania aktywności (I69ebe)
  • Ukryj konstruktor ActivityRule, zamiast tego użyj narzędzia Builder. (If4eb6)
  • Dodaj interfejsy API, aby sprawdzić, czy aktywność jest częścią ActivityFilter. (Ia43cf)
  • Aktualizowanie plików interfejsu API w celu odzwierciedlenia zmian w klasach WindowMetrics i WindowMetricsCalculatorCompat (I667fe)
  • Aktualizacja dokumentacji Javadoc usługi ActivityEmbedding i nazwy klasy (Ia1386)
  • Dodawanie nazw tagów właściwości ActivityEmbedding do użycia w pliku AndroidManifest.xml (Id1ad4)
  • Dodano nowe interfejsy API SplitPlaceholderFinishBehavior i SplitPlaceholderRule.finishPrimaryWithPlaceholder, które zastępują dotychczasowy interfejs SplitPlaceholderRule.finishPrimaryWithSecondary określający, kiedy kończą się działania zastępcze i jak powinny zachowywać się powiązane działania w osadzaniu aktywności. (I64647)

Poprawki błędów

  • Wprowadza WindowAreaController i interfejsy API, które umożliwiają przeniesienie bieżącego okna do wyświetlacza wyrównanego z tylnym aparatem w RearDisplay. (I388ab)

Wersja 1.1.0-alpha03

27 lipca 2022 roku

Zostanie wycofaneandroidx.window:window-*:1.1.0-alpha03 Wersja 1.1.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Zaktualizuj domyślne wartości reguł umieszczania.

Zmiany w interfejsie API

  • Aktualizowanie domyślnych wartości właściwości reguły umieszczania. (Ic4d35)

Wersja 1.1.0-alpha02

11 maja 2022 roku

Zostanie wycofaneandroidx.window:window-*:1.1.0-alpha02 Wersja 1.1.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Udostępnij biblioteki adapterów, aby obsługiwać Java i RxJava.

Wersja 1.1.0-alpha01

11 maja 2022 roku

Zostanie wycofaneandroidx.window:window-*:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Wydanie adapterów obsługujących Java i RxJava

Wersja 1.1.0-alpha01

20 kwietnia 2022 r.

Zostanie wycofaneandroidx.window:window:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Naprawiliśmy błąd, który powodował, że po przejściu aplikacji w tryb tła przestawała ona emitować funkcje związane ze składaniem.
  • Rozwijanie eksperymentalnego interfejsu ActivityEmbedding API.

Zmiany w interfejsie API

  • Publiczny interfejs API do sprawdzania, czy aktywność jest osadzana. (I39eb7)

Poprawki błędów

  • Dodano interfejsy API, które dostosowują zachowanie związane z zakończeniem działania kontenerów w podziałach aktywności (I1a1e4)
  • Dodaliśmy nową opcję konfiguracji reguł podziału aktywności. (Iec6af)

Wersja 1.0

Wersja 1.0.0

26 stycznia 2022 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0 Wersja 1.0.0 zawiera te zmiany.

Główne funkcje wersji 1.0.0

  • Obsługa telefonów składanych w wersjach WindowInfoTracker i FoldingFeature. WindowMetricsCalculator, aby obliczyć bieżące wartości WindowMetrics.

Wersja 1.0.0-rc01

15 grudnia 2021 roku

Zostanie wycofaneandroidx.window:window-*:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy obsługę telefonów składanych za pomocą WindowInfoTracker.
  • Dodaj metody obliczania bieżącego i maksymalnego WindowMetrics.
  • Dodaj pomocnicze interfejsy API testów.

Wersja 1.0.0-beta04

17 listopada 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-beta04 Wersja 1.0.0-beta04 zawiera te zmiany.

Nowe funkcje

  • Zmień nazwę WindowInfoRepository na WindowInfoTracker.
  • Ustaw Activity jako jawną zależność metody dla WindowInfoTracker.
  • Dodaj prostą regułę TestRule dla klasy WindowMetricsCalculator, aby obsługiwać deweloperów korzystających z biblioteki Robolectric.

Zmiany w interfejsie API

  • Wyodrębnianie rozszerzeń (I25a5f)
  • Dodanie isEmpty w ActivityStack (I5a4e6)
  • Zmień nazwę WindowInfoRepository na WindowInfoTracker.
    • Zaktualizuj zależności java/rxjava/testing, aby były zgodne. (I0da63)
  • Dodaj regułę testową dla prostego elementu WindowMetricsCalculator. (Ibacdb)

Wersja 1.0.0-beta03

27 października 2021 roku

Zostanie wycofaneandroidx.window:window-*:1.0.0-beta03 Wersja 1.0.0-beta03 zawiera te zmiany.

Nowe funkcje

  • Dodano eksperymentalne interfejsy Activity Embedding API. Ta początkowa wersja układu umożliwia wyświetlanie 2 aktywności obok siebie.

Zmiany w interfejsie API

  • Usunęliśmy interfejs API currentWindowMetrics, ponieważ nie możemy go dokładnie udostępniać. Zamiast tego użyj klasy WindowMetricsCalculator (Icda5f).
  • Zaktualizowano interfejs API rozszerzeń. (Ica92b)
  • Dodaliśmy interfejs nowej funkcji, która umożliwia osadzanie aktywności i wyświetlanie ich obok siebie w oknie zadania nadrzędnego. (I5711d)
  • Ukryto konstruktory klas WindowMetrics i WindowLayoutInfo. Zamiast nich używaj interfejsów API testów. (I5a1b5)
  • Dodaj interfejs API do tworzenia fałszywych obiektów WindowLayoutInfo. (I4a2fd)

Poprawki błędów

Wersja 1.0.0-beta02

1 września 2021 roku

Zostanie wycofaneandroidx.window:window-*:1.0.0-beta02 Wersja 1.0.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Dodaj adnotację eksperymentalną, aby oznaczyć eksperymentalne interfejsy API. (I9f1b6)
  • Dodaj metodę testową, aby utworzyć testową funkcję FoldingFeature, która akceptuje Rect. Ułatwi to testowanie za pomocą Robolectric zamiast rzeczywistego działania. (Id1cca)

Wersja 1.0.0-beta01

18 sierpnia 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Nowe funkcje

  • Usunięto stare stałe i przekształcono FoldingFeature w interfejs.

Zmiany w interfejsie API

  • Usuń stare stałe i przekształć FoldFeature w interfejs. (I9a2d5)

Poprawki błędów

  • Biblioteki, które są zależne od biblioteki Test Core, zostały zaktualizowane do wersji 1.4.0 i będą teraz działać na platformie Android w wersji S. (I88b72, b/189353863)

Wersja 1.0.0-alpha10

4 sierpnia 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zmiany.

Nowe funkcje

  • Zmień nazwę WindowInfoRepo na WindowInfoRepository i dostosuj odpowiednie klasy lub pliki.
  • Przekształć dane z bieżącego okna w Flow w klasie WindowInfoRepository, ponieważ wartość zmienia się z czasem.
  • Zmiana nazwy WindowInfoRepoJavaAdapter na WindowInfoRepoCallbackAdapter
  • Dodanie metody pomocniczej do tworzenia obiektów FoldingFeature na potrzeby testów
  • Zaktualizuj pakiety, aby grupować klasy na podstawie obsługiwanej przez nie funkcji.

Zmiany w interfejsie API

  • Zmiana nazwy ActivityExt na ActivityExtensions. Zmiana nazwy Repo na Repository. (I61a16)
  • Aktualizowanie pakietów zajęć. (I23ae2)
  • Usuwanie WindowMetrics z WindowInfoRepo (I24663)
  • Usuwanie WindowManager i używanie WindowInfoRepo
    • Ustawienie WindowBackend jako wewnętrznego. (I06d9a)
  • Przekształć dane okna w funkcję typu flow.
    • Zmiana nazwy adaptera Java na WindowInfoRepoCallbackAdapter
    • Usuń callbackFlow, aby nie używać już eksperymentalnych interfejsów API. (Ia4d15)
  • Dodaj metodę pomocniczą do tworzenia funkcji wyświetlania testów.
    • Zmiana z occlusionMode na occlusionType (If4cff)

Poprawki błędów

  • Naprawiono błąd narzędzia ProGuard, który powodował usuwanie biblioteki podstawowej.
  • Naprawiliśmy błąd, który powodował, że obiekt WindowLayoutInfo nie był dostarczany do dodatkowych subskrybentów.
  • Naprawiono błąd, w którym zmiany konfiguracji nie powodowały aktualizacji funkcji składania.

Wersja 1.0.0-alpha09

30 czerwca 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zmiany.

Nowe funkcje

  • Zmiana stałych całkowitych na nieograniczone wyliczenia.
  • Dodaj narzędzie testowe, aby tworzyć funkcje testowe składania.

Zmiany w interfejsie API

  • Dodaj metodę pomocniczą do tworzenia funkcji wyświetlania testów. (I3cf54)
    • Zmiana z occlusionMode na occlusionType.

Poprawki błędów

  • Emituj wartość początkową podczas dodawania wielu odbiorców strumieni danych.

Wersja 1.0.0-alpha08

16 czerwca 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zmiany.

Nowe funkcje

  • Udostępniliśmy artefakt testowy, aby ułatwić testowanie podczas korzystania z WindowInfoRepository. Użyj WindowInfoRepository, aby uzyskać informacje o DisplayFeatures i WindowMetrics. (I57f66, Ida620)

Wersja 1.0.0-alpha07

2 czerwca 2021 r.

Zostanie wycofaneandroidx.window:window-*:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zmiany.

Nowe funkcje

  • Migracja podstawowej biblioteki okien do języka Kotlin. Będzie używać korutyn i funkcji zawieszania do udostępniania danych asynchronicznych.
  • Dodaj WindowInfoRepo jako główny punkt interakcji do pobierania WindowMetrics i strumienia WindowLayoutInfo.
  • Nowy artefakt window-java, który udostępnia interfejsy API przyjazne dla języka Java do rejestrowania i wyrejestrowywania wywołań zwrotnych.
  • Nowe artefakty window-rxjava2 i window-rxjava3, które udostępniają interfejsy API dostosowane do RxJava.

Zmiany w interfejsie API

  • Dodaj WindowServices, aby zapewnić jednolite zależności.
    • Dodanie interfejsu API opartego na korutynach do wykorzystywania informacji o układzie okna. (Iab70f)
  • Przeniesienie głównej biblioteki menedżera okien do języka Kotlin. (Icca34)

Poprawki błędów

  • Dodaj nową klasę danych reprezentującą granice funkcji. (I6dcd1)

Wersja 1.0.0-alpha06

5 maja 2021 roku

Zostanie wycofaneandroidx.window:window:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zmiany.

Nowe funkcje

  • Rozpoczęliśmy migrację do języka Kotlin i zakończymy ją w kolejnej wersji.
  • Klasa DeviceState została usunięta z publicznego interfejsu API. Zamiast niej używaj klasy FoldingFeature.
  • Usunęliśmy stan STATE_FLIPPED z FoldingFeature, ponieważ nie jest on obecnie obsługiwany w żadnym przypadku użycia.
  • Usunęliśmy też inne wycofane interfejsy API.

Zmiany w interfejsie API

  • Dodawanie języka Kotlin jako zależności.
    • Przenieś podstawową bibliotekę na język Kotlin. (Idd995)
  • Usunięto narzędzie do tworzenia DisplayFeature. (I61fa4)
  • Usunięto DeviceState z publicznego interfejsu API. Zamiast niego używaj FoldingFeature. (Id6079)
  • Usuń wywołanie zwrotne stanu urządzenia z rozszerzeń. (I5ea83)
  • Usuń STATE_FLIPPED z FoldingFeature. (I9c4e1)
  • Usuń wycofane metody rejestracji. (Ib381b)

Wersja 1.0.0-alpha05

24 marca 2021 r.

Zostanie wycofaneandroidx.window:window:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

Dodaliśmy do klasy FoldingFeature wygodne metody, dzięki którym aplikacje mogą sprawdzać, czy funkcja rozdziela lub zasłania, oraz określać orientację zawiasu. Ukrywamy też typ zawiasu, aby

Usuwamy synchroniczne metody odczytu z klasy WindowManager. Synchroniczne metody odczytu są podatne na błędy, ponieważ występuje w nich niejawny wyścig. Rejestruj odbiorniki i wywołania zwrotne, aby otrzymywać aktualizacje dotyczące WindowLayoutInfo.

Zmiany w interfejsie API

  • Dodanie metod ułatwiających pracę z FoldingFeatures (Ie733f)
  • Usuwa synchroniczne metody odczytu z WindowManager (I96fd4)

Wersja 1.0.0-alpha04

10 marca 2021 r.

Zostanie wycofaneandroidx.window:window:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • Rozwiązaliśmy problem, który powodował, że jeśli nie było implementacji OEM, nie były emitowane żadne informacje WindowLayoutInfo. Teraz emitujemy pusty obiekt WIndowLayoutInfo.
  • Naprawiliśmy błąd, który powodował, że stan nie aktualizował się prawidłowo, jeśli stan zawiasu zmienił się, gdy aplikacja działała w tle. Teraz stan powinien być spójny.
  • Zaktualizuj pliki ProGuard, aby ignorować ostrzeżenia dotyczące zależności środowiska wykonawczego.

Poprawki błędów

  • Wysyłaj pustą wartość, gdy brakuje biblioteki OEM. (Ide935)

Wersja 1.0.0-alpha03

18 lutego 2021 r.

Zostanie wycofaneandroidx.window:window:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Wysyłaj pustą wartość w przypadku WindowLayoutInfo, gdy implementacja OEM jest pusta. Ułatwi to korzystanie z biblioteki na większej liczbie urządzeń. Interfejsy API są asynchroniczne, dlatego zalecamy, aby aplikacje zawierały kod zabezpieczający i po przekroczeniu limitu czasu zwracały wartość domyślną. Nie mamy żadnych gwarancji dotyczących implementacji przez producentów OEM, a wartość początkowa może być opóźniona.

Poprawki błędów

  • Wysyłaj pustą wartość, gdy brakuje biblioteki OEM. (Ide935)

Wersja 1.0.0-alpha02

27 stycznia 2021 r.

Zostanie wycofaneandroidx.window:window:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Niektóre interfejsy API zostały wycofane, aby uprościć interfejs API i zmniejszyć liczbę błędów. Warto wspomnieć o usunięciu synchronicznych operacji odczytu z usługi WindowManager i wycofaniu interfejsu DeviceState. Synchroniczne operacje odczytu mogą prowadzić do wyścigów i nieprawidłowego interfejsu.

  • Przekształciliśmy DisplayFeature w interfejs, który będą odtąd implementować inne funkcje. Pierwszą funkcją jest FoldingFeature, która reprezentuje teraz zagięcie ekranu lub zawias. Zawiera też stan zawiasu zastępujący DeviceState.

  • Interfejs WindowMetrics został wprowadzony w Androidzie 11, aby zapewnić programistom prosty sposób na uzyskiwanie informacji o oknie, np. jego pozycji i rozmiaru na ekranie oraz wszelkich wcięć systemowych. W tej wersji interfejsu API wprowadziliśmy funkcję backporting, aby deweloperzy mogli korzystać z WindowMetrics i nadal obsługiwać starsze wersje Androida. Obiekt WindowMetrics można uzyskać za pomocą interfejsów API WindowManager#getCurrentWindowMetrics() i WindowManager#getMaximumWindowMetrics().

Zmiany w interfejsie API

  • Wycofanie interfejsów API, które zostaną usunięte w następnej wersji alfa (Ib7cc4)
  • Aktualizuje ExtensionInterface, aby akceptować jawne odwołania do aktywności. (I07ded)
  • Wprowadza interfejs WindowMetrics API. (I3ccee)
  • Usuwanie synchronicznych metod odczytu z klasy WindowManager (I69983)
  • Zabezpieczanie pakietu ExtensionWindowBackend. (Ied208)

Poprawki błędów

  • Zaktualizuj interfejsy API ExtensionInterface, aby akceptować konteksty wizualne. (I8e827)

Wkład zewnętrzny

  • Połączyliśmy DeviceState i WindowLayoutInfo, aby ułatwić dostęp do danych. (Id34f4)

Wersja 1.0.0-alpha01

27 lutego 2020 r.

androidx.window:window:1.0.0-alpha01 i androidx.window:window-extensions:1.0.0-alpha01 zostaną opublikowane. Wersja 1.0.0-alpha01 zawiera te zmiany. To pierwsza wersja biblioteki Window Manager.

Nowe funkcje

  • DisplayFeature: ten nowy interfejs API wykrywa przerwy w ciągłych płaskich powierzchniach, takie jak zawiasy lub zagięcia.
  • DeviceState: ten nowy interfejs API podaje aktualną pozycję telefonu z listy zdefiniowanych pozycji (np. CLOSED, OPENED, HALF_OPENED itp.).