WindowManager

Biblioteka Jetpack WindowManager umożliwia deweloperom aplikacji obsługę nowych formatów 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
22 kwietnia 2026 r. 1.5.1 - - 1.6.0-alpha03

Deklarowanie zależności

Aby dodać zależność od WindowManager, musisz dodać do projektu repozytorium Maven Google. 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.5.1"

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

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

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

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

Kotlin

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

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

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

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

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

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 nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

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

Wersja 1.6

Wersja 1.6.0-alpha03

22 kwietnia 2026 r.

Publikacja androidx.window:window-*:1.6.0-alpha03 Wersja 1.6.0-alpha03 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano interfejsy API do kontrolowania stanu zaangażowania. (I98a09, b/489793703)
  • Zmieniono nazwę transferActivityToWindowArea na transferToWindowArea, aby zwiększyć przejrzystość działania podczas uruchamiania funkcji. Usuwa to też zachowanie oparte na sesji w przypadku tej metody, ponieważ jest to operacja, która trwa dłużej niż proces, który ją wywołuje. (Ie7d6f, b/271644150, b/273807246, b/272064992, b/473870239)
  • Dodaj bezpieczną metodę uzyskiwania WindowMetrics (I2adf8, b/449386176)
  • Zaktualizowaliśmy metody w rozszerzeniach WM w trybie zaangażowania w celu uniknięcia wątpliwości. (I219a4, b/454438323)
  • Dodaliśmy metody pomocnicze do tworzenia WindowSizeClassSets w formie siatki. (I4d623, b/444174274)
  • Dodaj interfejs API, aby uzyskać tryb zaangażowania. (I9fef2, b/423990404)
  • Dodaj bezpośrednio do WindowLayoutInfo odbiorców opartych na wywołaniu zwrotnym i wycofaj WindowInfoTrackerCallbackAdapter. (I1ff17, b/423990404)
  • Wycofanie konstruktora WindowLayoutInfo w rozszerzeniach. (I6ab65, b/423990404)
  • Dodanie obsługi rozszerzeń w raportowaniu trybu zaangażowania. (I66211, b/423990404)

Poprawki błędów

  • Zaktualizowano Compose compileSdk do interfejsu API 37. Oznacza to, że podczas korzystania z Compose wymagana jest minimalna wersja AGP 9.2.0. (Id45cd, b/413674743)

Wersja 1.6.0-alpha01

19 listopada 2025 r.

Publikacja androidx.window:window-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Dodaliśmy metody pomocnicze do tworzenia WindowSizeClassSets w formie siatki.

Zmiany w interfejsie API

  • Dodaliśmy metody pomocnicze do tworzenia WindowSizeClassSets w formie siatki. (I4d623, b/444174274)

Wersja 1.5

Wersja 1.5.1

19 listopada 2025 r.

Publikacja androidx.window:window-*:1.5.1 Wersja 1.5.1 zawiera te zmiany.

Poprawki błędów

  • Rozwiązuje problem ClassCastException, który występuje na niektórych urządzeniach (4d58979).

Wersja 1.5.0

24 września 2025 r.

Publikacja androidx.window:window-*:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0:

  • 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ęto eksperymentalny interfejs API WindowInsets. (I68a71)

Poprawki błędów

  • Poprawka: w niektórych przypadkach funkcja EmbeddingRule zwracała inne wartości hashCode. (I748cc)
  • Poprawka dotycząca sytuacji, w której może wystąpić NullPointerException z powodu błędów w implementacji na urządzeniu.
  • Rozwiązanie problemu, w którym nasze ActivityEmbedding sprawdzanie bezpieczeństwa kończyło się niepowodzeniem z powodu usunięcia nieużywanych klas przez ProGuard.

Wkład zewnętrzny

  • Dodaj wszystkie platformy KMP do window-core (If3d7c)

Wersja 1.5.0-rc01

