Środowisko wykonawcze Compose

Struktura

Składnik to kombinacja 7 identyfikatorów grupy Maven w ramach androidx. Każda grupa zawiera określony podzbiór funkcji, z którym wiąże się własny zestaw informacji o wydańach.

Ta tabela zawiera informacje o grupach i linki do poszczególnych zestawów informacji o wersji.

Deklarowanie zależności

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

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

dependencies {
    implementation "androidx.compose.runtime:runtime:1.7.5"
    implementation "androidx.compose.runtime:runtime-livedata:1.7.5"
    implementation "androidx.compose.runtime:runtime-rxjava2:1.7.5"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.compose.runtime:runtime:1.7.5")
    implementation("androidx.compose.runtime:runtime-livedata:1.7.5")
    implementation("androidx.compose.runtime:runtime-rxjava2:1.7.5")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli zauważysz 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 dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

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

Śledzenie w środowisku wykonawczym, wersja 1.7

Wersja 1.7.0-rc01

18 września 2024 r.

androidx.compose.runtime:runtime-tracing:1.7.0-rc01 został zwolniony. Wersja 1.7.0-rc01 zawiera te komity.

Śledzenie środowiska wykonawczego w wersji 1.0

Wersja 1.0.0-beta01

29 listopada 2023 r.

androidx.compose.runtime:runtime-tracing:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Wersja 1.0.0-alpha05

15 listopada 2023 r.

androidx.compose.runtime:runtime-tracing:1.0.0-alpha05 został zwolniony. Wersja 1.0.0-alpha05 zawiera te commity.

Poprawki błędów

• Zablokowane zależności do najstarszych obsługiwanych wersji stabilnych (np. compose-runtime i tracing-perfetto) – rozwiązano problem, w którym interfejs compose-runtime-tracing wprowadzał do aplikacji nowszą wersję interfejsu compose-runtime.

Wersja 1.0.0-alpha04

23 sierpnia 2023 r.

androidx.compose.runtime:runtime-tracing:1.0.0-alpha04 został zwolniony. Wersja 1.0.0-alpha04 zawiera te commity.

Nowe funkcje

• Zgodność z najnowszymi wersjami Benchmark i Tracing Perfetto, co umożliwia obsługę śledzenia kompozycji podczas uruchamiania aplikacji (zimny start), np. w Benchmarku AndroidX i Android Studio (od wersji Hedgehog Beta 2).

Zmiany w interfejsie API

• Nazwa androidx.tracing.perfetto.Trace została zmieniona na androidx.tracing.perfetto.PerfettoSdkTrace. (I44af8)
• Dostosowanie interfejsów API pakietu SDK do śledzenia interfejsu perfetto do interfejsów android.os.Trace. (I73ba0, b/282199917)
• Wymagania wstępne śledzenia podczas uruchamiania aplikacji. (Iad890)
• scalone eksperymentalne i publiczne pliki interfejsu API (I0f2e1, b/278769092);

Wersja 1.0.0-alpha02

8 lutego 2023 r.

androidx.compose.runtime:runtime-tracing:1.0.0-alpha02 został zwolniony. Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

• Brak zmian funkcjonalnych. wiele optymalizacji skuteczności w zależnych od nich zależnościach androidx.tracing:tracing-perfetto*.

Wersja 1.0.0-alpha01

7 września 2022 roku

androidx.compose.runtime:runtime-tracing:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

• androidx.compose.runtime:runtime-tracing to biblioteka, która – przy użyciu narzędzi ją obsługujących (wkrótce) – umożliwia rozszerzone śledzenie w aplikacji Compose. Ta pierwsza wersja to 1.0.0-alpha01.

Wersja 1.8

Wersja 1.8.0-alpha07

11 grudnia 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha07 został zwolniony. Wersja 1.8.0-alpha07 zawiera te komity.

Zmiany w interfejsie API

• Dodano interfejs API narzędzi, który pomaga narzędziu do inspekcji układu korelować podkompozycje z kompozycją nadrzędną w przypadkach, gdy nie używa się węzła do łączenia kompozycji. (I4ce3d)
• Zmiana z publicznych na wewnętrzne stałych arytmetycznych i specjalnych w funkcji SnapshotId. W razie potrzeby można wykonać na wartości SnasphotId operację arytmetyczną, konwertując ją na wartość Int lub Long za pomocą funkcji toInt() lub toLong(). (Ic3a57)

Darowizna zewnętrzna

• Optymalizuj miejsce na dane pod kątem parametrów movableContentOf. (ed87177)

Wersja 1.8.0-alpha06

13 listopada 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha06 został zwolniony. Wersja 1.8.0-alpha06 zawiera te komisy.

Zmiany w interfejsie API

• Zmiany w interfejsie PausableComposition API. Te zmiany są istotne w porównaniu z poprzednimi wersjami 1.8.0-alpha (od 1.8.0-alpha02), ale ponieważ są to nowe interfejsy API w wersji 1.8.0, nie zapewniają zgodności wstecznej, ponieważ nadal są w wersji alfa. (I39819)
• Dodano interfejsy narzędziowe API, które umożliwiają obserwowanie tworzenia nowych kompozycji w programie Recomposer (Iaeb7e).
• Dodano certyfikat snapshotId typu Long do listy Snapshot i wycofano certyfikat id. Identyfikator snapshotu zmieniono z Int na Long, aby uniknąć przepełnienia identyfikatora snapshotu w systemach z bardzo wysoką częstotliwością klatek i długotrwałymi animacjami. Typ został ustawiony na „expect/actual”, aby umożliwić ustawienie tego typu jako Int lub innego typu na platformach, które nie mają natywnego typu Long. Platformy, które nie mają natywnej funkcji Long, np. JavaScript, powinny unikać wysokich częstotliwości klatek (ponad 1000 FPS), które powodują przepełnienie Int mniej więcej co 24 dni. (I38ac3, b/374821679)

Poprawki błędów

• Naprawiono błąd providesDefault w pojedynczym provides. (aosp/3318540 b/374263387)
• Optymalizacja ChangeList. (3318538)

Wersja 1.8.0-alpha05

30 października 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha05 został zwolniony. Wersja 1.8.0-alpha05 zawiera te komisy.

Poprawki błędów

• Naprawić błąd przepełnienia stosu podczas dodawania panelu Int.MAX_VALUE do tablicy SnapshotIdSet. (b/370536104, Ic4179f6)
• Mikrooptymalizacje w czasie działania (I50c60)
• Zezwalanie R8 na usuwanie wywołań runtimeCheck podczas debugowania (I8c44)
• Zmień compoundKeyOf na iteracyjny zamiast rekurencyjny (I5817f)

Darowizna zewnętrzna

• Wdrożenie zbiorów z listami kolekcji (I7d47c)

Wersja 1.8.0-alpha04

16 października 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha04 został zwolniony. Wersja 1.8.0-alpha04 zawiera te komisy.

Usprawnienia dotyczące wydajności

• Podanie identyfikatora zrzutu dla rekordów stanu w konstruktorze (85c00f)
• Refaktoryzuj SnapshotState***, aby uniknąć błędów weryfikacji klasy (6ee4a6)
• Popraw reguły R8, aby zapobiec wstawianiu rzutowania (5beb92)
• Mikrooptymalizacja operacji (d73c5c)
• Optymalizacja przydziału SynchronizedObject w JVM (2b043f)

Wersja 1.8.0-alpha03

2 października 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha03 został zwolniony. Wersja 1.8.0-alpha03 zawiera te komity.

Usprawnienia dotyczące wydajności

• Tworzenie kontekstu podrzędnego dla elementu rememberCoroutineScope (f61464) z minimalnym nakładem pracy
  • Funkcja rememberCoroutineScope jest zwykle używana do uruchamiania coroutines w odpowiedzi na zdarzenia, które występują po skompilowaniu. W niektórych przypadkach te zdarzenia mogą nigdy nie wystąpić, co spowoduje dodatkowe koszty tworzenia i odwoływania zadań bez żadnej korzyści.
  • Spraw, aby zakres zwracany przez rememberCoroutineScope tworzył coroutineContext dopiero w momencie uzyskania do niego dostępu. Dzięki temu unikniesz tworzenia i anulowania zadań, jeśli zakres nie jest używany.

Wersja 1.8.0-alpha02

18 września 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha02 został zwolniony. Wersja 1.8.0-alpha02 zawiera te komity.

Nowe funkcje

• Dodano PausableComposition, które umożliwia tworzenie podkompozycji, którą można wstrzymać podczas tworzenia i stosować asynchronicznie do kompozycji. Do wstrzymywania wymagane jest wsparcie kompilatora, które jest obecnie opracowywane. (I3394b)

Wersja 1.8.0-alpha01

4 września 2024 r.

androidx.compose.runtime:runtime-*:1.8.0-alpha01 został zwolniony. Wersja 1.8.0-alpha01 zawiera te komity.

Wersja 1.7

Wersja 1.7.6

11 grudnia 2024 r.

androidx.compose.runtime:runtime-*:1.7.6 został zwolniony. Wersja 1.7.6 zawiera te komity.

Wersja 1.7.5

30 października 2024 r.

androidx.compose.runtime:runtime-*:1.7.5 został zwolniony. Wersja 1.7.5 zawiera te komitowane zmiany.

Wersja 1.7.4

16 października 2024 r.

androidx.compose.runtime:runtime-*:1.7.4 został zwolniony. Wersja 1.7.4 zawiera te komitowane zmiany.

Wersja 1.7.3

2 października 2024 r.

androidx.compose.runtime:runtime-*:1.7.3 został zwolniony. Wersja 1.7.3 zawiera te komity.

Wersja 1.7.2

18 września 2024 r.

androidx.compose.runtime:runtime-*:1.7.2 został zwolniony. Wersja 1.7.2 zawiera te komitowane zmiany.

Wersja 1.7.1

10 września 2024 r.

• Brak zmian w artefaktach na Androida. Usunięto -desktop artefakty i dodano -jvmStubs oraz -linuxx64Stubs. Żadnego z tych celów nie należy używać. Są to elementy zastępcze, które ułatwiają pracę Jetbrains Compose.

Wersja 1.7.0

4 września 2024 r.

androidx.compose.runtime:runtime-*:1.7.0 został zwolniony. Wersja 1.7.0 zawiera te komity.

Ważne zmiany od wersji 1.6.0

• Dodano możliwość podania wartości lokalnej kompozycji obliczonej na podstawie wartości innych wartości lokalnych kompozycji albo domyślnie za pomocą funkcji compositionLocalWithComputedDefault(), albo przez podanie funkcji lambda, która służy do obliczenia wartości za pomocą funkcji providesComputed zamiast provides.
• Wartość kompozycji lokalnej można uzyskać, używając właściwości currentValue kompozycji lokalnej dostępnej w ramach funkcji lambda obliczającej wartość. Jest ono używane zamiast current, które jest dostępne tylko w funkcjach @Composable. (Iadbc0)
• Nowo utworzone obiekty stanu są od razu dostępne z innych zrzutów, w tym zrzutu globalnego, w ich początkowym stanie. Dalsze modyfikacje nie są widoczne, dopóki nie zostanie zastosowany zrzut, w którym obiekt został utworzony.
• Początkowy stan funkcji mutableStateOf(), a także jej prymitywne wersje, to wartość przekazana jako parametr do funkcji mutableStateOf(). Początkowy stan elementów mutableStateListOf() i mutableStateMapOf() jest pusty.
• Dodano właściwości Snapshot.isInSnapshot i Snapshot.PreexistingSnapshotId, które umożliwiają obiektowi stanu natychmiastowy dostęp do globalnego zrzutu po jego utworzeniu.
• Obiekty stanu niestandardowego mogą być dostępne od razu, ponieważ ich zmiany są zgodne ze wzorcem zmian wprowadzonych wbudowanych obiektów snapshot. (I84a17)
• Włącz nonSkippingGroupOptimization dla bibliotek tworzenia. Dzięki temu wygenerowany kod dla wszystkich funkcji composable, których nie można ponownie uruchomić, w androidx będzie wydajniejszy. W przyszłości planujemy włączyć tę funkcję domyślnie. I(acbc08)
• unieważnianie kompozytowanych lambda w podkompozycjach na tym samym klatce; (98301c)
• Zadzwoń do onRelease w tej samej kolejności co onForgotten. (2cd790)
• Włączanie trybu pomijania z wysoką czułości (ed1766)
• Uczynić currentCompoundHashKey unikalnym w większej liczbie przypadków (d4a872)

Wersja 1.7.0-rc01

21 sierpnia 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-rc01 został zwolniony. Wersja 1.7.0-rc01 zawiera te komity.

Wersja 1.7.0-beta07

7 sierpnia 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta07 został zwolniony. Wersja 1.7.0-beta07 zawiera te komity.

Wersja 1.7.0-beta06

24 lipca 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta06 został zwolniony. Wersja 1.7.0-beta06 zawiera te komity.

Wersja 1.7.0-beta05

10 lipca 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta05 został zwolniony. Wersja 1.7.0-beta05 zawiera te komisy.

Wersja 1.7.0-beta04

26 czerwca 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta04 został zwolniony. Wersja 1.7.0-beta04 zawiera te komity.

Wersja 1.7.0-beta03

12 czerwca 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta03 został zwolniony. Wersja 1.7.0-beta03 zawiera te zatwierdzenia.

Wersja 1.7.0-beta02

29 maja 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta02 został zwolniony. Wersja 1.7.0-beta02 zawiera te komity.

Wersja 1.7.0-beta01

14 maja 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-beta01 został zwolniony. Wersja 1.7.0-beta01 zawiera te zatwierdzenia.

Wersja 1.7.0-alpha08

1 maja 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha08 został zwolniony. Wersja 1.7.0-alpha08 zawiera te komity.

Wersja 1.7.0-alpha07

17 kwietnia 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha07 został zwolniony. Wersja 1.7.0-alpha07 zawiera te komity.

Nowe funkcje

• Dodano możliwość podania wartości lokalnej kompozycji obliczonej na podstawie wartości innych wartości lokalnych kompozycji albo domyślnie za pomocą funkcji compositionLocalWithComputedDefault(), albo przez podanie funkcji lambda, która służy do obliczenia wartości za pomocą funkcji providesComputed zamiast provides.
• Wartość kompozycji lokalnej można uzyskać, używając właściwości currentValue kompozycji lokalnej dostępnej w ramach funkcji lambda obliczającej wartość. Jest ono używane zamiast current, które jest dostępne tylko w funkcjach @Composable. (Iadbc0)

Zmiany w interfejsie API

• Nowo utworzone obiekty stanu są od razu dostępne z innych zrzutów, w tym zrzutu globalnego, w ich początkowym stanie. Dalsze modyfikacje nie są widoczne, dopóki nie zastosujesz zrzutu, w którym obiekt został utworzony.
• Początkowy stan funkcji mutableStateOf(), a także jej prymitywne wersje, to wartość przekazana jako parametr do funkcji mutableStateOf(). Początkowy stan elementów mutableStateListOf() i mutableStateMapOf() jest pusty.
• Dodano właściwości Snapshot.isInSnapshot i Snapshot.PreexistingSnapshotId, które umożliwiają obiektowi stanu natychmiastowy dostęp do globalnego zrzutu po jego utworzeniu.
• Obiekty stanu niestandardowego mogą być dostępne od razu, jeśli będą stosować się do wzoru zmian wprowadzonych wbudowanych obiektach snapshot. (I84a17)

Poprawki błędów

• Naprawiono scalanie readObserver w zagnieżdżonych zrzutach. Z tego powodu zagnieżdżone stany pochodne były niewystarczająco nieważne, gdy były używane w ramach instrukcji snapshotFlow. (Idf138)

Wersja 1.7.0-alpha06

3 kwietnia 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha06 został zwolniony. Wersja 1.7.0-alpha06 zawiera te komisy.

Poprawki błędów

• Popraw obsługę pojedynczych wartości providesDefault (538f45)
• Unikanie zakleszczenia w rekompilatorze podczas uzyskiwania dostępu do zegara ramki (07e5c6)

Wersja 1.7.0-alpha05

20 marca 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha05 został zwolniony. Wersja 1.7.0-alpha05 zawiera te komity.

Poprawki błędów

• Usuwanie późnych zmian w dezaktywowanej kompozycji (5950bc)

Wersja 1.7.0-alpha04

6 marca 2024 roku

androidx.compose.runtime:runtime-*:1.7.0-alpha04 został zwolniony. Wersja 1.7.0-alpha04 zawiera te komity.

Usprawnienia dotyczące wydajności

• Wywołanie Snapshot.current raz na ocenę stanu pochodnej (ee7daf)
• Czytaj currentRecord raz na obserwację w kompozycji (b882b2)
• Usuń przypadkowe przypisanie licznika w snapshotFlow (231e56)
• Włącz nonSkippingGroupOptimization dla bibliotek tworzenia. Dzięki temu wygenerowany kod dla wszystkich funkcji composable, których nie można ponownie uruchomić, w androidx będzie wydajniejszy. W przyszłości planujemy włączyć tę funkcję domyślnie. I(acbc08)

Wersja 1.7.0-alpha03

21 lutego 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha03 został zwolniony. Wersja 1.7.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• Wprowadzenie grup zastępczych w celu poprawy wykrywania zmian (0941b5)

Usprawnienia dotyczące wydajności

• Ulepszona alokacja pamięci podczas wykrywania zmian (53e7fd)
• Naprawiliśmy wyciek pamięci w komponie (0e097d).
• Użyj wartości ScopeMap, aby przekazać nieważne dane podczas ponownego tworzenia (e19a7e).
• Optymalizacja mapy unieważnień w celu zachowania tylko stanów pochodnych (f11c44)
• Zamień użycia IdentityArraySet na ScatterSet (db572)
• Optymalizacja removeScope w ScopeMap (bb0530)

Wersja 1.7.0-alpha02

7 lutego 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha02 został zwolniony. Wersja 1.7.0-alpha02 zawiera te commity.

Poprawki błędów

• unieważnianie kompozytowanych lambda w podkompozycjach na tym samym klatce; (98301c)
• Zadzwoń do onRelease w tej samej kolejności co onForgotten. (2cd790)
• Filtr zmienił stany, które nie są obserwowane w snapshotFlow. (796b80)

Usprawnienia dotyczące wydajności

• Zmień obserwator migawki na miejscu, gdy jest już przezroczysty. (f60f30)
• Optymalizacja SnapshotIdSet.lowest(). (7ae149)
• Użyj konta fold() bez przydziału w aplikacji SnapshotIdSet. (532b7d)
• Usuń alokację iteratora (83f96b)

Wersja 1.7.0-alpha01

24 stycznia 2024 r.

androidx.compose.runtime:runtime-*:1.7.0-alpha01 został zwolniony. Wersja 1.7.0-alpha01 zawiera te commity.

Optymalizacja skuteczności

• Dodanie możliwości tworzenia slotów po dodaniu grupy podrzędnej (b5960c)
• Optymalizacja modyfikacji nagrywania stanów zrzutu (28c3fe)
• Włączanie trybu intensywnego pomijania (ed1766)

Poprawki błędów

• Uwzględnienie metadanych domyślnego parametru w pamięci wewnętrznej (096665)
• Uczynić currentCompoundHashKey unikalnym w większej liczbie przypadków (d4a872)
• Realizacja grup podczas opuszczania wywołania funkcji wbudowanej (2a90fc)

Wersja 1.6

Wersja 1.6.8

12 czerwca 2024 r.

androidx.compose.runtime:runtime-*:1.6.8 został zwolniony. Wersja 1.6.8 zawiera te komisy.

Wersja 1.6.7

1 maja 2024 r.

androidx.compose.runtime:runtime-*:1.6.7 został zwolniony. Wersja 1.6.7 zawiera te komitowane zmiany.

Wersja 1.6.6

17 kwietnia 2024 r.

androidx.compose.runtime:runtime-*:1.6.6 został zwolniony. Brak zmian od ostatniej wersji.

Wersja 1.6.5

3 kwietnia 2024 r.

androidx.compose.runtime:runtime-*:1.6.5 został zwolniony. Wersja 1.6.5 zawiera te komity.

Wersja 1.6.4

20 marca 2024 r.

androidx.compose.runtime:runtime-*:1.6.4 został zwolniony. Wersja 1.6.4 zawiera te komitowane zmiany.

Wersja 1.6.3

6 marca 2024 roku

androidx.compose.runtime:runtime-*:1.6.3 został zwolniony. Wersja 1.6.3 zawiera te komisy.

Wersja 1.6.2

21 lutego 2024 r.

androidx.compose.runtime:runtime-*:1.6.2 został zwolniony. Wersja 1.6.2 zawiera te commity.

Wersja 1.6.1

7 lutego 2024 r.

androidx.compose.runtime:runtime-*:1.6.1 został zwolniony. Wersja 1.6.1 zawiera te zatwierdzenia.

Poprawki błędów

• Zadzwoń do onRelease w tej samej kolejności co onForgotten. (2cd790)
• Filtr zmienił stany, które nie są obserwowane w snapshotFlow. (796b80)

Wersja 1.6.0

24 stycznia 2024 r.

androidx.compose.runtime:runtime-*:1.6.0 został zwolniony. Wersja 1.6.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.5.0

Nowe funkcje

• Ponownie zgłaszaj wyjątki, które są pominięte podczas pętli rekompozycji (4dff9).

Optymalizacja skuteczności

• Optymalizacja modyfikacji nagrywania stanów zrzutu (28c3fe)
• Optimize rememberSaveable (f01d79)
• Opóźnienie ponownego odczytania stanów pochodnych do momentu zarejestrowania zmian (f38099)
• Poprawne podawanie wartości lokalnych kompozycji (a337ea)

Poprawki błędów

• Naprawiono wyciek pamięci w tabeli slotów (73fcfe).
• pomiń przekształcenie podkompozycji, które zostaną usunięte; (Ieeb99, b/254645321)
• Aktywuj cykle życia RememberObserver tylko wtedy, gdy są one przechowywane w obliczeniach pamięci. (f6b4dc)
• Ogranicz $dirty do ujętych w ramach wyrażeń lambda. (acfca0)
• Naprawianie problemu z przenośnymi treściami, które czasami otrzymują nieprawidłowe kompozycje lokalne. (035cd6)

Wersja 1.6.0-rc01

10 stycznia 2024 r.

androidx.compose.runtime:runtime-*:1.6.0-rc01 został zwolniony. Wersja 1.6.0-rc01 zawiera te commity.

Wersja 1.6.0-beta03

13 grudnia 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-beta03 został zwolniony. Wersja 1.6.0-beta03 zawiera te zatwierdzenia.

Wersja 1.6.0-beta02

29 listopada 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-beta02 został zwolniony. Wersja 1.6.0-beta02 zawiera te commity.

Wersja 1.6.0-beta01

15 listopada 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-beta01 został zwolniony. Wersja 1.6.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Rozpowszechnianie niektórych wartości stabilności w adnotacji. (274a4c)

Poprawki błędów

• Użyj zasady odniesienia do stanu lokalnego zakresu kompozycji w kontekście. (83361c)
• Ogranicz łańcuch $dirty do łańcuchów lambda wbudowanych. (acfca0)
• Naprawianie problemu z przenośnymi treściami, które czasami otrzymują nieprawidłowe kompozycje lokalne. (035cd6)
• Użyj szybszych map haszujących bez przydzielania pamięci w RecomposeScopeImpl. (d79494)
• Używaj konta ObjectIntMap w aplikacji DerivedState. (21862e)
• Użyj wartości IntRef dla typu danych int SnapshotThreadLocal w funkcji DerivedState. (04eaf4)

Wersja 1.6.0-alpha08

18 października 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha08 został zwolniony. Wersja 1.6.0-alpha08 zawiera te commity.

Poprawki błędów

• Aktywuj cykle życia RememberObserver tylko wtedy, gdy są one przechowywane w obliczeniach pamięci. (f6b4dc)
• Ulepszone przypisywanie w sortowaniu listy nieważności. (954d63)
• Używaj nowych map bez przydziału w sekcji SnapshotStateObserver. (4303ce)
• Wyczyść nieważne kompozycje po ich dezaktywacji. (e001be)

Wersja 1.6.0-alpha07

4 października 2023 roku

androidx.compose.runtime:runtime-*:1.6.0-alpha07 został zwolniony. Wersja 1.6.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

• SnapshotStateList jest teraz oznaczony jako RandomAccess, aby umożliwić użycie wersji indeksowania bezpośredniego pomocników list. (I5210c, b/219554654)

Wersja 1.6.0-alpha06

20 września 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha06 został zwolniony. Wersja 1.6.0-alpha06 zawiera te commity.

Wersja 1.6.0-alpha05

6 września 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha05 został zwolniony. Wersja 1.6.0-alpha05 zawiera te zatwierdzenia.

Wersja 1.6.0-alpha04

23 sierpnia 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha04 został zwolniony. Wersja 1.6.0-alpha04 zawiera te commity.

Nowe funkcje

• Ponownie zgłaszaj wyjątki, które są pominięte podczas pętli rekompozycji (4dff9).

Zmiany w interfejsie API

• Dodano metodę dezaktywacji ReusableComposition, która usuwa obserwacje, ale zachowuje węzły. Dezaktywowaną kompozycję można ponownie aktywować, wywołując funkcję setContent. (Ib7f31)
• Dodaj interfejs ReusableComposition do zarządzania cyklem życia i ponownego użycia podkompozycji. (I812d1, b/252846775)

Wersja 1.6.0-alpha03

9 sierpnia 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha03 został zwolniony. Wersja 1.6.0-alpha03 zawiera te commity.

Poprawki błędów

• Naprawić nową optymalizację CompositionLocalProvider (3118e88)
• Poprawiono sposób rozkładania ruchomych węzłów treści. (5e3d59b)

Wersja 1.6.0-alpha02

26 lipca 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha02 został zwolniony. Wersja 1.6.0-alpha02 zawiera te commity.

Nowe funkcje i ulepszenia

• Optymalizacja rememberSaveable (f01d79)
• Opóźnienie ponownego odczytania stanów pochodnych do momentu zarejestrowania zmian (f38099)
• Poprawne podawanie wartości lokalnych kompozycji (a337ea)
• SideEffect jest oznaczony jako @ExplicitGroupsComposable, aby uniknąć generowania grupy. (I74815)
• Unikaj porównywania lokalnych map kompozycji podczas ponownego użycia (782071)

Zmiany w interfejsie API

• Dodano przeciążenie dla specjalnego przypadku CompositionLocalProviders, które pozwala uniknąć obciążenia związanego z szybszym podawaniem wielu wartości, ale jest obciążeniem przy podawaniu pojedynczej wartości. (I6d640, b/288169379)

Poprawki błędów

• Naprawić wyciek pamięci w tabeli slotów (73fcfe).
• Poprawiamy sposób przywracania wartości rememberSaveable, gdy funkcja stateSaver zwraca wartość null (90748c)

Wersja 1.6.0-alpha01

21 czerwca 2023 r.

androidx.compose.runtime:runtime-*:1.6.0-alpha01 został zwolniony. Wersja 1.6.0-alpha01 zawiera te commity.

Poprawki błędów

• pomiń przekształcenie podkompozycji, które zostaną usunięte; (Ieeb99, b/254645321)
• Zmniejszone przydziały podczas stosowania zrzutów. (I65c09)
• Unikaj obliczania readableHash w funkcji DerivedState, jeśli zrzut nie został zmodyfikowany (68c565)

Wersja 1.5

Wersja 1.5.4

18 października 2023 r.

androidx.compose.runtime:runtime-*:1.5.4 został zwolniony. Wersja 1.5.4 zawiera te zatwierdzenia.

Wersja 1.5.3

4 października 2023 roku

androidx.compose.runtime:runtime-*:1.5.3 został zwolniony. Wersja 1.5.3 zawiera te zatwierdzenia.

Wersja 1.5.2

27 września 2023 r.

androidx.compose.runtime:runtime-*:1.5.2 został zwolniony. Wersja 1.5.2 zawiera te zatwierdzenia.

Wersja 1.5.1

6 września 2023 r.

androidx.compose.runtime:runtime-*:1.5.1 został zwolniony. Wersja 1.5.1 zawiera te zatwierdzenia.

Wersja 1.5.0

9 sierpnia 2023 r.

androidx.compose.runtime:runtime-*:1.5.0 został zwolniony. Wersja 1.5.0 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Usunięto alokacje w rekompozycji, animacjach kolorów i AndroidComposeView. (Ib2bfa)
• Dodano adnotację @StateFactoryMarker, aby oznaczać funkcje, które tworzą stany i muszą być zawinięte w wywołanie remember. (I64550)
• Dodanie prymitywnych wersji stanu i MutableState (fb3d89)
• Dodano Snapshot.isApplyObserverNotificationPending (I672a5)
• Dodano prymitywne wersje interfejsu API State, które umożliwiają śledzenie wartości Int, Long, Float i Double w obiektach State bez naliczania kar za automatyczne zaokrąglanie. Aby z nich korzystać, użyj nowych metod fabrycznych mutableIntState(Int), mutableFloatStateOf(Float) itp. (I48e43)

Poprawki błędów

• pomiń przekształcenie podkompozycji, które zostaną usunięte; (Ieeb99, b/254645321)
• Nie zachowuj odwołania do zrzutu w ComposerImpl (0206f7)
• Nie stosuj kompozycji dwukrotnie (f5791b)
• Sprawdzanie nieważności nieinicjowanych wartości stanu pochodnej (aa2a92)
• Wywołanie onEndChanges podczas usuwania kompozycji. (62cc8c)
• Naprawianie przenoszenia treści do podkompozycji (4beb41)
• Naprawiono potencjalne blokady (c1a425 i 8edce0).
• Rekompilator utworzony dla okna Androida będzie teraz blokować tylko wywołania do withFrameNanos, a nie wszystkie kompozycje, gdy otrzyma powiadomienie ON_STOP. Oznacza to, że okna powiązane z zatrzymanymi aktywnościami będą nadal zmieniać kompozycję pod kątem zmian danych, ale animacje lub inne wywołania withFrameNanos będą blokowane. (Id9e7f, b/240975572)
• Wykonywanie wywołań zwrotnych dezaktywacji dla LayoutNode przed usunięciem efektów 3784073
• Popraw zmienione flagi dla ponownie uruchomionych funkcji lambda ea81df9
• Naprawiono regresję edycji na żywo w przypadku komponentów z węzłami 73fd4d8
• W przypadku zdarzenia ON_STOP należy wstrzymać transmisje zegara ramki zamiast kompozycji ae276f1.
• Unkwalifikuj zakresy SnapshotStateObserver w przypadku niezmienionych stanów pochodnych 84d9b1c
• Naprawiono potencjalny impas podczas usuwania kompozycji 28761fc
• Naprawianie przenoszenia treści do podkompozycji 92d4156
• Naprawiono zmienione flagi dla ponownie uruchomionych funkcji lambda (8a03e9).
• Wykonywanie wywołań zwrotnych dezaktywacji dla LayoutNode przed usunięciem efektów (8b0fa4)
• Naprawianie błędu endToMarker() podczas zamykania grup węzłów. (d71d980)
• Używanie bieżącej grupy SlotWriter do sprawdzania dezaktywacji (a0b518b)
• Usuń fill w SlotTable.moveSlotGapTo() i przenieś go do zamknięcia (81f9935)
• Popraw brakujące unieważnienia podczas przenoszenia treści ruchomych (1d7c024)
• Napraw natychmiastowe unieważnienia w przypadku przeniesionych treści ruchomych (8676618)

Usprawnienia dotyczące wydajności

• Unikaj obliczania readableHash w funkcji DerivedState, jeśli zrzut nie został zmodyfikowany. (307102)
• Zmniejszone alokacje (I65c09, d7ea77, 727974 i 445808)
• Szybkie anulowanie tworzenia CoroutineScopes (a55362 i bd382f)
• Zastępowanie rekordów obiektów stanu rekordami stanu niedostępnych (c986960)
• Podczas tworzenia grup używaj kompozytora o odpowiednim zakresie (9a5e5b6).
• Użyj kolumny IdentityArraySet, aby przechowywać informacje o unieważnieniu zrzutów (7f60cca).
• Zmniejsz alokacje dla obserwacji zrzutów (5bc535f)

Wersja 1.5.0-rc01

26 lipca 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-rc01 został zwolniony. Wersja 1.5.0-rc01 zawiera te commity.

Poprawki błędów

• Opóźnienie ponownego odczytania stanów pochodnych do momentu zarejestrowania zmian (f38099)

• Dostępna jest opcjonalna inspekcja, która zaleca przeniesienie wywołań mutableStateOf() do odpowiednich typów specjalistycznych dla prymitywów. Identyfikator lint to AutoboxingStateCreation. Wcześniej ta kontrola była domyślnie włączona we wszystkich projektach. Aby wyświetlić to ostrzeżenie w edytorze Android Studio i w wyjściach lint projektu, zmień jego poziom ważności z informacyjnego na ostrzeżenie (lub wyższy), deklarując warning "AutoboxingStateCreation" w konfiguracji build.gradle lub build.gradle.kts modułu, jak pokazano na rysunku (I34f7e):

      android {
          lint {
              warning "AutoboxingStateCreation"
          }
          ...
      }
  

Wersja 1.5.0-beta03

28 czerwca 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-beta03 został zwolniony. Wersja 1.5.0-beta03 zawiera te commity.

Poprawki błędów

• pomiń przekształcenie podkompozycji, które zostaną usunięte; (Ieeb99, b/254645321)

Wersja 1.5.0-beta02

7 czerwca 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-beta02 został zwolniony. Wersja 1.5.0-beta02 zawiera te commity.

Usprawnienia dotyczące wydajności

• Unikaj obliczania readableHash w funkcji DerivedState, jeśli zrzut nie został zmodyfikowany. (307102)

Wersja 1.5.0-beta01

24 maja 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-beta01 został zwolniony. Wersja 1.5.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Usunięto alokacje w rekompozycji, animacjach kolorów i elementach AndroidComposeView (Ib2bfa).
• Dodano adnotację @StateFactoryMarker, aby oznaczać funkcje, które tworzą stany i muszą być zawinięte w wywołanie remember. (I64550)
• Dodanie prymitywnych wersji stanu i elementu MutableState (fb3d89)
• Dodano Snapshot.isApplyObserverNotificationPending (I672a5)

Poprawki błędów

• Zmniejszone alokacje (I65c09, d7ea77, 727974 i 445808)
• Nie zachowuj odwołania do zrzutu ekranu w ComposerImpl (0206f7)
• Szybkie anulowanie tworzenia CoroutineScopes (a55362 i bd382f)
• Nie stosuj kompozycji dwukrotnie (f5791b)
• Sprawdzanie nieważności nieinicjowanych wartości stanu pochodnej (aa2a92)
• Wywołanie onEndChanges podczas usuwania kompozycji. (62cc8c)
• Naprawianie przenoszenia treści do podkompozycji (4beb41)
• Naprawić potencjalne blokady (c1a425)
• W przypadku ON_STOP należy wstrzymać transmisje zegara ramki zamiast kompozycji (f4a2d1)
• Naprawiono zmienione flagi dla ponownie uruchomionych funkcji Lambda (8a03e9).
• Wykonywanie wywołań zwrotnych dezaktywacji dla LayoutNode przed usunięciem efektów (8b0fa4)

Darowizna zewnętrzna

• Dodano Snapshot.isApplyObserverNotificationPending (I672a5)

Wersja 1.5.0-alpha04

10 maja 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-alpha04 został zwolniony. Wersja 1.5.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

• Dodano prymitywne wersje interfejsu API State, które umożliwiają śledzenie wartości Int, Long, Float i Double w obiektach State bez naliczania kar za automatyczne zaokrąglanie. Aby z nich korzystać, użyj nowych metod fabrycznych mutableIntState(Int), mutableFloatStateOf(Float) itp. (I48e43)

Poprawki błędów

• Wywołanie onEndChanges podczas usuwania kompozycji. Węzły fokusu usunięte podczas Composition.dispose subskrybują onEndChanges, aby zresetować fokus.(03d4a47)

• Upewnij się, że wartości stanu pochodnej niesprawnej są nieważne. Każdy stan pochodzenia jest powiązany z listą swoich zależności w elementach SnapshotStateObserver, które służą do unieważniania zakresów powiązanych ze stanem pochodzenia, gdy zmieniają się zależności. Zmiana zależności jest rejestrowana w przypadku przejścia do następnego zrzutu, co może nastąpić po odczycie stanu pochodnej (z powodu wywołania funkcji Snapshot.notifyObjectsInitialized()).

  Wcześniejsza logika obserwacji stanu pochodnej w SnapshotStateObserver oczyszczała stare zależności, a potem odczytywała nową wartość. Sytuacja ta spowodowała wyścig z nieważeniem w oczyszczonym stanie, w którym nie zarejestrowano unieważnienia zależności.

  Ta zmiana zmienia kolejność odczytu pochodnej stanu i czyszczenia zależności, aby zapewnić, że unieważnienie zawsze będzie wykonywane w ważnym stanie. (c472be6)

Wersja 1.5.0-alpha03

19 kwietnia 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-alpha03 został zwolniony. Wersja 1.5.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• Rekompilator utworzony dla okna Androida będzie teraz blokować tylko wywołania do withFrameNanos, a nie wszystkie kompozycje, gdy otrzyma powiadomienie ON_STOP. Oznacza to, że okna powiązane z zatrzymanymi aktywnościami będą nadal zmieniać kompozycję pod kątem zmian danych, ale animacje lub inne wywołania withFrameNanos będą blokowane. (Id9e7f, b/240975572)

Poprawki błędów

• Poprawiono potencjalny stan blokady na liście zrzutów i mapie 5c1a425
• Wykonywanie wywołań zwrotnych dezaktywacji dla LayoutNode przed usunięciem efektów 3784073
• Popraw zmienione flagi dla ponownie uruchomionych funkcji lambda ea81df9
• Naprawiono regresję edycji na żywo w przypadku komponentów z węzłami 73fd4d8
• W przypadku ON_STOP należy wstrzymać transmisje zegara ramki zamiast kompozycji ae276f1
• Unkwalifikuj zakresy SnapshotStateObserver w przypadku niezmienionych stanów pochodnych 84d9b1c
• Poprawka dotycząca potencjalnego zablokowania się programu podczas usuwania kompozycji 28761fc
• Naprawianie przenoszenia treści do podkompozycji 92d4156

Wersja 1.5.0-alpha02

5 kwietnia 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-alpha02 został zwolniony. Wersja 1.5.0-alpha02 zawiera te commity.

Nowe funkcje

• Operator getValue w Kotlinie może być teraz składany (f174f6e)

Poprawki błędów i usprawnienia w zakresie wydajności

• Zastępowanie rekordów obiektów stanu rekordami stanu niedostępnymi (c986960)
• Podczas tworzenia grup używaj kompozytora o odpowiednim zakresie (9a5e5b6).
• Naprawianie błędu endToMarker() podczas zamykania grup węzłów. (d71d980)
• Używanie bieżącej grupy SlotWriter do sprawdzania dezaktywacji (a0b518b)
• Użyj kolumny IdentityArraySet, aby przechowywać informacje o unieważnieniu zrzutów (7f60cca).
• Usuń fill w SlotTable.moveSlotGapTo() i przenieś go do zamknięcia (81f9935)
• Popraw brakujące unieważnienia podczas przenoszenia treści ruchomych (1d7c024)
• Napraw natychmiastowe unieważnienia w przypadku przeniesionych treści ruchomych (8676618)
• Zmniejsz alokacje dla obserwacji zrzutów (5bc535f)

Wersja 1.5.0-alpha01

22 marca 2023 r.

androidx.compose.runtime:runtime-*:1.5.0-alpha01 został zwolniony. Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

• Dodanie Modifier.Node#coroutineScope, aby umożliwić Modifier.Nodes uruchamianie coroutines (I76ef9)
• Zezwól aplikacji Modifier.Nodes na odczytywanie CompositionLocals przez implementację interfejsu CompositionLocalConsumerModifierNode. (Ib44df)

Wersja 1.4

Wersja 1.4.3

3 maja 2023 r.

androidx.compose.runtime:runtime-*:1.4.3 jest opublikowany bez wprowadzenia zmian.

Wersja 1.4.2

19 kwietnia 2023 r.

androidx.compose.runtime:runtime-*:1.4.2 został zwolniony. Wersja 1.4.2 zawiera te zatwierdzenia.

Poprawki błędów

• Poprawiono potencjalny impas w liście i mapie zrzutów 2eb6570

• Dodawanie treści do tabeli SnapshotStateList lub SnapshotStateMap może spowodować blokadę, jeśli modyfikacja jest wykonywana równolegle z bezpośrednim zapisem w rekordzie stanu. Prawdopodobieństwo wystąpienia tego błędu znacznie wzrosło po wprowadzeniu zmian w wersji 93fcae828b, która używa bezpośrednich zapisów do zwalniania nieużywanych rekordów.

• Blokady są teraz uporządkowane w taki sposób, że blokada kopii podglądowej nigdy nie jest wykonywana, gdy blokada mapy lub listy jest aktywna.

Wersja 1.4.1

5 kwietnia 2023 r.

androidx.compose.runtime:runtime-*:1.4.1 został zwolniony. Wersja 1.4.1 zawiera te zatwierdzenia.

Poprawki błędów

• Napraw endToMarker(), gdy kończysz grupy węzłów. d71d980

Wersja 1.4.0

22 marca 2023 r.

androidx.compose.runtime:runtime-*:1.4.0 został zwolniony. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

• Użyj zainicjowanej wartości z LiveData w przypadku pierwszej kompozycji 3680e25
• Dodaj ComposeNodeLifecycleCallback, aby obserwować cykl życia węzłów usługi Compose. 8b6a258
• Dodaj usługę parameterTypes do usługi ComposableMethod 7b6c7ad

Poprawki błędów i usprawnienia w zakresie wydajności

• Wyczyść oba indeksy zakresu w SnapshotStateObserver 29f4a3e
• Dodaj grupy potrzebne w treści nieprzeskakalnych funkcji lambda 7d06752
• Poprawa cech odwołań do pamięci w stanie zrzutu 93fcae8
• Usuwanie boksowania w wyszukiwaniu lokalnym kompozycji 0875717
• Używanie prawidłowego klucza w przypadku grup węzłów, których nie można ponownie użyć 6388d8d
• Ochrona SnapshotStateObserver przed rekurencyjnym i jednoczesnym zastosowaniem 98cb6ba
• Dodano sprawdzanie zakresu indeksu w metodie „get” klasy IdentityArraySet (35a77d3).
• Zaktualizuj moduł tworzenia wiadomości, aby używać rozszerzeń ViewTreeLifecycleOwner 21c2122
• Wysyłanie powiadomień o zastosowaniu po zakończeniu procesu rekompozycji. 98f2641
• Naprawiono błąd awarii podczas anulowania rekompilacji 8f8656f
• Zawsze wymuszaj ponowne złożenie, jeśli dostawcy nadrzędni usługi Composition uległy zmianie 9526fcc
• Tolerancja rekompilatora dla anulowanych zadań a55f7ed
• Ulepszenie obsługi unieważnień w przypadku dużej liczby kompozytorów 9b7ed67
• Poprawianie generowania grup zamknięcia w przypadku zwrotów nielokalnych b6f590c

Wersja 1.4.0-rc01

8 marca 2023 r.

androidx.compose.runtime:runtime-*:1.4.0-rc01 został zwolniony. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

• Wyczyść oba indeksy zakresu w pliku SnapshotStateObserver

Wersja 1.4.0-beta02

22 lutego 2023 roku

androidx.compose.runtime:runtime:1.4.0-beta02 i androidx.compose.runtime:runtime-saveable:1.4.0-beta02 są dostępne. Wersja 1.4.0-beta02 zawiera te zatwierdzenia.

Wersja 1.4.0-beta01

8 lutego 2023 r.

androidx.compose.runtime:runtime-*:1.4.0-beta01 został zwolniony. Wersja 1.4.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Dodano ComposeNodeLifecycleCallback, który umożliwia obserwowanie cyklu życia węzłów Compose (I3731b).
• Dodano @TestOnly do Composer.disableSourceInformation(), ponieważ tę funkcję można bezpiecznie wywołać tylko w ramach testu. (I896c8)

Poprawki błędów

• Usuwanie boksowania w wyszukiwaniu lokalnym kompozycji (62f66a)
• Ulepszanie cech odwołań do pamięci w stanie zrzutu (dfb451)

Wersja 1.4.0-alpha05

25 stycznia 2023 r.

androidx.compose.runtime:runtime:1.4.0-alpha05 i androidx.compose.runtime:runtime-saveable:1.4.0-alpha05 są dostępne. Wersja 1.4.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

• Więcej typów i możliwości ustawienia wartości w przypadku funkcji wbudowanych i wycofanych (I24f91)

Wersja 1.4.0-alpha04

11 stycznia 2023 r.

androidx.compose.runtime:runtime-*:1.4.0-alpha04 został zwolniony. Wersja 1.4.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

• Kampania TestMonotonicFrameClock używa teraz prawidłowej adnotacji eksperymentalnej. (I95c9e)

Poprawki błędów

• Chroń SnapshotStateObserver przed rekurencyjnym i jednoczesnym zastosowaniem (d902fb)

Wersja 1.4.0-alpha03

7 grudnia 2022 r.

androidx.compose.runtime:runtime-*:1.4.0-alpha03 został zwolniony. Wersja 1.4.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• dodanie do klasy ComposableMethod nowej publicznej metody analogicznej do java.lang.reflect.Method#getParameterTypes() (Iab0c3);

Poprawki błędów

• Powiadomienia o zastosowaniu migawki są teraz wysyłane po zakończeniu stosowania zmian przez Recomposer. (Iad6c0, b/222093277)

Wersja 1.4.0-alpha02

9 listopada 2022 r.

androidx.compose.runtime:runtime-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te commity.

Wersja 1.4.0-alpha01

24 października 2022 r.

androidx.compose.runtime:runtime-*:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• W wersjach SnapshotStateList i SnapshotStateMap są teraz jawnie zaimplementowane odpowiednio toList() i toMap(). Te metody zwracają bieżące dane bez ich kopiowania, ponieważ zwracają wewnętrzne niezmienne dane używane do przechowywania treści. Wartość ta może być używana np. do generowania przepływu wartości za pomocą funkcji snapshotFlow bez konieczności kopiowania danych. (Ica2bd)

Wersja 1.3

Wersja 1.3.3

11 stycznia 2023 r.

androidx.compose.runtime:runtime-*:1.3.3 został zwolniony. Wersja 1.3.3 zawiera te zatwierdzenia.

• Bez zmian od wersji 1.3.2

Wersja 1.3.2

7 grudnia 2022 r.

androidx.compose.runtime:runtime-*:1.3.2 został zwolniony. Wersja 1.3.2 zawiera te zatwierdzenia.

Poprawki błędów

• Zaktualizowano, aby obsługiwać androidx.compose.ui 1.3.2

Wersja 1.3.1

9 listopada 2022 r.

androidx.compose.runtime:runtime-*:1.3.1 został zwolniony. Wersja 1.3.1 zawiera te commity.

Wersja 1.3.0

24 października 2022 r.

androidx.compose.runtime:runtime-*:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te commity.

Ważne zmiany od wersji 1.2.0

Obsługa wyjątków / edytowanie na żywo

• Aby lepiej obsługiwać edycję na żywo, dodano interfejsy API umożliwiające obsługę wyjątków podczas komponowania.
• Obsługa błędów kompozycji w przypadku gorącego przeładowania
• Przetwarzanie błędów podczas edycji na żywo podczas zapisywania lub przywracania

Śledzenie kompozycji

• Dodano interfejsy API do śledzenia w czasie wykonywania, aby obsługiwać nowe narzędzia do śledzenia kompozycji.
• Generowanie wywołań funkcji rozpoczęcia i zakończenia zdarzenia do składania
• Dodano ponownie ComposerKt.traceEventStart(Int, String)

Interfejsy API do składania zapytań

• Dodano nowy interfejs API ComposableMethod, aby umożliwić bardziej niezawodne wywoływanie interfejsów API do składania za pomocą mechanizmu odzwierciedlenia.
• Przeniesienie invokeComposable do kompilacji czasu działania
• Zmodyfikowanie interfejsu API w celu wywołania metody kompozytowej

Poprawki w czasie działania

• Napraw błędny test zakresu w tabeli slotów sprawdzający markery
• Zezwalanie na przenoszenie treści do i z elementu SubcomposeLayout
• Poprawka dotycząca przenoszenia treści do nowych komponentów podrzędnych

System zrzutów

• System migawek został ulepszony pod kątem zarządzania pamięcią, wydajności i poprawności.
• Optymalizacja usuwania zakresu w SnapshotStateObserver
• usuwanie zagnieżdżonych zrzutów utworzonych z przezroczystych zrzutów
• Naprawiono warunek wyścigu podczas odczytu stanu z globalnego snapshotu
• Obsługa DerivedState w SnapshotStateObserver
• Zapobieganie usuwaniu stanu pochodnej z kompozycji podczas jego odczytu w innych zakresach
• Używanie mapy IdentityArrayMap zamiast mapy HashMap w DerivedState
• Aktualizowanie obserwatorów stanu pochodnej, aby używały wektora zmiennego
• Aktualizacja czyszczenia stanu SnapshotStateObserver
• Zastąp SnapshotStateObserver.invalidated metodą ArraySet
• Naprawiono warunek wyścigu podczas odczytu stanu z globalnego snapshotu
• Naprawienie problemu z użyciem nieaktualnego rekordu w obliczeniach hasz stanu pochodnej
• Rozwiązanie problemu z warunkiem wyścigu podczas przechodzenia do globalnego zrzutu
• przyspieszenie czyszczenia obserwacji zakresu w SnapshotStateObserver,

Wersja 1.3.0-rc01

5 października 2022 r.

androidx.compose.runtime:runtime-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

Poprawki błędów

• Naprawiono błąd ArrayIndexOutOfBoundsException występujący w tabeli slotów (b/249076084).

Wersja 1.3.0-beta03

21 września 2022 r.

androidx.compose.runtime:runtime-*:1.3.0-beta03 został zwolniony. Wersja 1.3.0-beta03 zawiera te zatwierdzenia.

Zachowanie powodujące niezgodność

• Parametry remember i rememberCoroutineScope zmieniono na crossinline. W takim przypadku zamiast zezwolić na wcześniejszy zwrot, zostanie zgłoszony błąd.
• Ta zmiana może spowodować zgłoszenie nowych błędów kompilatora, które wymagają usunięcia z funkcji lambda przekazywanych do tych funkcji zwracania wartości nielokalnych. (Ibea62)

Wersja 1.3.0-beta02

7 września 2022 roku

androidx.compose.runtime:runtime-*:1.3.0-beta02 został zwolniony. Wersja 1.3.0-beta02 zawiera te commity.

Poprawki błędów

• Zaktualizowany interfejs API (I64ca0)

Wersja 1.3.0-beta01

24 sierpnia 2022 r.

androidx.compose.runtime:runtime-*:1.3.0-beta01 został zwolniony. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Do interfejsu CompositionData dodano metodę find, aby narzędzia deweloperów korzystające z tego interfejsu API mogły szybko znajdować podgrupę kompozycji na podstawie jej tożsamości. (I5794f)

Wersja 1.3.0-alpha03

10 sierpnia 2022 r.

androidx.compose.runtime:runtime-*:1.3.0-alpha03 został zwolniony. Wersja 1.3.0-alpha03 zawiera te commity.

Wersja 1.3.0-alpha02

27 lipca 2022 roku

androidx.compose.runtime:runtime-*:1.3.0-alpha02 został zwolniony. Wersja 1.3.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Ponownie dodano ComposerKt.traceEventStart(Int, String) w celu zachowania zgodności wstecznej (I6e6de)

Wersja 1.3.0-alpha01

29 czerwca 2022 r.

androidx.compose.runtime:runtime-*:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Przenoszenie funkcji narzędzia do czasu wykonywania (I4f729)

Wersja 1.2

Wersja 1.2.1

10 sierpnia 2022 r.

androidx.compose.runtime:runtime-*:1.2.1 został zwolniony. Wersja 1.2.1 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiono wyciek pamięci: usuwanie zagnieżdżonych zrzutów utworzonych z przejrzystych zrzutów b/239603305

Wersja 1.2.0

27 lipca 2022 roku

androidx.compose.runtime:runtime-*:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

• W wersji 1.2.0 środowiska wykonawczego Compose dodano kilka funkcji oraz wiele poprawek błędów, które poprawiły stabilność. Najważniejszą nową funkcją było wprowadzenie interfejsu movableContentOf API, który umożliwia tworzenie złożonych interfejsów użytkownika, takich jak przejścia między elementami. Interfejs API movableContentOf zamienia funkcję lambda składającą się z elementów w funkcję lambda, która przenosi stan i odpowiednie węzły do dowolnej nowej lokalizacji, w której zostanie wywołana. Gdy poprzednie wywołanie opuszcza kompozycję, stan jest tymczasowo zachowany, a jeśli nowe wywołanie do funkcji lambda wchodzi do kompozycji, stan i powiązane węzły są przenoszone do lokalizacji nowego wywołania. Jeśli nie dodasz nowych połączeń, stan zostanie trwale usunięty, a obserwatorzy zostaną o tym powiadomieni.

• Jeśli funkcja lambda movableContentOf jest wywoływana wielokrotnie w tej samej kompozycji, dla każdego wywołania tworzone są nowe stany i węzły. Gdy wywołania opuszczają kompozycję i wchodzą nowe, stan jest przenoszony z pierwszych wywołań na wchodzące w kolejności ich wywołania. Wszystkie stany, które nie zostały zajęte przez nowe połączenia, zostaną trwale usunięte.

• Oprócz tej i kilku innych nowych funkcji poświęciliśmy dużo czasu na stabilizację środowiska uruchomieniowego i systemu stanu zrzutu. Usunięto różne wycieki pamięci i zoptymalizowano ścieżki kodu.

• Poniżej znajdziesz podsumowaną listę zmian:

Nowe funkcje w 1.2

• Dodawanie eksperymentalnego zdjęcia unsafeEnter/Leave
• Dodawanie eksperymentalnego interfejsu Snapshot.asContextElement API
• Wprowadzenie do Snapshot.withoutReadObservation
• Pozwalanie na zmianę stanu w ramach kompozycji
• Śledzenie rekompozycji w sekcji Komponowanie

Wydajność w 1.2

• Zwiększanie skuteczności kompozycji na poziomie lokalnym
• Podstawowe profile dla usługi Compose należy wyprowadzić na podstawie wartości porównawczych

Poprawki błędów w 1.2

• Usuwanie informacji o śledzeniu z zakresów rekompozycji wersji
• Zapobieganie usuwaniu stanu pochodnej z kompozycji podczas jego odczytu w innych zakresach
• Używanie bardziej wydajnej funkcji removeScope() w SnapshotStateObserver
• Porządkowanie zależności stanu pochodnej w kompozycji
• Napraw problem polegający na zmianie wartości currentCompositeKeyHash po wewnętrznym przekształceniu w ramach treści ruchomych
• Czyszczenie nieprawidłowych kompozycji podczas usuwania
• Naprawianie stanu pochodnej odczytywanego podczas rekompozycji
• Naprawianie wycieku pamięci podczas obserwowania obiektów stanu pochodnej
• Zgodność klucza złożonego hash movableContent
• Naprawiono błąd, który powodował zawieszanie się edytora
• Sprawdzanie, czy wymuszenie unieważnienia grupy powoduje ponowne skompilowanie
• Poprawiono błąd polegający na tym, że funkcja rememberSaveable z danymi wejściowymi była przywracana w nieprawidłowym porządku

Wersja 1.2.0-rc03

29 czerwca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-rc03 został zwolniony. Wersja 1.2.0-rc03 zawiera te zatwierdzenia.

Poprawki błędów

• Wcześniej obserwacje stanu pochodnej były bezwarunkowo usuwane z zakresu ponownego złożenia i z kompozycji, co powodowało problemy z innymi zakresami, które mogły nadal obserwować stan pochodnej. Ta zmiana usuwa tylko pochodne wystąpienia stanu, jeśli nie są one już obserwowane przez inne zakresy. (b/236618362)

Wersja 1.2.0-rc02

22 czerwca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-rc02 został zwolniony. Wersja 1.2.0-rc02 zawiera te zatwierdzenia.

Wersja 1.2.0-rc01

15 czerwca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Interfejsy w bibliotekach kompozytowych są teraz tworzone za pomocą domyślnych metod interfejsu JDK 8 (I5bcf1).

Wersja 1.2.0-beta03

1 czerwca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-beta03 został zwolniony. Wersja 1.2.0-beta03 zawiera te commity.

Wersja 1.2.0-beta02

18 maja 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-beta02 został zwolniony. Wersja 1.2.0-beta02 zawiera te commity.

Wersja 1.2.0-beta01

11 maja 2022 roku

androidx.compose.runtime:runtime-*:1.2.0-beta01 został zwolniony. Wersja 1.2.0-beta01 zawiera te commity.

Nowe funkcje

• To pierwsza wersja beta 1.2.

Zmiany w interfejsie API

• Dodano eksperymentalną wersję Snapshot.unsafeEnter/unsafeLeave (I108f3)
• Dodano eksperymentalny interfejs API Snapshot.asContextElement() (Iff072).
• Adnotacja @ComposableTarget i adnotacje oznaczone symbolem @ComposableTargetMarker mogą być teraz używane w zakresie pliku za pomocą prefiksu @file. Jeśli użyjesz adnotacji docelowej w zakresie pliku, kompilator założy, że wszystkie funkcje kompozytowe w pliku są przeznaczone do użycia przez powiązany aplikator. Na przykład użycie @file:UiComposable oznacza, że wszystkie funkcje @Composable są kierowane do narzędzia do tworzenia interfejsu użytkownika. Funkcja, która musi być kierowana na innego aplikatora, musi wyraźnie podać adnotację znacznika docelowego dla odpowiedniego aplikatora. (I40804)

Wersja 1.2.0-alpha08

20 kwietnia 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha08 został zwolniony. Wersja 1.2.0-alpha08 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano TracingInProgress do interfejsu CompositionTracer. (Ic6f12)
• Dodawanie recomposeScopeIdentity do Composer (I0c873)
• Interfejsy API do śledzenia z ograniczeniami (Composer.setTracer) to OptIn(InternalComposeTracingApi). (I9187f)
• Dodano ResuableContentHost, co pozwala lepiej kontrolować czas trwania stanu utworzonego dla treści wielokrotnego użytku. Jeśli na przykład podkompozycja jest tymczasowo nieużywana, można ją dezaktywować, co spowoduje zapomnienie całego zapamiętanego stanu w kompozycji, powodując np. wymuszenie zapomnienia wszystkich efektów jednorazowych. (I2c0f2, b/220322704)

Wersja 1.2.0-alpha07

6 kwietnia 2022 roku

androidx.compose.runtime:runtime-*:1.2.0-alpha07 został zwolniony. Wersja 1.2.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

• Dodano nową funkcję Snapshot.withoutReadObservation { ... }. Umożliwia użytkownikom uruchomienie przekazanej funkcji lambda bez subskrybowania zmian wartości stanu odczytanych w ramach tego bloku. Może się to przydać w przypadku, gdy chcesz korzystać z funkcji zapisu/odczytu w ramach wątku bezpiecznego na podstawie zrzutu, ale jednocześnie chcesz mieć możliwość odczytania wartości bez powodowania niepotrzebnej zmiany składu lub ponownego pomiaru. (I9f365, b/214054486)

Wersja 1.2.0-alpha06

23 marca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha06 został zwolniony. Wersja 1.2.0-alpha06 zawiera te commity.

Wersja 1.2.0-alpha05

9 marca 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha05 został zwolniony. Wersja 1.2.0-alpha05 zawiera te commity.

Darowizna zewnętrzna

• Zaktualizowano do wersji Kotlinx coroutines 1.6.0 (I3366d).

Wersja 1.2.0-alpha04

23 lutego 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha04 został zwolniony. Wersja 1.2.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

• Dodano funkcje ComposableTarget, ComposableTargetMarker i ComposableOpenTarget, które umożliwiają raportowanie w czasie kompilacji, gdy wywoływana jest funkcja typu „composable” kierowana na obiekt, który nie jest przeznaczony do jej użycia.

  W większości przypadków adnotacje mogą być wywnioskowane przez wtyczkę kompilatora Compose, więc rzadko trzeba używać ich bezpośrednio . Do przypadków, w których nie można wywnioskować typu danych, należą tworzenie i używanie niestandardowego aplikatora, abstrakcyjnych funkcji składanych (np. metod interfejsu), pól lub zmiennych globalnych, które są składanymi funkcjami lambda (lokalne zmienne i parametry są wywnioskowane) oraz używanie funkcji ComposeNode lub powiązanych funkcji składanych.

  W przypadku niestandardowych funkcji dopasowujących funkcje składane, które wywołują ComposeNode lub ReusableComposeNode, muszą dodać adnotację CompoableTarget dla funkcji i wszystkich typów parametrów funkcji składanych lambda. Zalecamy jednak utworzenie adnotacji z oznaczeniem ComposableTargetMarker, a następnie używanie adnotacji z oznaczeniem zamiast bezpośrednio ComposableTarget. Kompozytowa adnotacja oznaczona symbolem ComposableTargetMarker jest równoważna atrybucie ComposbleTarget z pełną nazwą klasy atrybutu jako parametrem aplikatora. Przykład użycia funkcji ComposableTargetMarker znajdziesz w sekcji anroidx.compose.ui.UiComposable. (I38f11)

Wersja 1.2.0-alpha03

9 lutego 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha03 został zwolniony. Wersja 1.2.0-alpha03 zawiera te komisy.

Zmiany w interfejsie API

• Dodano funkcję movableContentOf, która zamienia składaną funkcję lambda na funkcję lambda, która przenosi stan i odpowiednie węzły do dowolnej nowej lokalizacji, w której zostanie wywołana. Gdy poprzednie wywołanie opuszcza składnię, stan jest tymczasowo zachowany, a jeśli nowe wywołanie do funkcji lambda wchodzi do kompozycji, stan i powiązane węzły są przenoszone do lokalizacji nowego wywołania. Jeśli nie dodasz nowego wywołania, stan zostanie trwale usunięty, a obserwatorzy zostaną o tym powiadomieni.

  Jeśli funkcja movableContentOf lambda jest wywoływana wielokrotnie w tej samej kompozycji, dla każdego wywołania tworzony jest nowy stan i nowe węzły. Gdy wywołania opuszczają kompozycję i wchodzą nowe wywołania, stan jest przenoszony z pierwszych wywołań na opuszczające wywołania w kolejności ich wywołania. Wszystkie stany, które nie zostały zadeklarowane przez nowe połączenia, zostaną trwale usunięte. (Ib4850)

• Dodano interfejs API śledzenia do kompozycji, aby umożliwić narzędziom bardziej szczegółowe śledzenie funkcji kompozytowych. Kompilator generuje teraz wywołania interfejsu API śledzenia, które zawierają informacje o źródle. (Ib0eb5)

  Aby usunąć te wywołania i powiązane z nimi informacje o źródle z kompilacji wersji, dodaj tę regułę Proguard:

    -assumenosideeffects public class androidx.compose.runtime.ComposerKt {
        boolean isTraceInProgress();
        void traceEventStart(int,java.lang.String);
        void traceEventEnd();
    }
  

• Dodaj InternalComposeScope, co pozwoli narzędziom rozpoznawać komponenty podczas rekompozycji. (I07a3f)

Wersja 1.2.0-alpha02

26 stycznia 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Wersja 1.2.0-alpha01

12 stycznia 2022 r.

androidx.compose.runtime:runtime-*:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Dodaliśmy pole identity do CompositionData na potrzeby generowania identyfikatorów niezmiennych w Inspektorze układu. (Ic116e)

Aktualizacje zależności

• Teraz zależy od Kotlina 1.6.10.

Wersja 1.1

Wersja 1.1.1

23 lutego 2022 r.

androidx.compose.runtime:runtime-*:1.1.1 został zwolniony. Wersja 1.1.1 zawiera te zatwierdzenia.

Poprawki błędów

• Napraw NullPointerException w androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList (aosp/1947059, b/206677462).
• Naprawiono awarię spowodowaną przez zawartość schowka podczas odczytu ze schowka na Androidzie. (I06020, b/197769306)
• Naprawiono RTL w LazyVerticalGrid (aosp/1931080, b/207510535).

Wersja 1.1.0

9 lutego 2022 r.

androidx.compose.runtime:runtime-*:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.0.0

• stabilna obsługa efektu przewijania do końca w Androidzie 12,
• Ulepszone dopasowywanie rozmiaru dotyku
• Pamiętaj, że w wersji Compose 1.0 komponenty Material Design będą rozszerzać swoją przestrzeń układu, aby spełniać wytyczne Material Design dotyczące rozmiaru docelowego elementu dotykowego. Na przykład docelowy element dotykowy przycisku będzie miał co najmniej rozmiar 48x48dp, nawet jeśli ustawisz mniejszy rozmiar przycisku. Dzięki temu komponenty Compose będą działać tak samo jak komponenty Material Design, co zapewni spójność, jeśli użyjesz widoków i Compose. Ta zmiana zapewnia też, że podczas tworzenia interfejsu użytkownika za pomocą komponentów Compose Material zostaną spełnione minimalne wymagania dotyczące dostępności docelowych elementów dotykowych.
• stabilna obsługa kolumny nawigacji,
• przekształciliśmy kilka wcześniej eksperymentalnych interfejsów API w stabilne.
• Obsługa nowszych wersji Kotlina

Wersja 1.1.0-rc03

26 stycznia 2022 r.

androidx.compose.runtime:runtime-*:1.1.0-rc03 został zwolniony. Wersja 1.1.0-rc03 zawiera te commity.

Poprawki błędów

• Zaktualizowano, aby obsługiwać komponowanie materiału 1.1.0-rc03

Wersja 1.1.0-rc01

15 grudnia 2021 roku

androidx.compose.runtime:runtime-*:1.1.0-rc01 został zwolniony. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Wersja 1.1.0-beta04

1 grudnia 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-beta04 został zwolniony. Wersja 1.1.0-beta04 zawiera te commity.

Nowe funkcje

• Zaktualizowano, aby zapewnić zgodność z Kotlin 1.6.0

Wersja 1.1.0-beta03

17 listopada 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-beta03 został zwolniony. Wersja 1.1.0-beta03 zawiera te commity.

Wersja 1.1.0-beta02

3 listopada 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-beta02 został zwolniony. Wersja 1.1.0-beta02 zawiera te commity.

Zmiany w interfejsie API

• Kod zrzutu został podzielony na kilka plików, ale wszystkie nadal znajdują się w tej samej klasie JVM. (Ic6c98)

Wersja 1.1.0-beta01

27 października 2021 roku

androidx.compose.runtime:runtime-*:1.1.0-beta01 został zwolniony. Wersja 1.1.0-beta01 zawiera te commity.

Wersja 1.1.0-alpha06

13 października 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-alpha06 został zwolniony. Wersja 1.1.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

• Usunięto InternalCompilerApi z metod Composer, które muszą być wywoływane w ramach modułów (I1aa0b).
• Recomposer.state zostało wycofane i zastąpione przez Recomposer.currentState, aby zmienić jego typ na StateFlow (Ic2ab3, b/197773820).

Wersja 1.1.0-alpha05

29 września 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-alpha05 został zwolniony. Wersja 1.1.0-alpha05 zawiera te commity.

Wersja 1.1.0-alpha04

15 września 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-alpha04 został zwolniony. Wersja 1.1.0-alpha04 zawiera te commity.

Wersja 1.1.0-alpha03

1 września 2021 roku

androidx.compose.runtime:runtime-*:1.1.0-alpha03 został zwolniony. Wersja 1.1.0-alpha03 zawiera te commity.

Nowe funkcje

• Kompilator Compose obsługuje teraz starsze wersje środowiska wykonawczego Compose (1.0). Przed tą zmianą kompilator Compose był zgodny tylko ze środowiskiem wykonawczym Compose tej samej lub nowszej wersji. Po tej zmianie kompilator Compose jest zgodny ze starszą wersją środowiska wykonawczego Compose (1.0). (aosp/1796968)
• Zaktualizowano Compose 1.1.0-alpha03, aby zależało od Kotlina 1.5.30. (I74545)

Wersja 1.1.0-alpha02

18 sierpnia 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-alpha02 został zwolniony. Wersja 1.1.0-alpha02 zawiera te commity.

Wersja 1.1.0-alpha01

4 sierpnia 2021 r.

androidx.compose.runtime:runtime-*:1.1.0-alpha01 został zwolniony. Wersja 1.1.0-alpha01 zawiera te commity.

Wersja 1.0

Wersja 1.0.5

3 listopada 2021 r.

androidx.compose.runtime:runtime-*:1.0.5 został zwolniony. Wersja 1.0.5 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiono problem ze śledzeniem awarii w przypadku instancji derivedStateOf. (aosp/1792247)

Wersja 1.0.4

13 października 2021 r.

androidx.compose.runtime:runtime-*:1.0.4 został zwolniony. Wersja 1.0.4 zawiera te zatwierdzenia.

Aktualizacje zależności

• Zaktualizowano, aby zależało od Kotlina 1.5.31

Wersja 1.0.3

29 września 2021 r.

androidx.compose.runtime:runtime-*:1.0.3 został zwolniony. Wersja 1.0.3 zawiera te zatwierdzenia.

Aktualizacje zależności

• Zaktualizowano, aby zależało od Kotlina 1.5.30

Wersja 1.0.2

1 września 2021 roku

androidx.compose.runtime:runtime-*:1.0.2 został zwolniony. Wersja 1.0.2 zawiera te zatwierdzenia.

Zaktualizowano, aby obsługiwać wersję 1.0.2 aplikacji Compose. Compose 1.0.2 jest nadal zgodny z Kotlinem 1.5.21.

Wersja 1.0.1

4 sierpnia 2021 r.

androidx.compose.runtime:runtime-*:1.0.1 został zwolniony. Wersja 1.0.1 zawiera te zatwierdzenia.

Aktualizacje zależności

• Zaktualizowano, aby zależało od Kotlina 1.5.21.

Wersja 1.0.0

28 lipca 2021 roku

androidx.compose.runtime:runtime-*:1.0.0 został zwolniony. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

To pierwsza stabilna wersja Compose. Więcej informacji znajdziesz na oficjalnym blogu Compose Release.

Znane problemy

• Jeśli używasz Android Studio Bumblebee Canary 4 lub AGP 7.1.0-alpha04/7.1.0-alpha05, możesz napotkać ten błąd:

    java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
  

  Aby to naprawić, tymczasowo zwiększ wartość minSdkVersion w pliku build.gradle do 24 lub więcej. Ten problem zostanie rozwiązany w następnej wersji Android Studio Bumblebee i AGP 7.1. (b/194289155)

Wersja 1.0.0-rc02

14 lipca 2021 roku

androidx.compose.runtime:runtime-*:1.0.0-rc02 został zwolniony. Wersja 1.0.0-rc02 zawiera te zatwierdzenia.

• Naprawiono warunki współzawodnictwa w SnapshotStateObserver, które powodowały niepotrzebne wyjątki NullPointerException. (aosp/1763445, aosp/1758105, b/192677711)
• Rozwiązaliśmy problemy z migawkami w czasie wykonywania, które powodowały awarie java.lang.IllegalStateException: Reading a state that was created after the snapshot was taken or in a snapshot that has not yet been applied. (b/193006595, b/192570897)

Wersja 1.0.0-rc01

1 lipca 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-rc01 został zwolniony. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Wersja 1.0.0-beta09

16 czerwca 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta09 został zwolniony. Wersja 1.0.0-beta09 zawiera te commity.

Dodano reguły profilu

W tej wersji dodaliśmy reguły profilu do tych modułów tworzenia wiadomości (I14ed6):

• androidx.compose.animation
• androidx.compose.animation-core
• androidx.compose.foundation
• androidx.compose.foundation-layout
• androidx.compose.material
• androidx.compose.material-ripple
• androidx.compose.runtime
• androidx.compose.ui
• androidx.compose.ui.geometry
• androidx.compose.ui.graphics
• androidx.compose.ui.text
• androidx.compose.ui.text
• androidx.compose.ui.unit
• androidx.compose.ui.util

Co to są reguły profilu?

• Reguły profilu biblioteki są określone w pliku tekstowym baseline-prof.txt znajdującym się w katalogu src/main lub równoważnym. Plik określa regułę na wiersz, gdzie reguła w tym przypadku jest wzorcem dopasowywania do metod lub klas w bibliotece. Składnia tych reguł jest superzbiorem czytelnego dla człowieka formatu profilu ART, który jest używany podczas korzystania z adb shell profman --dump-classes-and-methods .... Te reguły mogą mieć jedną z 2 form, aby kierować się na metody lub klasy.

• Reguła metody ma taki wzór:

  <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
  

• Reguła klasy będzie miała ten wzór:

  <CLASS_DESCRIPTOR>
  

• Tutaj <FLAGS> to co najmniej jeden z znaków H, S lub P, który wskazuje, czy ta metoda powinna być oznaczona jako „Aktywna”, „Uruchamianie” lub „Po uruchomieniu”.

• <CLASS_DESCRIPTOR> to deskryptor klasy, do której należy docelowa metoda. Na przykład klasa androidx.compose.runtime.SlotTable miałaby opis Landroidx/compose/runtime/SlotTable;.

• <METHOD_SIGNATURE> to sygnatura metody, która zawiera nazwę, typy parametrów i typ zwracany metody. Na przykład metoda fun isPlaced(): Boolean w klasie LayoutNode ma sygnaturę isPlaced()Z.

• Te wzorce mogą zawierać symbole wieloznaczne (**, * i ?), aby jedno reguła obejmowała wiele metod lub klas.

Do czego służą reguły?

• Metoda z flagą H wskazuje, że jest to metoda „gorąca” i należy ją skompilować z wyprzedzeniem.

• Metoda z flagą S wskazuje, że jest to metoda wywoływana podczas uruchamiania, i powinna zostać skompilowana wcześniej, aby uniknąć kosztów kompilacji i interpretacji metody podczas uruchamiania.

• Metoda z flagą P wskazuje, że jest wywoływana po uruchomieniu.

• Klasa obecna w tym pliku wskazuje, że jest używana podczas uruchamiania i należy ją wstępnie przydzielić do stosu, aby uniknąć kosztów wczytywania klasy.

Jak to działa?

• Biblioteki mogą definiować te reguły, które zostaną zapakowane w artefakty AAR. Gdy skompilowana aplikacja zawiera te elementy, reguły są scalane, a scalane reguły są używane do tworzenia kompaktowego binarnego profilu ART, który jest specyficzny dla aplikacji. ART może następnie wykorzystać ten profil, gdy aplikacja zostanie zainstalowana na urządzeniach, aby z wyprzedzeniem skompilować określony podzbiór aplikacji w celu poprawy jej wydajności, zwłaszcza podczas pierwszego uruchomienia. Pamiętaj, że nie będzie to miało wpływu na aplikacje z możliwością debugowania.

Wersja 1.0.0-beta08

2 czerwca 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta08 został zwolniony. Wersja 1.0.0-beta08 zawiera te commity.

Zmiany w interfejsie API

• State<T> to teraz State<out T> (I69049)
• ControlledComposition Zmiana interfejsu API umożliwiająca rekompozycję zmian w pojedynczym przejściu. (Iaafd1, b/184173932)

Wersja 1.0.0-beta07

18 maja 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta07 został zwolniony. Wersja 1.0.0-beta07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano nowe interfejsy API kompilatora kompozytowego, które umożliwiają usuwanie informacji o kodzie źródłowym wygenerowanych przez kompilator podczas kompresji kodu źródłowego. (Ia34e6)

• Wprowadza funkcję ReusableContent, która spróbuje ponownie użyć węzłów w swoim zawartości, zamiast zastępować je po zmianie klucza. Gdy klucz zostanie zmieniony, poprzednie wartości w tabeli slotów dla treści są ignorowane, z wyjątkiem węzłów wygenerowanych i wartości użytych do ich zaktualizowania.

  Wprowadza funkcję ReusableComposeNode, która ponownie użyje zwróconego węzła zamiast go zastąpić, jak ma to miejsce w przypadku funkcji ComposeNode. (I1dd86)

• @ComposeCompilerApi nie jest już @RequiresOptIn (Iab690)

Poprawki błędów

• LazyColumn/Row będzie teraz utrzymywać aktywne (nieusunięte) maksymalnie 2 widoczne wcześniej elementy, nawet jeśli zostały już przewinięte. Dzięki temu komponent może ponownie użyć aktywnych podkompozycji, gdy będziemy musieli utworzyć nowy element, co poprawia wydajność przewijania. (Ie5555)

Wersja 1.0.0-beta06

5 maja 2021 roku

androidx.compose.runtime:runtime-*:1.0.0-beta06 został zwolniony. Wersja 1.0.0-beta06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• @ComposeCompilerApi nie jest już @RequiresOptIn (Iab690)

Wersja 1.0.0-beta05

21 kwietnia 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta05 został zwolniony. Wersja 1.0.0-beta05 zawiera te commity.

Zmiany w interfejsie API

• Usunięto @InternalComposeApi w przypadku odczytu i zapisu zrzutów (Id134d)

Poprawki błędów

• Pliki AndroidManifest z ui-test-manifest i ui-tooling-data są teraz zgodne z Androidem 12 (I6f9de, b/184718994).

Wersja 1.0.0-beta04

7 kwietnia 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta04 został zwolniony. Wersja 1.0.0-beta04 zawiera te commity.

Poprawki błędów

• Przed tą zmianą lokalne funkcje kompozytowe można było pominąć na podstawie ich parametrów. Po tej zmianie żadne lokalne funkcje kompozytowe nie będą pomijane. Ta zmiana została wprowadzona, ponieważ funkcje lokalne często i zwykle przechwytują parametry z funkcji nadrzędnej, a ich pomijanie jest częstym źródłem błędów.

  Podsumowując, rozważ ten przykład:

  @Composable fun Counter(count: Int, onCountChange: (Int) -> Unit) {
    @Composable fun ShowCount() { Text("Count: $count") }
    ShowCount()
    Button(onClick={ onCountChange(count + 1) }) {
      Text("Increment")
    }
  }
  

  Przed tą zmianą funkcja kompozytowa ShowCount zawsze pomijała, nawet po zaktualizowaniu parametru count. Ta informacja jest nieaktualna. (I5648a)

• Rozwiązaliśmy problem, gdy funkcja rememberSaveable() przywracała starą wartość w przypadku użycia z parametrami wejściowymi (I1b110, b/182403380).

Wersja 1.0.0-beta03

24 marca 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta03 został zwolniony. Wersja 1.0.0-beta03 zawiera te komitowane zmiany.

Zmiany w interfejsie API

• Środowisko wykonawcze DefaultMonotonicFrameClock zostało wycofane. Wywołanie funkcji withFrameNanos lub Recomposer.runRecomposeAndApplyChanges bez parametru MonotonicFrameClock spowoduje wyjątek IllegalStateException. (I4eb0d)

Wersja 1.0.0-beta02

10 marca 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta02 został zwolniony. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

• Wprowadzanie ograniczeń dotyczących publicznego używania eksperymentalnych interfejsów API (I6aa29, b/174531520)
• Naprawiono błąd związany z użyciem elementu rememberSaveable { mutableStateOf(0) } w miejscu docelowym w komponencie nawigacji. (I1312b, b/180042685, b/180701630)

Wersja 1.0.0-beta01

24 lutego 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

To pierwsza wersja Compose 1.0.0 w wersji beta.

Zmiany w interfejsie API

• Dodaj eksperymentalny interfejs API Recomposer.runRecomposeConcurrentlyAndApplyChanges do ponownego tworzenia nieprawidłowych kompozycji poza głównym cyklem ramek. (I342d0)
• Wszystkie komponenty z oznacznikiem @ReadOnlyComposable są teraz weryfikowane w czasie kompilacji, aby mieć pewność, że wywołują tylko inne komponenty z oznacznikiem @ReadOnlyComposable (I58961)

• Pole defaultFactory w przypadku compositionLocalOf i staticCompositionLocalOf jest teraz wymagane, a nie opcjonalne.

  Ta zmiana usuwa potencjalny błąd typu w przypadku typów, które nie mogą być puste, gdy nie podano fabryki domyślnej. Wcześniej w przypadku typu, który nie może być pusty, ta metoda zwracała odwołanie null.

  W przypadku typów z opcją null warto podać { null } jako domyślną fabrykę.

  Nie zalecamy używania zmiennych lokalnych z typami, które nie mogą być puste, chyba że można podać sensowne wartości domyślne. Jeśli nie ma żadnej sensownej wartości domyślnej, funkcja lambda defaultFactory powinna wyrzucić wyjątek. Jednak wywołanie wyjątku oznacza, że konsumenci lokalu będą mieli domyślną zależność od tego, że jest on dostarczany, co nie jest wymuszane przez system typów. (Ifbd2a)

• Usunięto przestarzałe symbole z czasu wykonywania kodu w komponencie (I3252c).

• Wycofany interfejs emptyContent() został usunięty. Zamiast tego użyj pola {}. (Idb33f, b/179432510)

• Providers zostało zmienione na CompositionLocalProvider

  • Konstruktor kompozycji nie akceptuje już parametru key i został wycofany.
  • currentCompositeKeyHash została przekształcona z funkcji na najwyższym poziomie na funkcję składaną na najwyższym poziomie.
  • Komponenty CompositionData i CompositionGroup zostały przeniesione do przestrzeni nazw androidx.compose.runtime.tooling.
  • Typ ComposableLambda został zastąpiony interfejsem, a typy nie są już parametrami.
  • Zmienna ComposableLambdaN została zamieniona na interfejs zamiast konkretnej klasy i nie ma już parametrów typu.
  • Funkcja snapshotFlow została przeniesiona do przestrzeni nazw androidx.compose.runtime.
  • metoda scalania w SnapshotMutationPolicy nie jest już eksperymentalna
  • Usunięto funkcję @TestOnly clearRoots najwyższego poziomu. Nie jest już potrzebne.
  • Funkcje keySourceInfoOf i resetSourceInfo zostały usunięte. Nie są już potrzebne.
  • Funkcja Composer.collectKeySourceInformation została usunięta. Nie jest już potrzebne.
  • Metody isJoinedKey, joinedKeyLeft i joinedKeyRight zostały usunięte. Nie są już potrzebne.
  • Różne interfejsy API najwyższego poziomu zostały przeniesione i zreorganizowane w różnych plikach. Ze względu na semantykę klasy plików w Kotlinie spowoduje to utratę zgodności binarnej, ale nie źródłowej, więc nie powinno stanowić problemu dla większości użytkowników.
  • (I99b7d, b/177245490)

• SnapshotStateObserver nie jest już eksperymentalny (Id2e6a)

• Usunięto niektóre wycofane wcześniej interfejsy API (Ice5da, b/178633932)

• Wprowadziliśmy następujące zmiany w Material API:

  • Dodano parametr contentPadding do paska górnego i dolnego, aby umożliwić dostosowanie domyślnego wypełnienia.
  • Zmieniliśmy kolejność parametrów w BackdropScaffold, aby były zgodne z wytycznymi dotyczącymi interfejsu API, zgodnie z którymi wymagane parametry są umieszczane przed opcjonalnymi.
  • Parametr icon w BottomNavigationItem został przeniesiony za parametry selected i onClick.
  • Zmieniono nazwę parametru alwaysShowLabels w BottomNavigationItem na alwaysShowLabel.
  • Parametry bodyContent w kilku komponentach zostały przemianowane na content.
  • Zmieniono kolejność parametrów w plikach ButtonDefaults.buttonColors(). Pamiętaj, że typ parametrów się nie zmienił, więc nie spowoduje to błędu w kodzie. Upewnij się, że używasz parametrów nazwanych lub zaktualizujesz ręcznie kolejność parametrów. W przeciwnym razie kod nie będzie działać tak samo jak wcześniej.
  • Do elementu darkColors() dodano parametr secondaryVariant. Zwykle jest to ten sam kolor co secondary w ciemnym motywie, ale dodanie go zapewnia spójność i umożliwia dalsze dostosowywanie.
  • Usunęliśmy z publicznego interfejsu API funkcje ElevationDefaults i animateElevation(), ponieważ nie były one powszechnie używane ani przydatne.
  • Zmieniono nazwę kolumny onValueChangeEnd w tabeli Slider na onValueChangeFinished i nadano jej atrybuty null.
  • Zmieniono nazwę parametru text w sekcji Snackbar na content, aby zachować spójność.
  • Do parametru DropdownMenuItem dodano parametr contentPadding, aby umożliwić dostosowywanie domyślnego wypełnienia, oraz ustawiono parametr content jako rozszerzenie parametru RowScope.
  • Nazwa ModalDrawerLayout została zmieniona na ModalDrawer.
  • Nazwa BottomDrawerLayout została zmieniona na BottomDrawer.
  • (I1cc66)

Wersja 1.0.0-alpha12

10 lutego 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alpha12 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Z interfejsu UiApplier usunięto obsługę grup widoków. Usunięto przestarzałe komponenty emitView. (Ifb214)
• Zmiana nazwy CompositionReference na CompositionContext (I53fcb)
• ComponentActivity.setContent zostało przeniesione do androidx.activity.compose.setContent w module androidx.activity:activity-compose. (Icf416)
• Interfejs Snapshot API został zaktualizowany, aby był bardziej zgodny z wytycznymi dotyczącymi interfejsu API, a także ukrywać wewnętrzne klasy implementacji z publicznego interfejsu API. (Id9e32)
• Zmieniliśmy nazwę sekcji Ambients, aby pasowała do nazwy Ambient -> CompositionLocal. Elementy tła miały kiedyś nazwę „AmbientFoo”, a teraz mają nazwę „LocalFoo”. (I2d55d)
• Zmieniono nazwę parametru Ambient na CompositionLocal, a parametrów ambientOf i staticAmbientOf odpowiednio na compositionLocalOf i staticCompositionLocalOf. Ta zmiana pomaga lepiej zrozumieć cel funkcji CompositionLocal: mechanizmu udostępniania i pobierania wartości lokalnych dla kompozycji. Instanse CompositionLocal powinny mieć prefiks Local, np. val LocalFoo = compositionLocalOf { Foo() }. (Ia55b6)
• Metody takeMutableSnapshot i takeSnapshot zostały przeniesione do metod towarzyszących zrzutu. (I91f19)

• @ComposableContract został wycofany na rzecz 3 bardziej szczegółowych adnotacji.

  @ComposableContract(restartable = false) stało się @NonRestartableComposable @ComposableContract(readonly = true) stało się @ReadOnlyComposable @ComposableContract(preventCapture = true) stało się @DisallowComposableCalls @ComposableContract(tracked = true) zostało usunięte. (I60a9d)

• Narzędzia emptyContent() i (@Composable () -> Unit).orEmpty() zostały wycofane, ponieważ nie mają już żadnego pozytywnego wpływu na wydajność ani wartość (I0484d)

• snapshotFlow i withMutableSnapshot nie są już eksperymentalne (I6a45f).

• Rekompilatory można teraz zamknąć. Zamknięte rekompilatory będą kontynuować rekompilację, dopóki nie zakończą się wszystkie podprocesy rekompilacji. Funkcja Recomposer.shutDown została przemianowana na cancel, aby odróżnić ją od funkcji close. (Ib6d76)

• Element compose:runtime-dispatch został wycofany. MonotonicFrameClock znajdziesz teraz w komponencie compose:runtime, a AndroidUiDispatcher – w komponencie compose:ui. (Ib5c36)

• Interfejs API, do którego kieruje się działanie wtyczki kompilatora Compose, został przebudowany, aby używać interfejsu zamiast konkretnej klasy. Interfejs nie używa już też parametru typu.

  Jest to zmiana wewnętrzna, która nie powinna mieć wpływu na zgodność kodu źródłowego, ale powoduje zmianę binarną. (I3b922, b/169406779)

• Wprowadzono klasę SnapshotMutableState (Icfd03)

• DisposableEffectDisposable został przemianowany na DisposaleEffectResult (Ica7c6).

• Usunięto funkcję Recomposer.current(). [Abstract]ComposeView jest teraz domyślnie ustawiona na leniwie tworzone obiekty Recomposer ograniczone do okna, które są zarządzane przez obiekt ViewTreeLifecycleOwner dla okna. Rekompozycja i ticki animacji oparte na metodzie FrameNano są wstrzymywane, gdy cykl życia hosta jest zatrzymany. (I38e11)

• Recomposer.runningRecomposers udostępnia teraz globalny stan StateFlow tylko do odczytu RecomposerInfo, który umożliwia obserwowanie bieżącego stanu kompilacji w trakcie procesu. Używaj tego interfejsu API zamiast Recomposer.current(), który został wycofany. (If8ebe)

• DisposableEffectDisposable został przemianowany na DisposaleEffectResult (I3ea68).

Wersja 1.0.0-alpha11

28 stycznia 2021 roku

androidx.compose.runtime:runtime-*:1.0.0-alpha11 został zwolniony. Wersja 1.0.0-alpha11 zawiera te commity.

Zmiany w interfejsie API

• Interfejsy onCommit, onDispose i onActive zostały wycofane na rzecz interfejsów SideEffect i DisposableEffect (If760e).
• Interfejs emit() i wszystkie jego przeciążenia zostały wycofane i przemianowane na ComposeNode. Interfejsy API są identyczne, ale mają inną nazwę, aby zachować konwencję nazewnictwa w Compose (I4137b).
• Funkcje invalidate i compositionReference() zostały wycofane na rzecz odpowiednio funkcji currentRecomposeScope i rememberCompositionReference. (I583a8)

• Observer pamięci zastępuje CompositionLifecycleObserver, a CompositionLifecycleObserver jest teraz wycofany.

  RememberObserver zastępuje CompositionLifecycleObserver z modyfikowaną semantyką i przemianowanymi metodami. Przejście na nowy interfejs API można przeprowadzić automatycznie w przypadku obiektów, które są zapamiętywane tylko raz. Jest to zalecana praktyka. Jeśli jednak odwołanie zostało zapamiętane więcej niż raz w kompozycji, funkcja onRemembered jest wywoływana w przypadku każdego odwołania, podczas gdy funkcja onEnter jest wywoływana tylko raz. onEnter został wywołany wielokrotnie, jeśli obiekt był używany w podkompozycjach, takich jak WithConstraints i Scaffold, co sprawia, że gwarancja pojedynczego wywołania onEnter jest niewiarygodna i została usunięta z RememberObserver.

  RememberObserver dodaje onAbandoned, które jest wywoływane, jeśli instancja RememberObserver zostanie zwrócona z połączenia zwrotnego przekazanego do remember, ale nie została zapamiętana w stanie kompozycji. W związku z tym nigdy nie zostanie wywołane onRemembered. Może się tak zdarzyć, jeśli wyjątek spowoduje przerwanie tworzenia kompozycji przed jego zakończeniem lub jeśli kompozycja zostanie odrzucona, ponieważ stan, dla którego była tworzona, nie jest już aktualny lub nie jest już potrzebny. Jeśli instancja RememberObserver po rekomendacji z jednym odwołaniem powyżej śledzi zewnętrzny zasób, zarówno onForgotten, jak i onAbandoned wskazują, że zasób nie jest już potrzebny. Jeśli obiekt śledzi pracę rozpoczętą lub zasoby przydzielone w funkcji onRemembered, można zignorować funkcję onAbandoned, ponieważ nie zostanie ona wywołana, gdy wywołana zostanie funkcja onRemembered. (I02c36)

• Nie oznaczaj funkcji collectAsState() jako wbudowanych (Ia73e4)

Poprawki błędów

• Element WithConstraints został przerobiony na BoxWithConstraints i przeniesiony do pakietu foundation.layout. (I9420b, b/173387208)
• Korzystanie z TestCoroutineDispatcher w testach (I532b6)

Wersja 1.0.0-alpha10

13 stycznia 2021 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha10 został zwolniony. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Zmiany powodujące niezgodność

• Restrukturyzacja wewnętrznego interfejsu API kompilatora umożliwia grupowanie zmian węzłów wygenerowanych w ramach etapu „Zastosuj zmiany” kompozycji po zakończeniu działania wszystkich funkcji @Composable.

  Jest to zmiana zachowania, która może wpłynąć na kod aplikacji, ponieważ węzły nie są już dostępne z interfejsów API eksperymentalnych i wewnętrznych do czasu zastosowania zmian. Zwykle można to obejść, otaczając kod z takimi zależnościami w komponencie SideEffect, aby odłożyć wykonanie kodu do momentu utworzenia i inicjalizacji węzłów. (I018da)

Zmiany w interfejsie API

• Dodano sposób śledzenia, czy rekompilator zastosował zmiany. (I1b3e2)

• Rozszerzenie interfejsów API [Abstract]ComposeView, aby umożliwić recykling widoków opartych na Compose, a także usuwanie ich kompozycji, aby można je było ponownie utworzyć w przyszłości. Dodać interfejsy API do instalowania i odnajdywania rekompilujących komponentów ograniczonych do okna oraz odniesienia do kompozycji do tworzenia podrzędnych kompozycji.

  Dodaj ViewCompositionStrategy do konfigurowania strategii usuwania kompozycji [Abstract]ComposeViews; domyślne zachowanie to usunięcie przy odłączaniu okna. (I860ab)

Poprawki błędów

• Recomposer udostępnia teraz przepływ danych w bieżącym stanie, co umożliwia monitorowanie jego aktywności i aktywności powiązanych efektów. (Ifb2b9)
• Do natywnego zdarzenia keyEvent można teraz uzyskać dostęp przez keyEvent.nativeKeyEvent (I87c57, b/173086397)

Wersja 1.0.0-alpha09

16 grudnia 2020 roku

androidx.compose.runtime:runtime-*:1.0.0-alpha09 został zwolniony. Wersja 1.0.0-alpha09 zawiera te commity.

Zmiany w interfejsie API

• Usunięto klasy SlotTable, SlotReader i SlotWriter z publicznego interfejsu API. Wcześniej były one oznaczone jako InternalComposeAPI. Teraz są one wewnętrzne w module tworzenia.

  Dodaliśmy interfejsy CompositionData i CompositionGroup jako zamiennik interfejsu ui-tooling API do wyodrębniania informacji o kompozycji. Są one publiczne, ale nie są przeznaczone do użytku poza interfejsem ui-tooling API, ponieważ zawierają informacje w postaci nieprzetworzonej, które interfejs ui-tooling API interpretuje (I31a9c).

• Klasa Applier nie jest już uważana za (Id85b0)

• Interfejs Applier został zmieniony, aby ułatwić tworzenie drzew od dołu do góry zamiast odwrotnie.

  Nazwa metody insert() została zmieniona na insertTopDown().

  Dodano nową metodę insertBottomUp().

  Aplikator wstawia węzły do drzewa, które modyfikuje, za pomocą funkcji insertTopDown() lub insertBottomUp(), w zależności od tego, która z nich działa lepiej.

  Niektóre drzewa, takie jak LayoutNode i View, są znacznie wydajniejsze w budowaniu od dołu do góry niż odwrotnie. Przed wprowadzeniem tej zmiany do wdrażania metody od dołu wymagany był stos wstawek, który trzeba było kopiować do każdego miejsca, w którym była potrzebna konstrukcja od dołu ze względu na wydajność. Ta zmiana zastępuje Applier przez insertBottomUp(), aby tworzyć drzewo od dołu do góry, oraz insertTopDown(), aby tworzyć drzewo od góry do dołu. (Icbdc2)

• Compose obsługuje metody pobierające właściwości, które mogą wywoływać kompozytowe wywołania. Nie zamierzamy rezygnować z tej funkcji, ale zmienia się składnia deklarowania funkcji pobierającej właściwości jako @Composable.

  Składnia, która została wycofana, polegała na dodawaniu adnotacji do usługi:

      @Composable val someProperty: Int get() = ...
  

  Prawidłowa składnia to dodanie adnotacji do metody gettera właściwości:

     val someProperty: Int @Composable get() = ...
  

  Obie składnie będą działać przez jakiś czas, ale wcześniejsza wycofana składnia w końcu spowoduje błąd kompilacji. (Id9197)

Poprawki błędów

• AndroidOwner made internal (Ibcad0, b/170296980)
• Funkcja subcomposeInto(LayoutNode) została oznaczona jako wewnętrzna (Id724a)

Wersja 1.0.0-alpha08

2 grudnia 2020 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha08 został zwolniony. Wersja 1.0.0-alpha08 zawiera te commity.

Zmiany w interfejsie API

• Dodano sprawdzanie lint pod kątem nazw i pozycji parametrów funkcji kompozytowych lambda, aby sprawdzić zgodność z wytycznymi Compose. Zgodnie z instrukcjami i sprawdzaniem błędów niektóre interfejsy API, które używają nazwy children jako nazwy funkcji lambda na końcu, zostały przeniesione do content. (Iec48e)
• Recomposer nie akceptuje już EmbeddingContext; wymagane zależności harmonogramu są pobierane z effectCoroutineContext. Interfejs FrameManager został wycofany. Integracje z platformami powinny inicjować własne globalne przetwarzanie zrzutów. (I02369)
• Funkcja RestorableStateHolder.withRestorableState została przemianowana na RestorableStateProvider (I66640)

Poprawki błędów

• wycofane ambienty o nazwach zawierających sufiks Ambient i zastąpione nowymi właściwościami z prefiksem Ambient zgodnie z innymi wytycznymi dotyczącymi ambientów i interfejsu Compose API; (I33440)
• Usuwanie starego modułu testu UI i jego zastępników (I3a7cb)

Wersja 1.0.0-alpha07

11 listopada 2020 roku

androidx.compose.runtime:runtime-*:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alpha07 zawiera te commity.

Nowe funkcje

Zmiany w interfejsie API

• Adnotacja @UnionType została wycofana (I57cde)
• Opcja provideDefault została dodana jako alternatywa dla provide na potrzeby dostarczania wartości ambient. Można jej używać do określania wartości ambient, które będą ustawiane tylko wtedy, gdy nie ma jeszcze wartości ambient. (Id6635, b/171024925)
• Zadanie uruchamiane zostało przemianowane na efekt uruchamiania w celu zachowania spójności z interfejsami SideEffect i DisposableEffect. Aby zachęcić do stosowania sprawdzonych metod, nie zezwalamy na używanie LaunchedEffect bez parametrów podmiotu. (Ifd3d4)
• Moduł Applier ma teraz funkcje zwrotne onBeginChanges/onEndChanges, które są wywoływane, gdy kompozytor rozpoczyna lub kończy stosowanie zmian w drzewie. W razie potrzeby można ich używać do zbiorczego zarządzania zasobami. (Icf476)
• Recomposer wymaga teraz kontekstu coroutine w czasie tworzenia (Ic4610)
• Zmiany w wewnętrznej implementacji SlotTable, które nie powinny mieć wpływu na publiczny interfejs API. (If9828)
• Usunięto przestarzałe adaptery rxjava2, które nie przyjmują wartości początkowej (Idb72f).

Poprawki błędów

• Komponent foundation.Text został wycofany i zastąpiony komponentem material.Text. Podstawowy interfejs API tekstu, który nie używa wartości z motywu, znajdziesz w bibliotece androidx.compose.foundation.BasicText. (If64cb)
• Komponent BaseTextField został wycofany. Zamiast tego użyj pola tekstowego podstawowego. (I896eb)
• Kilka symboli związanych z rozkładem zostało przeniesionych z androidx.compose.ui do androidx.compose.layout.ui. (I0fa98, b/170475424)

Darowizna zewnętrzna

• Dodano moduł runtime-rxjava3 do tworzenia wiadomości. Podobne do runtime-rxjava2 (I02cbf)

Wersja 1.0.0-alpha06

28 października 2020 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha06 został zwolniony. Wersja 1.0.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

• Recomposer jest teraz elementem CompositionReference i prawidłowym elementem nadrzędnym kompozycji. Wyraźny Recomposer jest teraz wymagany w mniejszej liczbie miejsc. (I4036f)
• Dodano do SideEffect interfejs API odpowiednika DisposableEffect, który pełni rolę interfejsu onCommit-with-params, ale wymaga interfejsu onDispose.
  • Dodano interfejs API rememberUpdatedState, aby publikować dane z rekompozycji w ciągłych lub długotrwałych procesach, takich jak DisposableEffects lub LaunchedTasks.
  • (Id50b9)
• MutableVector implementuje teraz interfejs RandomAccess (I85d73, b/170461551).
• Dodano kompozytywny efekt uboczny, który umożliwia stosowanie efektów ubocznych kompozycji do obiektów zarządzanych przez kompozycję. SideEffect ma zastąpić kompozyt naCommit. (Ia77c2)
• Nowy eksperymentalny interfejs API RestorableStateHolder. Umożliwia zapisanie stanu zdefiniowanego za pomocą [savedInstanceState] i [rememberSavedInstanceState] dla poddrzewa przed jego usunięciem, aby umożliwić jego ponowne złożenie przy następnym uruchomieniu z przywróconym stanem. (I66884, b/166586419)

Poprawki błędów

• Włącz przejścia w komponencie ComposeTestRule. Usuń z niego opcję włączania migającego kursora. (If0de3)

Wersja 1.0.0-alpha05

14 października 2020 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha05 został zwolniony. Wersja 1.0.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

• Eksperymentalny modyfikator Modifier.pointerInput zawieszający modyfikator wejścia (Ia77d2)
• Wydajność przewijania kolumny/wiersza typu Lazy jest ulepszona dzięki mniejszemu obciążeniu podkompozycji przy każdym przewijaniu. Do klasy Composition dodano nową metodę hasInvalidations(). Metoda hasPendingChanges() z kompozycji została przemianowana na hasInvalidations() (Ib2f32, b/168293643, b/167972292, b/165028371).
• Dodaj interfejs API produceState do uruchamiania coroutines z kompozycji, które aktualizują pojedynczą wartość State<T> w czasie (Id4a57)
• Zmiana nazwy metody launchInComposition na LaunchedTask, aby była zgodna z wytycznymi dotyczącymi interfejsu API Compose (I99a8e)
• Kolejność wywołań place() w niestandardowych układach określa teraz kolejność rysowania elementów podrzędnych (Ibc9f6)

Wersja 1.0.0-alpha04

1 października 2020 roku

androidx.compose.runtime:runtime-*:1.0.0-alpha04 został zwolniony. Wersja 1.0.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

• Dodano OwnerScope, aby umożliwić zbieranie zakresów obserwacji układu i rysowania, gdy nie są już ważne. (Ic4cf8)
• Dodano interfejs derivedStateOf API do tworzenia obiektów State na podstawie obliczeń, które mogą odczytywać (i wyprowadzać) inne obiekty State (If758b).
• Dodano interfejs TestOnly API dla SnapshotStateObserver (I6e2a9).

Poprawki błędów

• Element foundation.Box został wycofany. Zamiast tego użyj elementu foundation.layout.Box. (Ie5950, b/167680279)

Wersja 1.0.0-alpha03

16 września 2020 roku

androidx.compose.runtime:runtime-*:1.0.0-alpha03 został zwolniony. Wersja 1.0.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• CompositionCoroutineScope nie implementuje już funkcji MonotonicFrameClock. Osoby wywołujące funkcję withFrameNanos powinny jawnie zaimportować funkcję najwyższego poziomu. (Icb642, b/166778123)

Poprawki błędów

• Funkcje globalnego testowania, takie jak onNode lub waitForIdle, są teraz wycofane. Zamiast nich używaj nowych odpowiedników zdefiniowanych w ComposeTestRule (I7f45a).
• launchInComposition nie uruchamia już współprogramów bez wysłania (Ief6af, b/166486000)

Wersja 1.0.0-alpha02

2 września 2020 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha02 został zwolniony. Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaj interfejsy API snapshotFlow i withMutableSnapshot, aby korzystać z zmian danych migawek i je wprowadzać. (I3e722)

• Zmieniono konwencję wywoływania funkcji składanych. To zmiana powodująca niezgodność binarną. Wszystkie biblioteki muszą zostać ponownie skompilowane, aby działały z tą wersją wtyczki kompilatora Compose.

  Ta zmiana nie powoduje zmiany w źródle, ponieważ jedynymi zmienionymi interfejsami API są interfejsy kompilatora, które wymagają wyraźnego włączenia. (I7afd2, b/158123185)

• Usunięto metody planowania z EmbeddingContext (I7b9be)

• Metoda onPreCommit została wycofana. Metoda onCommit ma teraz zachowanie takie jak onPreCommit.

  Teraz funkcje onCommit i onActive są wykonywane w tym samym interwale, w którym są wprowadzane zmiany w kompozycji, a nie na początku następnego interwału. (I70403)

Wersja 1.0.0-alpha01

26 sierpnia 2020 r.

androidx.compose.runtime:runtime-*:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te commity.

Wersja 0.1.0-dev

Wersja 0.1.0-dev17

19 sierpnia 2020 r.

androidx.compose.runtime:runtime-*:0.1.0-dev17 został zwolniony. Wersja 0.1.0-dev17 zawiera te commity.

Zmiany w interfejsie API

• Emitowanie niestandardowe może teraz deklarować, że co najmniej 1 z jego ustawień może być pomijane i zmieniane niezależnie od emitowania. (Ibbd13)

• Usunięto wycofane wywołania FrameManager.

  Zmieniono wewnętrzne interfejsy API kompozytora, aby zmniejszyć nakład pracy związany z monitorowaniem obiektów stanu, takich jak mutableStateof() (I80ba6).

• Właściwość state { ... } została wycofana na rzecz wywołań funkcji remember { mutableStateOf(...) }, aby zwiększyć przejrzystość. Dzięki temu zmniejsza się ogólna powierzchnia interfejsu API i liczba pojęć związanych z zarządzaniem stanem oraz dopasowuje się do wzoru by mutableStateOf() dotyczącego delegowania właściwości klasy. (Ia5727)

• Funkcja Flow.collectAsState określa teraz domyślny moduł rozsyłający na podstawie samej kompozycji, a nie domyślnie Dispatchers.Main. (I9c1d9)

• Naprawiono błąd powodujący awarię, gdy w pętli for używano czegoś, co zapisuje stan. Teraz można używać tego samego klucza w savedInstanceState(), a interfejs API rejestru UiSavedStateRegistry został dostosowany do tego nowego wymagania (I4ab76, b/160042650, b/156853976, b/159026663, b/154920561)

Poprawki błędów

• Środowisko wykonawcze emitView zostało wycofane. Jeśli to możliwe, do emitowania widoków w komponencie Compose użyj elementu AndroidView. Pamiętaj, że w przyszłości nie będzie można bezpośrednio tworzyć widoków i grup widoków, chyba że są one elementami liściastymi w drzewie kompozycji, co można osiągnąć za pomocą AndroidView. (I29b1e, b/163871221)

Wersja 0.1.0-dev16

5 sierpnia 2020 r.

androidx.compose.runtime:runtime-*:0.1.0-dev16 został zwolniony. Wersja 0.1.0-dev16 zawiera te commity.

Zmiany w interfejsie API

• Domyślna zasada mutacji w przypadku mutableStateOf(), ambientOf() i savedInstanceStateOf() została zmieniona z referentialEqualityPolicy() na structuralEqualityPolicy().

  Domyślne ustawienie określające, czy nowa wartość przypisana do instancji mutableStateOf() jest uważana za zmianę, jest teraz domyślnie ustawione na == zamiast na ===.

  https://kotlinlang.org/docs/reference/equality.html

  ambientOf() i savedInstanceStateOf() używają mutableStateOf() w swoich implementacjach, więc zostały one zmienione, aby były zgodne z mutableStateOf().

  Używanie równości strukturalnej lepiej odpowiada oczekiwaniom programistów.

  Na przykład

  val state = mutableStateOf(1f)
  

  a następnie

  state.value = 1f
  

  nie będzie już uważana za zmianę w komponencie state, a użycie tego komponentu podczas tworzenia kompozycji nie będzie już wymagać ponownego jej skomponowania.state

  Jest to zmiana powodująca przerwanie działania aplikacji, ale w większości przypadków (np. gdy używasz klas, które nie zastępują equals()) nie będzie ona miała zauważalnego wpływu na aplikację.

  Zajęcia, które zastępują equals(), takie jak zajęcia data, mogą mieć gorszą wydajność, ponieważ ich metody equals() są teraz domyślnie wywoływane po przypisaniu do mutableStateOf().

  Aby przywrócić poprzednie działanie, dodaj parametr zasad policy = referentialEqualityPolicy() do wywołań funkcji mutableStateOf(), ambientOf() i savedInstanceStateOf(). (Ic21a7)

• Funkcje Row i Column są teraz funkcjami w wierszu, co znacznie zmniejsza obciążenie związane z ich używaniem. (I75c10)

Poprawki błędów

• Metoda setViewContent została wycofana. Zamiast niej należy używać metody setContent. (I7e497, b/160335130)

• Dodano zegar MonotonicFrameAnimationClock, który umożliwia użycie obiektu MonotonicFrameClock jako obiektu AnimationClockObservable, aby wypełnić lukę między nowymi zegarami opartymi na coroutines a interfejsami API, które nadal używają starych zegarów opartych na wywołaniu zwrotnym.

  odpowiednikiem klasy ManualAnimationClock jest teraz klasa ManualFrameClock. (I111c7, b/161247083)

• Modifier.stateDraggable został całkowicie przerobiony i przemianowany na Modifier.swipeable. Wprowadziliśmy nową klasę SwipeableState, a DrawerState i BottomDrawerState zostały przebudowane, aby mogły z niej dziedziczyć. [Modal/Bottom]DrawerLayout nie przyjmuje już parametru onStateChange. (I72332, b/148023068)

• Interfejs Modifier.plus został wycofany. Zamiast niego używaj interfejsu Modifier.then. „Then” ma silniejszy sygnał dotyczący kolejności, ale jednocześnie uniemożliwia wpisanie Modifier.padding().background() + anotherModifier, co powoduje przerwanie łańcucha i utrudnia czytanie (Iedd58, b/161529964)

• Dodano element SubcomposeLayout. Jest to prymityw niskiego poziomu, który umożliwia tworzenie podrzędnych podczas pomiaru, jeśli chcemy użyć niektórych wartości dostępnych dopiero później podczas pomiaru podrzędnego. Na przykład ograniczenie WithConstraints nie jest implementowane za pomocą funkcji SubcomposeLayout. (I25cc8)

• Nazwa Material FilledTextField została zmieniona na TextField, a podstawowa nazwa TextField została zmieniona na BaseTextField, aby ułatwić znajdowanie i używanie najprostszego interfejsu API (Ia6242, b/155482676).

• Modifier.drawBackground został przemianowany na Modifier.background (I13677)

Wersja 0.1.0-dev15

22 lipca 2020 r.

androidx.compose.runtime:runtime-*:0.1.0-dev15 został zwolniony. Wersja 0.1.0-dev15 zawiera te commity.

Aktualizacja zależności

• Aby używać wersji 0.1.0-dev15 biblioteki Compose, musisz zaktualizować zależności zgodnie z nowymi fragmentami kodu pokazanymi powyżej w sekcji Deklarowanie zależności.

Zmiany w interfejsie API

• Adnotacja @Model została wycofana. Jako alternatywy użyj funkcji state i mutableStateOf. Ta decyzja o wycofaniu została podjęta po długiej i dogłębnej dyskusji.

  Uzasadnienie

  Uzasadnienie może obejmować m.in.:

  • Zmniejszenie obszaru interfejsu API i pojęć, które musimy przekazać
  • większe podobieństwo do innych porównywalnych pakietów narzędzi (Swift UI, React, Flutter);
  • Odwracalna decyzja. Możemy je przywrócić później.@Model
  • Usunięcie rzadko używanych funkcji i trudnych do rozwiązania problemów związanych z konfigurowaniem @Model
  • @Model klasy danych, operator równości, kod szyfrowania itp.
  • How do I have some properties “observed” and others not?
  • Jak określić, czy w obserwacji ma być używana równość strukturalna czy referencyjna?
  • Zmniejsza „magię” w systemie. Zmniejszenie prawdopodobieństwa, że ktoś uzna, że system jest mądrzejszy niż jest w rzeczywistości (np. że wie, jak porównać dwie listy).
  • Ułatwia intuicyjne określenie szczegółowości obserwacji.
  • Ulepszenie możliwości refaktoryzacji z użycia zmiennej do właściwości klasy
  • Może umożliwić ręczne optymalizowanie stanu
  • Lepiej pasuje do reszty ekosystemu i zmniejsza niejednoznaczność w przypadku niezmiennych stanów lub „przyjmowania zmiennych stanów”.

  Informacje o migracji

  Prawie wszystkie istniejące użycia @Model są dość łatwo przekształcane na jeden z 2 sposobów. Przykład poniżej zawiera klasę @Model z 2 właściwościami tylko na potrzeby przykładu i używaną w komponowalnym komponencie.

  @Model class Position(
   var x: Int,
   var y: Int
  )
  
  @Composable fun Example() {
   var p = remember { Position(0, 0) }
   PositionChanger(
     position=p,
     onXChange={ p.x = it }
     onYChange={ p.y = it }
   )
  }
  

  Opcja 1. Użyj State<OriginalClass> i utwórz kopie.

  Takie podejście ułatwiają klasy danych w Kotlinie. W zasadzie należy przekształcić wszystkie właściwości var w usługi val klasy danych, a potem użyć właściwości state zamiast remember i przypisać wartość stanu do sklonowanych kopii oryginału za pomocą metody ułatwień klasy danych copy(...).

  Pamiętaj, że to podejście działa tylko wtedy, gdy jedyne mutacje tej klasy zostały wprowadzone w tym samym zakresie, w jakim utworzono instancję State. Jeśli klasa wewnętrznie mutuje się poza zakresem użycia i polegasz na obserwacji tego procesu, zastosuj następne podejście.

  data class Position(
   val x: Int,
   val y: Int
  )
  
  @Composable fun Example() {
   var p by state { Position(0, 0) }
   PositionChanger(
     position=p,
     onXChange={ p = p.copy(x=it) }
     onYChange={ p = p.copy(y=it) }
   )
  }
  

  Alternatywa 2. Użyj funkcji mutableStateOf i delegatów właściwości

  Takie podejście jest ułatwione dzięki delegatom właściwości w Kotlinie i interfejsowi API mutableStateOf, który umożliwia tworzenie wystąpień MutableState poza kompozycją. Zasadniczo należy zastąpić wszystkie właściwości var oryginalnej klasy właściwościami var z usługą mutableStateOf jako ich delegatem. Zaletą tego jest to, że sposób korzystania z klasy się nie zmieni, zmieni się tylko jej implementacja wewnętrzna. Zachowanie nie jest jednak całkowicie identyczne z pierwotnym przykładem, ponieważ każda usługa jest teraz obserwowana lub subskrybowana osobno, więc rekompozycje, które zobaczysz po tej zmianie, mogą być węższe (co jest dobrą rzeczą).

  class Position(x: Int, y: Int) {
   var x by mutableStateOf(x)
   var y by mutableStateOf(y)
  }
  
  // source of Example is identical to original
  @Composable fun Example() {
   var p = remember { Position(0, 0) }
   PositionChanger(
     position=p,
     onXChange={ p.x = it }
     onYChange={ p.y = it }
   )
  }
  

  (I409e8, b/152050010, b/146362815, b/146342522, b/143413369, b/135715219, b/143263925, b/139653744)

• Zmienia strategię generowania kodu kompilatora Compose. Przed wprowadzeniem tej zmiany kompilator kompozytowy przekształcał wywołania w funkcje kompozytowe. Dzięki tej zmianie modyfikujemy teraz ciało funkcji składanej, a miejsce wywołania pozostawiamy bez zmian (w większości).

  Oznacza to, że większość logiki komunikującej się z runtimem usługi Compose jest wykonywana na początku ciała funkcji, a nie w miejscu wywołania.

  Powinna to być zmiana zgodna ze źródłem we wszystkich przypadkach użycia funkcji Compose. Większość użytkowników usługi Compose nie powinna być zmuszona do aktualizowania kodu.

  Aby umożliwić to, zmieniliśmy sygnaturę JVM wszystkich funkcji kompozytowych. Funkcja składana, która akceptuje jeden parametr, jest przekształcana w funkcję akceptującą 3 parametry. Dodatkowe parametry to kompozytor, liczba całkowita „klucza” i liczba całkowita bitowa używana do propagowania metadanych w wywołaniach.

  Funkcja Compose przekształca teraz również argumenty domyślne w funkcję składającą się. Robi to bez wprowadzania dodatkowego domyślnego przeciążenia funkcji, więc ta zmiana spowoduje zdefiniowanie mniejszej liczby funkcji.

  Znane celowe zmiany w zachowaniu wynikające z tego:

  1. Niektóre połączenia będą pomijane, co nie miało miejsca wcześniej.
  2. Wyrażenia kompozytowe w domyślnych wyrażeniach argumentów są teraz prawidłowo subskrybowane i obsługiwane

  W ramach tych prac wprowadziliśmy kilka optymalizacji: 1. Wyniki porównań parametrów są propagowane przez wykres wywołania do innych funkcji kompozytowych. Spowoduje to mniejszą liczbę porównań w czasie wykonywania, zmniejszy rozmiar tabeli slotów, a także zwiększy pomijanie funkcji kompozytowych, które wcześniej nie były pomijane. Parametry, które w czasie kompilacji zostały uznane za „statyczne”, nie są już porównywane ani przechowywane w czasie wykonywania. Zmniejsza to liczbę porównań i rozmiar tabeli slotów. 3. Struktura przepływu danych w ciele funkcji służy do minimalizowania liczby generowanych grup. Zmniejsza to rozmiar tabeli slotów i obciążenie środowiska wykonawczego. 4. Nieużywane parametry funkcji dispatch i receiver nie są uwzględniane przy określaniu możliwości pominięcia funkcji, jeśli nie są używane w jej treści.

  Większość zmian dotyczyła interfejsów API, na które kompilator kieruje bezpośrednio. Nie wpłynęło to na typowe korzystanie z Compose: 1. Funkcja Composer::startExpr została usunięta. Funkcja Composer::endExpr została usunięta. Funkcja Composer::call została wycofana. Przeciążenia funkcji key, które nie są przeciążeniami varargs, zostały usunięte. Od teraz używaj wersji vararg. 5. Adnotacja Pivotal została wycofana. Użyj key jako zamiennika. 6. Zmieniono funkcję ScopeUpdateScope::updateScope, aby oczekiwała ona funkcji Function3 zamiast funkcji Function1. 7. Zaktualizowano funkcje restartableFunction i restartableFunctionN, aby uwzględniały dodatkowe parametry kompilacji (I60756, b/143464846).

• Dodano sortWith i removeRange do MutableVector (Icccf7)

• Dodano domyślne implementacje metody CompositionLifecycleObserver (I24289)

• Applier wymaga teraz metody clear() do usuwania kompozyt (Ibe697)

• Dodaliśmy do klasy MutableVector metodę asMutableList(), aby można było przekazywać ją do publicznego interfejsu API bez konieczności kopiowania całej listy. (I298df)

• Dodano funkcję rememberCoroutineScope(), aby uzyskać zarządzany obiekt CoroutineScope w kompozycji do uruchamiania zadań w odpowiedzi na zdarzenia. (I0e264)

• MutableVector to nowa kolekcja, która nie implementuje żadnego standardowego interfejsu Collection. Ta kolekcja zapewnia szybkość ponad inne wymagania i jest przeznaczona do użytku wewnętrznego. (I8ebd6)

• Tymczasowo usunięto StableMutableList i StableMutableMap, aby uniknąć problemu w wersji Kotlin Compose. Te interfejsy zostaną ponownie wprowadzone, gdy kompozytor zostanie zaktualizowany do wersji Kotlina, która nie ma tego problemu.

  SnapshotStateList i SnapshotStateMap są teraz publiczne, ale zostaną wycofane, gdy przywrócimy StableMutableList i StableMutableMap. (Ia7769)

• dodać funkcję najwyższego poziomu withFrameNanos do określania czasu animacji (Ie34c5)

• Adnotacja @Untracked została wycofana. Zastąp to elementem @ComposableContract(tracked=false) (Id211e).

• RestartableFunction i powiązane z nim interfejsy API zostały przemianowane na ComposableLambda itp. Te interfejsy API były kierowane tylko przez kompilator, więc nie powinny wpływać na zgodność na poziomie kodu źródłowego. Zmiana nazwy została wprowadzona głównie po to, aby lepiej informować o tym, czym jest ta klasa, gdy pojawia się w śladach stosu (I7eb25).

• adnotacja @Composable nie jest już ważna w przypadku klas (Ia5f02)

• Ambient<T> ma teraz atrybuty @Stable zamiast @Immutable (I0b4bb)

• Przed tą zmianą wtyczka kompilatora kompozytora przechwytywała wywołania konstruktorów w ramach funkcji @Composable, jeśli wystąpiły one w ramach funkcji (I5205a, b/158123804).

• Komponent Recompose nie jest już przydatną abstrakcją. Większość ponownych skompilowań powinna nastąpić w wyniku przypisania stanu zmiennego. W przypadku innych wartości zalecamy użycie funkcji invalidate, aby wywołać ponowne zdefiniowanie bieżącego zakresu. (Ifc992)

• Obserwowanie nie jest już przydatną abstrakcją. Jeśli chcesz go powielić, możesz to zrobić, tworząc funkcję składającą się z parametrów, która wykonuje składany parametr lambda. Na przykład @Composable fun Observe(body: @Composable () -> Unit) = body() (I40d37).

• @Direct zostało wycofane na rzecz @ComposableContract(restartable=false) (If4708)

• Dodano adapter dla niedawno wprowadzonego StateFlow, który umożliwia wstępne wypełnienie wartości początkowej, aby zwracany stan nie był pusty (I61dd8, b/156233789).

• Dodano adapter dla Flow. Przykład użycia: val value przez flow.collectAsState() (If2198, b/153375923)

• [Zmienne]Operatory delegujące właściwości stanu zostały przeniesione do rozszerzeń, aby umożliwić optymalizacje delegowania właściwości w wersji Kotlin 1.4. Aby nadal korzystać z by state { ... } lub by mutableStateOf(...), dzwoniący muszą dodać importy. (I5312c)

• Interfejs androidx.compose.ViewComposer został przeniesiony do androidx.ui.node.UiComposer. Interfejs androidx.compose.Emittable został usunięty. Był on zbędny w porównaniu z ComponentNode. androidx.compose.ViewAdapters został usunięty. Nie są one już obsługiwane. Metoda Compose.composeInto została wycofana. Użyj w zamian pola setContent lub setViewContent. Metoda Compose.disposeComposition została wycofana. Zamiast tego użyj metody dispose w obiekcie Composition zwracanym przez funkcję setContent. Funkcja androidx.compose.Compose.subcomposeInto została przeniesiona do androidx.ui.core.subcomposeInto. Metoda ComponentNode#emitInsertAt została przemianowana na ComponentNode#insertAt. Metoda ComponentNode#emitRemoveAt została przemianowana na ComponentNode#removeAt. Metoda ComponentNode#emitMode została przemianowana na ComponentNode#move (Idef00)

• Zaktualizowaliśmy flagę ComposeFlags.COMPOSER_PARAM na true, co zmieni strategię generowania kodu dla wtyczki do tworzenia wiadomości. Ogólnie rzecz biorąc, powoduje to, że funkcje @Composable są generowane z dodatkowym parametrem syntetycznym, który jest przekazywany do kolejnych wywołań @Composable, aby środowisko uruchomieniowe mogło prawidłowo zarządzać wykonywaniem. Jest to istotna zmiana, która powoduje przerwanie binarne, ale powinna zachować zgodność na poziomie źródłowym we wszystkich zatwierdzonych zastosowaniach compose. (I7971c)

• Zmiany w interfejsie API ambients. Szczegółowe informacje znajdziesz w logach i dokumentacji Ambient<T> (I4c7ee, b/143769776).

• Dodano ui-livedata – nowy element z adapterem dla LiveData. Przykład użycia: wartość val za pomocą liveData.observeAsState() (Ie9e8c, b/150465596)

• Adaptery Rx bez jawnej wartości początkowej są wycofywane. Użycie wartości null nie zawsze jest najlepszym domyślnym ustawieniem. Jeśli na przykład masz listę, lepiej zacząć od emptyList() lub innego odpowiedniego domyślnego ustawienia (I00025, b/161348384).

• Dodano ui-rxjava2 – nowy element z adapterami dla RxJava2. Przykład użycia: wartość val za pomocą observable.subscribeAsState() (Ifab4b, b/153369097)

• savedInstanceState() można teraz używać z typami z wartością domyślną (I6847f, b/153532190)

• Nowe metody listSaver() i mapSaver(), które ułatwiają pisanie niestandardowych obiektów Saver (I8cf68, b/152331508)

• Nowe funkcje: savedInstanceState() i rememberSavedInstanceState(). Są podobne do state() i remember(), ale mają wbudowane obsługiwane stany zapisane w przypadku instancji (If1987, b/152025209)

Poprawki błędów

• Nazwa runOnIdleCompose została zmieniona na runOnIdle (I83607)
• Dodano eksperymentalny interfejs API LayoutNode (I4f2e9)
• Interfejsy androidx.ui.foundation.TextFieldValue i androidx.ui.input.EditorValue zostały wycofane. Wycofane zostały też komponenty TextField, FilledTextField i CoreTextField, które używają tego typu. Zamiast tego użyj interfejsu androidx.ui.input.TextFieldValue (I4066d, b/155211005).
• Wycofano wycofany interfejs API DrawBackground na rzecz rozszerzenia interfejsu API drawBackground w modyfikatorze. Przekształcono implementacje funkcji color, brush i paint drawBackground, aby zmniejszyć ścieżki kodu oraz usunąć wymóg tworzenia modyfikatora w ramach kompozycji. (I0343a)
• Zaktualizowano interfejsy API wyższego poziomu, które udostępniają interfejs Canvas, tak aby zamiast niego udostępniały interfejs CanvasScope. Dzięki temu użytkownicy nie muszą już samodzielnie zarządzać obiektami w Paint. Użytkownicy, którzy nadal potrzebują dostępu do Canvas, mogą użyć metody rozszerzenia drawCanvas, która zapewnia wywołanie zwrotne do wydawania poleceń rysowania do Canvas. (I80afd)
• Zmiana interfejsu lambda z dodatkiem Constraints. Teraz zamiast 2 parametrów ma zakres odbiornika, który oprócz ograniczeń i kierunku układu zawiera właściwości minWidth, maxWidth, minHeight i maxHeight w pikselach (I91b9a, b/149979702)
• Dodano modyfikator symetrycznego wypełnienia. (I39840)
• Zaktualizowano wrapContentWidth i wrapContentHeight, aby oczekiwały wyrównania pionowego lub poziomego zamiast dowolnego wyrównania. Modyfikator grawitacji został zaktualizowany, aby umożliwiać wyrównanie w pionie lub poziomie. Wiersz, kolumna i stos zostały zaktualizowane, aby obsługiwać niestandardowe ciągłe wyrównania. (Ib0728)
• Nazwa modułu ui-text została zmieniona na ui-text-core (I57dec).
• Ulepszenie interfejsu DrawModifier API:
  • Zmiana zakresu odbiornika dla metody draw() ContentDrawScope
  • Usunięto wszystkie parametry w metodzie draw().
  • DrawScope ma ten sam interfejs co poprzedni CanvasScope
  • ContentDrawScope ma metodę drawContent() (Ibaced, b/152919067).
• Obiekt ColoredRect został wycofany. Zamiast tego użyj pola Box(Modifier.preferredSize(width, height).drawBackground(color)). (I499fa, b/152753731)
• Zastąpienie operatora Modifier plus funkcjami rozszerzenia fabrycznego (I225e4)
• Elementy RowScope i ColumnScope są teraz dostępne poza elementami Row i Column. (I3a641)
• Zmieniono nazwę LayoutFlexible na LayoutWeight. Parametr tight został przemianowany na fill. (If4738)
• WithConstraints ma parametr LayoutDirection (I6d6f7).
• Zmieniono nazwę tła na DrawBackground i ustawiono domyślne zapamiętywanie (Ia0bd3).
• Zastąpiono ButtonStyle oddzielnymi funkcjami i usunięto przeciążenie tekstu (string). Informacje o użyciu znajdziesz w zaktualizowanych przykładach. (If63ab, b/146478620, b/146482131)
• Funkcje runOnIdleCompose i runOnUiThread są teraz funkcjami globalnymi zamiast metodami w komponencie ComposeTestRule. (Icbe8f)

Darowizna zewnętrzna

• Usuwanie z poziomu portowania Compose Runtime niepotrzebnych interfejsów API, takich jak Looper i Handler (I6847d)
• Wycofaj parametr Flow<T>.collectAsState() bez wartości początkowej. Użyj funkcji StateFlow<T> lub podaj jawną wartość początkową. (I63f98, b/157674865)