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
17 czerwca 2026 r. 1.5.1 - - 1.6.0-alpha05

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")
}

Prześlij opinię

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

17 czerwca 2026 r.

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

Zmiany w interfejsie API

  • Dodaj nowy interfejs API EngagementMode.PRECISE_POINTER w WindowEngagementInfo (I7e4d7, b/474545085)
  • Wycofano WindowLayoutInfo.engagementModes. Użyj nowej metody WindowInfoTracker.windowEngagementInfo(), aby obserwować zmiany trybu zaangażowania. (I500d1, b/491562425)

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 lepiej wyjaśnić działanie 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)
  • Dodano obsługę rozszerzeń w trybie raportowania 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 występujący 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 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 narzędzie 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 narzędzie 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 zespołów (I87b8d)

Poprawki błędów

  • Poprawka: w niektórych przypadkach funkcja EmbeddingRule zwracała inne 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 z informacjami o oknie aktywności umieszczonej
    • 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 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.

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 zespołów (I87b8d)
  • Zezwalaj aplikacjom na dostosowywanie animacji ActivityEmbedding (If31a8)
  • Dodano obsługę watchosDeviceArm64 KMP i Kotlin w wersji 1.9 (Icf15d, b/364652024).
  • Udostępnij interfejsy WindowMetricsCalculator API. (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 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 WindowSizeClass API, aby w przyszłości obsługiwał dodawanie nowych wartości punktów przerwania. Zamiast granic bezwzględnych używamy dolnych granic i zalecamy programistom, aby podczas przetwarzania WindowSizeClass sprawdzali dolne granice. 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 przeciągalnego separatora między 2 aktywnościami w podzielonym widoku.
  • 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świetla się 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 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 pozwala określić, czy urządzenie obsługuje tryb TableTop w przypadku urządzeń składanych. Dodaje WindowAreaSessionPresenter#getWindow

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

    • 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 ustawiania 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 zwracano 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, który umożliwia przeciąganie do pełnego ekranu 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)
  • Zezwalaj 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.
    • Wycofaj lub zastąp interfejsy API, aby przyjmowały lub zwracały 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 najważniejszych 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 funkcji, a także 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 oceniania, 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 UiContext parametrów.
  • Udostępnianie wersji rozszerzeń na urządzeniu.
  • WindowProperties stałe dotyczące zastępowania 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 współczynnika proporcji 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 UiContext parametrów.
  • 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 UiContext parametrów.
  • 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 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.
    • 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 UiContext parametrów.

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 pomijaniu 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 obrazu.
  • 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 wykluczenia zgodności 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 Remove background color API w wersji stabilnej. (I34c3e)
  • Ukryj interfejsy API obszaru okna. (I39de0)
  • Dodaj metody zastępowania SplitInfo w 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 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ś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, że będzie używany bieżący kolor 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 do testowania.
    • Dodaj TestSplitInfo, aby utworzyć SplitInfo na potrzeby 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ąpienia 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 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 testach 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 testowania 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ć więcej szczegółowych informacji 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.
  • Przekształcono SplitController w 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 bez aktywności.
  • Dodano eksperymentalny kontekst interfejsu bez aktywności do WindowMetricsCalculator.

Kroki migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania ich 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" /> Dzięki temu system może z wyprzedzeniem zoptymalizować zachowania podziału dla 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ług:
      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).
  • Migracje:
      SplitPairRule.Builder
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) zmienia się nakotlin 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.
  • Migracje:
      SplitPlaceholder.Builder
    • Zawiera 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ć więcej szczegółowych informacji 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.
  • Przekształcono SplitController w 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 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 przypadku zagnieżdżonej klasy 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 obsługę kontekstu interfejsu użytkownika bez aktywności w WindowInfoTracker.
  • Dodano kontekst interfejsu użytkownika spoza aktywności do WindowMetricsCalculator.

Kroki migracji

  • Aby włączyć osadzanie aktywności w celu wyświetlania ich 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" /> Dzięki temu system może z wyprzedzeniem zoptymalizować zachowania podziału dla 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ług:
      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).
  • Migracje:
      SplitPairRule.Builder
    • SplitPairRule.Builder(filters, minWidth, minSmallestWidth) zmienia się nakotlin 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.
  • Migracje:
      SplitPlaceholder.Builder
    • Zawiera 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 na wyświetlacz wyrównany 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 constructor (Ide534)
  • SplitRule teraz zajmuje maxAspectRatioInPortrait/Landscape. Umożliwia to podział działań 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 skonfigurować wiele reguł
    6. Wyodrębnij interfejsy API związane z regułą wyodrębniania z SplitController do pojedynczego obiektu RuleController. Są to:
    7. addRule
    8. removeRule
    9. getRules
    10. setRules
    11. clearRules
    12. parseRules
    13. Wyodrębnij #isActivityEmbedded z SplitController do singletonu ActivityEmbeddingController. Są to:
    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 i 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 tą zmianą:SplitController.getInstance(context).clearRegisteredRules() Po tej 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 DP zamiast w pikselach.
    2. Refaktoryzacja kodu, aby w przypadku SplitRule Builder minimalne wymiary były 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.

Publikacja androidx.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 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. Uzupełnienie elementu zastępczego spowodowało pewne niejasności.

Zmiany w interfejsie API

  • Ustaw wartość isEmpty jako publiczną, aby zastąpić funkcję isEmpty.
  • Zmień nazwy działań parametru ActivityStack na activitiesInProcess. (Ia5055)
  • Usuń symbole 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)
  • 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ą 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 na wyświetlacz wyrównany 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ć 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 Java i RxJava

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.
  • Rozszerzenie eksperymentalnego interfejsu ActivityEmbedding API.

Zmiany w interfejsie API

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

Poprawki błędów

  • Dodawanie interfejsów 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 za pomocą WindowInfoTracker i FoldingFeature. WindowMetricsCalculator, aby pomóc w obliczeniu bieżących 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ą 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)
  • dodanie metody isEmpty w klasie 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 r.

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 oznaczać 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 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 z Repo na Repository. (I61a16)
  • Aktualizowanie pakietów zajęć. (I23ae2)
  • Usuwanie WindowMetrics z WindowInfoRepo (I24663)
  • Usuń WindowManager i użyj WindowInfoRepo
    • Ustawienie WindowBackend jako wewnętrznego. (I06d9a)
  • Przekształć dane okna w dane 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 ProGuard, w którym usuwana była biblioteka podstawowa.
  • 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 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.

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)
  • 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

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ż 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ę do języka Kotlin. (Idd995)
  • Usunięto narzędzie DisplayFeature. (I61fa4)
  • Usunięto DeviceState z publicznego interfejsu API. Zamiast tego 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 jest rozdzielona lub zasłonięta, 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 detektory i wywołania zwrotne, aby otrzymywać aktualizacje dotyczące obiektu WindowLayoutInfo.

Zmiany w interfejsie API

  • Dodanie metod ułatwiających pracę z FoldingFeatures (Ie733f)
  • Usuwa synchroniczne metody odczytu z interfejsu 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ł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. 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 po przekroczeniu limitu czasu emitowały wartość domyślną. Nie możemy zagwarantować, że implementacje OEM będą działać prawidłowo, 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 usługi WindowManager i wycofaniu klasy 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, który zastępuje 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 wsteczną zgodność, 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.).