27 sierpnia 2025 roku

Publikacja androidx.window:window-*:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zmiany.

Poprawki błędów

  • Poprawka dotycząca sytuacji, w której może wystąpić NullPointerException z powodu błędów w implementacji na urządzeniu.
  • Rozwiązanie problemu, w którym nasze ActivityEmbedding sprawdzanie bezpieczeństwa kończyło się niepowodzeniem z powodu usunięcia nieużywanych klas przez ProGuard.

Wersja 1.5.0-beta02

13 sierpnia 2025 r.

Publikacja androidx.window:window-*:1.5.0-beta02 Wersja 1.5.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Poprawki drobnych błędów.

Wkład zewnętrzny

  • Dodaj wszystkie platformy KMP do window-core (If3d7c)

Wersja 1.5.0-beta01

2 lipca 2025 r.

Publikacja androidx.window:window-*:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Wersja 1.5.0-alpha02

7 maja 2025 r.

Publikacja androidx.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ęto eksperymentalny interfejs API WindowInsets. (I68a71)
  • Ukrywanie kilku konstruktoró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.

Publikacja androidx.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.

Publikacja androidx.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
    • Separator interaktywny
    • ActivityStack Przypinanie
    • Przyciemnianie okna pełnoekranowego
    • Wywołanie zwrotne informacji o umieszczonym oknie aktywności
    • Ulepszone ActivityStackzarządzanie
    • Uruchamianie aktywności w określonym ActivityStack
  • WindowMetricsCalculator
    • Ulepszona obsługa testowania
  • WindowMetrics
    • Wygodne metody obliczania wartości withDp i heightDp
    • Zaktualizuj sprawdzanie granic 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.

Publikacja androidx.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.

Publikacja androidx.window:window-*:1.4.0-rc01 Wersja 1.4.0-rc01 zawiera te zmiany.

Nowe funkcje

  • Zmiany w interfejsie WindowSizeClass API.
  • Aktualizacje interfejsów API do osadzania aktywności.

Wersja 1.4.0-beta02

12 lutego 2025 r.

Publikacja androidx.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 funkcji pobierającej.

Wersja 1.4.0-beta01

15 stycznia 2025 r.

Publikacja androidx.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 konstruktorów (I87b8d)
  • Zezwalaj aplikacjom na dostosowywanie animacji ActivityEmbedding (If31a8)
  • Dodano obsługę watchosDeviceArm64 KMP i wersji docelowej Kotlin 1.9 (Icf15d, b/364652024)
  • Udostępnij interfejsy API WindowMetricsCalculator. (I1cebf)

Poprawki błędów

  • Ta biblioteka korzysta teraz z adnotacji o wartości null JSpecify, które są używane w typie. Deweloperzy Kotlin powinni używać tego argumentu kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict (jest to domyślny argument począwszy od wersji 2.1.0 kompilatora Kotlin). (Ie69ac, b/326456246)

Wersja 1.4.0-alpha05

16 października 2024 r.

Publikacja androidx.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 widthDp i heightDp do WindowMetrics. (Ide026)
  • Usunięto eksperymentalny interfejs API WindowInsets. (I68a71)
  • Zmiana nazw metod sprawdzania zakresu na isAtLeast (Ib0ab7)

Wersja 1.4.0-alpha04

2 października 2024 r.

Publikacja androidx.window:window-*:1.4.0-alpha04 Wersja 1.4.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaliśmy metodę obliczania WindowSizeClass na podstawie WindowMetrics. (874dba)
  • Dla przejrzystości zmień metody WindowSizeClass na containsWidthDp, containsHeightDp i containsWindowSizeDp. (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.

Publikacja androidx.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.

Publikacja androidx.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 deweloperzy mogli używać własnych.
  • Dodaj isAtLeastmetody narzędzioweWindowSizeClass, aby deweloperzy 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 WindowSizeClass API, 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.

Publikacja androidx.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 widoku podzielonym.
  • Przyciemnianie okna dialogowego na pełnym ekranie umożliwia aplikacjom określenie obszaru przyciemnienia okna dialogowego, aby przyciemnić całe okno zadania lub tylko kontener, w którym wyświetlane jest okno dialogowe.
  • Embedded Activity Window Info Callback umożliwia aplikacjom ciągłe otrzymywanie aktualizacji wbudowanego okna aktywności.
  • Osadzanie tła animacji umożliwia aplikacjom określanie tła animacji, co poprawia jakość animacji przejścia, gdy używana jest funkcja ActivityEmbedding.
  • Ulepszone zarządzanie stosem aktywności pozwala aplikacjom mieć większą kontrolę nad ActivityStacks, gdy używana jest funkcja 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

  • Dodawanie interfejsów API w celu włączenia i skonfigurowania interaktywnego separatora

    • 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 którym w przypadku aktywnej sesji zwracana była wartość UNAVAILABLE zamiast ACTIVE.
  • Wycofano 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)
  • Usunięto ręczne określanie dostępu do nowych interfejsów API platformy, ponieważ odbywa się to automatycznie za pomocą modelowania interfejsów API podczas korzystania z R8 z AGP 7.3 lub nowszą (np. R8 w wersji 3.3) oraz w przypadku wszystkich kompilacji podczas korzystania z AGP 8.1 lub nowszej (np. D8 w wersji 8.1). Klientom, którzy nie korzystają z AGP, zalecamy przejście na D8 w 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 przeciągalnego separatora podziału (Ia7a78)
  • Dodano gęstość do WindowMetrics (Id6723)
  • Dodano interfejs API, aby uzyskać SupportedPostures. (If557a)
  • Usunięto 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)
  • Dodano adapter wywołania zwrotnego dla interfejsu API przepływu overlayInfo (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 konfigurowania osadzania; (I59a4a)
  • – dodawanie przypinania i odpinania najpopularniejszych interfejsów API ActivityStack androidx.Window;
    • Aktualizacja aplikacji w wersji 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.

Publikacja androidx.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 rozmiarów okien.

Wersja 1.3.0-rc01

14 maja 2024 r.

WindowManager Jetpack 1.3 wprowadza obsługę Kotlin Multiplatform dla WindowSizeClass oraz wiele poprawek błędów.

Publikacja androidx.window:window-*:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zmiany.

Wersja 1.3.0-beta02

1 maja 2024 r.

Publikacja androidx.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.

Publikacja androidx.window:window-*:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zmiany.

Wersja 1.3.0-alpha03

6 marca 2024 roku

Publikacja androidx.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.

Publikacja androidx.window:window-*:1.3.0-alpha02 Wersja 1.3.0-alpha02 zawiera te zatwierdzenia.

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 oceny, aby deweloperzy mogli pisać własne selektory. Dodaj funkcję rozszerzenia selektora, aby wybrać najszerszy element 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.

Publikacja androidx.window:window-*:1.3.0-alpha01 Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do testowania tworzenia FoldingFeature są już stabilne.
  • Interfejsy API testowe do konfigurowania 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.
  • Stałe WindowProperties dotyczące zastępowania ustawień aplikacji przez użytkownika:
    • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE – informuje system, że aplikacja zrezygnowała z 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 formatem obrazu użytkownika.

Wersja 1.2

Wersja 1.2.0

15 listopada 2023 r.

Publikacja androidx.window:window-*:1.2.0 Wersja 1.2.0 zawiera te zatwierdzenia.

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 testowania tworzenia FoldingFeature są już stabilne.
  • Interfejsy API testowe do konfigurowania 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

Publikacja androidx.window:window-*:1.2.0-rc01 Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do testowania tworzenia FoldingFeature są już stabilne.
  • Interfejsy API testowe do konfigurowania 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.

Publikacja androidx.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.

Publikacja androidx.window:window-*:1.2.0-beta03 Wersja 1.2.0-beta03 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodaj RequiresApi sprawdzanie 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.
    • Wprowadziliśmy 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.

Publikacja androidx.window:window-*:1.2.0-beta01 Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Udostępnianie eksperymentalnych interfejsów API okien do uzyskiwania dostępu do tylnego ekranu.
  • Interfejsy API do testowania tworzenia FoldingFeature są już stabilne.
  • Interfejsy API testowe do konfigurowania 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

  • Oznaczono interfejsy API WindowArea jako eksperymentalne, aby umożliwić dalsze zmiany interfejsu API w celu uzyskania stabilnej wersji 1.3 (I857f5)
  • Zaktualizowano pliki interfejsu API, aby dodać adnotacje o wyłączeniu zgodności (I8e87a, b/287516207)

Wersja 1.2.0-alpha03

21 czerwca 2023 r.

Publikacja androidx.window:window-*:1.2.0-alpha03 Wersja 1.2.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Usuwanie wycofanych interfejsów API z platformy interfejsów API.
  • Dodaj interfejsy API obsługujące wyświetlanie równoczesne.
  • Dodaj właściwość, aby zrezygnować z wymuszonego zastępowania zmiany rozmiaru.
  • Dodaj usługę, 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)
  • Dodanie właściwości wykluczającej zgodność w przypadku 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 teraz.
    • 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 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 podział kontenera zadania nadrzędnego na równe części. 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śniono, ż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() symbolami ALWAYS_ALLOW i ALWAYS_DISALLOW. (I3057b)
  • Dodaj interfejsy API dla SplitRule, SplitAttributes, SplitAttributesCalculator. (I92d23)
  • Dodaj TestActivityStack, aby utworzyć ActivityStack do testowania.
    • Dodaj TestSplitInfo, aby utworzyć SplitInfo do testowania. (I8e779)
  • Dodanie możliwości 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.

Publikacja androidx.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ępowanie w przypadku Context na podstawie WindowLayoutInfo. (I2037a)

Wersja 1.2.0-alpha01

24 maja 2023 r.

Publikacja androidx.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 JVM. (Ie036e)
  • Dodaj IntRange dla wartości funkcji testowego składania. (I69f7d)

Wersja 1.1

Wersja 1.1.0

7 czerwca 2023 r.

Publikacja androidx.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 podać 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 wartości 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(), aby sprawdzić, 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 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 do WindowInfoTracker eksperymentalną obsługę kontekstu interfejsu użytkownika bez aktywności.
  • Dodano eksperymentalny kontekst interfejsu bez aktywności do WindowMetricsCalculator.

Kroki migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania aktywności w podziale, 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śniejszą optymalizację zachowań podziału w 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().
  • Migracje usługi:
      SplitRule
    • 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 w setLayoutDirection(layoutDirection) i setSplitRatio(ratio) na kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
    • setFinishPrimaryWithSecondary i setFinishSecondaryWithPrimary przyjmują stałe podobne do wyliczenia FinishBehavior. 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 setterów. Więcej informacji znajdziesz w sekcji „Migracje SplitPairRule.Builder”.
    • setFinishPrimaryWithPlaceholder przyjmuje stałe podobne do wyliczenia FinishBehavior. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • Wartości setLayoutDirection(layoutDirection) i setSplitRatio(ratio) zmieniają 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.

Publikacja androidx.window:window-*:1.1.0-rc01 Wersja 1.1.0-rc01 zawiera te zmiany.

Nowe funkcje

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

Wersja 1.1.0-beta02

5 kwietnia 2023 r.

Publikacja androidx.window:window-*:1.1.0-beta02 Wersja 1.1.0-beta02 zawiera te zmiany.

Nowe funkcje

  • Wewnętrzne poprawki i zwalnianie miejsca.

Wersja 1.1.0-beta01

22 marca 2023 r.

Publikacja androidx.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 podać 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 wartości 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(), aby sprawdzić, 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 przypadku zagnieżdżonej klasy Builder usług SplitPairRule i SplitPlaceholderRule.
  • Zastąpiliśmy symbol SplitInfo#getSplitRatio() symbolem SplitInfo#getSplitAttributes(), aby podać dodatkowe informacje dotyczące podziału.

WindowLayout

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

Kroki migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania aktywności w podziale, 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śniejszą optymalizację zachowań podziału w 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().
  • Migracje usługi:
      SplitRule
    • 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ą stałe podobne do wyliczenia FinishBehavior. 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 setterów. Więcej informacji znajdziesz w sekcji „Migracje SplitPairRule.Builder”.
    • setFinishPrimaryWithPlaceholder przyjmuje stałe podobne do wyliczenia FinishBehavior. Więcej informacji znajdziesz w sekcji „Migracje SplitRule”.
    • Wartości setLayoutDirection(layoutDirection) i setSplitRatio(ratio) zmieniają 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

Publikacja androidx.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() symbolami ALWAYS_ALLOW i ALWAYS_DISALLOW.
    2. Zaktualizuj dokumentację API @see za pomocą dokumentacji autonomicznej. (I3057b)
  • Te konstruktory zostały usunięte z publicznych interfejsów API, ponieważ aplikacje nie powinny ich wywoływać.
    • SplitInfo konstruktor
    • ActivityStack constructor (Ide534)
  • SplitRule akceptuje teraz maxAspectRatioInPortrait/Landscape. Umożliwia to dzielenie aktywności tylko wtedy, gdy współczynnik proporcji obszaru nadrzędnego jest mniejszy lub równy żądanemu współczynnikowi 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 poleceń dodawania i usuwania:
    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 singletona ActivityEmbeddingController. Oto oni:
    14. isActivityEmbedded
    15. Usuń SplitController#initialize. Aby skonfigurować reguły z pliku XML, użyj poleceń RuleController#parseRules i #setRules. Przed zmianą: SplitController.initialize(context, R.xml.static_rules) Po 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 są one 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. Refaktoryzacja dla SplitRule Builder, aby przyjmował minimalne wymiary jako opcjonalne. (I95f17)
  • Przekaż kontekst, aby zainicjować 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.

Publikacja androidx.window:window-*:1.1.0-alpha04 Wersja 1.1.0-alpha04 zawiera te zmiany.

Nowe funkcje

  • Udostępnij metodę sprawdzania, czy element ActivityStack jest pusty w przypadku elementu ActivityEmbedding.
  • Usunięto tagi eksperymentalnych interfejsów API z interfejsów API ActivityEmbedding.
  • Ukryj konstruktor ActivityRule, ponieważ Builder jest preferowanym sposobem tworzenia.
  • Dodaj eksperymentalną metodę, aby uzyskać WindowInsets na WindowMetrics.
  • Zaktualizuj SplitPlaceholderFinishBehavior, aby zapobiec zakończeniu symbolu zastępczego. Ukończenie elementu zastępczego spowodowało pewne niejasne zachowania.

Zmiany w interfejsie API

  • Ustaw wartość isEmpty jako publiczną, aby zastąpić funkcję isEmpty.
  • Zmień nazwy działań parametru ActivityStack na activitiesInProcess. (Ia5055)
  • Usuń elementy ActivityFilter#matchesClassName i ActivityFilter#matchesClassNameOrWildCard, ponieważ są mylące.
  • Dodaj znaki ActivityFilter#componentName i ActivityFilter#intentAction, aby dzwoniący mógł odróżnić różne filtry (I41f22).
  • Usunięto interfejsy API @Deprecated z eksperymentalnego interfejsu API (I216b3)
  • Usunięto @ExperimentalWindowApi z 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)
  • Aktualizacja plików interfejsu API w celu odzwierciedlenia zmian w klasach WindowMetrics i WindowMetricsCalculatorCompat (I667fe)
  • Zaktualizuj dokumentację Javadoc usługi ActivityEmbedding i nazwę 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ą one, 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

Publikacja androidx.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

Publikacja androidx.window:window-*:1.1.0-alpha02 Wersja 1.1.0-alpha02 zawiera te zmiany.

Nowe funkcje

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

Wersja 1.1.0-alpha01

11 maja 2022 roku

Publikacja androidx.window:window-*:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Wydanie adapterów obsługujących Jave i RxJave

Wersja 1.1.0-alpha01

20 kwietnia 2022 r.

Publikacja androidx.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 urządzenia.
  • 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 końcowe 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.

Publikacja androidx.window:window-*:1.0.0 Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje wersji 1.0.0

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

Wersja 1.0.0-rc01

15 grudnia 2021 roku

Publikacja androidx.window:window-*:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

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

Wersja 1.0.0-beta04

17 listopada 2021 r.

Publikacja androidx.window:window-*:1.0.0-beta04 Wersja 1.0.0-beta04 zawiera te zatwierdzenia.

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)
  • add isEmpty in 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

Publikacja androidx.window:window-*:1.0.0-beta03 Wersja 1.0.0-beta03 zawiera te zatwierdzenia.

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 niego 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

Publikacja androidx.window:window-*:1.0.0-beta02 Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

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.

Publikacja androidx.window:window-*:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

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 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.

Publikacja androidx.window:window-*:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

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 funkcji, które obsługują.

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 testowego.
    • 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.

Publikacja androidx.window:window-*:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.

Nowe funkcje

  • Zmień stałe całkowite na nieograniczone wyliczenia.
  • Dodaj narzędzie testowe, aby utworzyć funkcje testowe składania.

Zmiany w interfejsie API

  • Dodaj metodę pomocniczą do tworzenia funkcji wyświetlania testowego. (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.

Publikacja androidx.window:window-*:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

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.

Publikacja androidx.window:window-*:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.

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 współprogramach do wykorzystywania informacji o układzie okna. (Iab70f)
  • Migracja głównej biblioteki menedżera okien do języka Kotlin. (Icca34)

Poprawki błędów

  • Dodanie nowej klasy danych reprezentującej granice funkcji. (I6dcd1)

Wersja 1.0.0-alpha06

5 maja 2021 roku

Publikacja androidx.window:window:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.

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ż obecnie nie jest on 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ś bibliotekę podstawową 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.

Publikacja androidx.window:window:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

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 niejawna sytuacja wyścigu. Rejestruj detektory i wywołania zwrotne, aby otrzymywać aktualizacje dotyczące obiektu WindowLayoutInfo.

Zmiany w interfejsie API

  • Dodanie wygodnych metod pracy z FoldingFeatures (Ie733f)
  • Usuwa synchroniczne metody odczytu z klasy WindowManager (I96fd4)

Wersja 1.0.0-alpha04

10 marca 2021 r.

Publikacja androidx.window:window:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • Rozwiązaliśmy problem, który powodował, że jeśli nie było implementacji OEM, nie był emitowany żaden element 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. Stan powinien być teraz 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.

Publikacja androidx.window:window:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

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 pisały kod defensywny i emitowały wartość domyślną po upływie limitu czasu. 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.

Publikacja androidx.window:window:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

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 WindowManager i wycofaniu DeviceState. Synchroniczne operacje odczytu mogą prowadzić do sytuacji wyścigu 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, który zastępuje DeviceState.

  • Interfejs WindowMetrics został wprowadzony w Androidzie 11, aby zapewnić deweloperom 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 interfejsu WindowManager (I69983)
  • Zabezpiecz pakiet 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 zostały opublikowane. Wersja 1.0.0-alpha01 zawiera te zatwierdzenia. 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.).