Utwórz materiał

Struktura

Compose to połączenie 7 identyfikatorów grupy Maven w androidx. Każda grupa zawiera ukierunkowany podzbiór funkcji, a każda z nich ma własny zestaw informacji o wersji.

W tej tabeli znajdziesz wyjaśnienie grup i linki do poszczególnych zestawów informacji o wersji.

Deklarowanie zależności

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

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

dependencies {
    implementation "androidx.compose.material:material:1.9.5"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.15"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.compose.material:material:1.9.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 odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk gwiazdki.

Tworzenie nowego problemu

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

Wersja 1.10

Wersja 1.10.0-rc01

19 listopada 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-rc01 Wersja 1.10.0-rc01 zawiera te zmiany.

Wersja 1.10.0-beta02

5 listopada 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-beta02 Wersja 1.10.0-beta02 zawiera te zmiany.

Wersja 1.10.0-beta01

22 października 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-beta01 Wersja 1.10.0-beta01 zawiera te zmiany.

Wersja 1.10.0-alpha05

8 października 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-alpha05 Wersja 1.10.0-alpha05 zawiera te zmiany.

Wersja 1.10.0-alpha04

24 września 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-alpha04 Wersja 1.10.0-alpha04 zawiera te zmiany.

Wersja 1.10.0-alpha03

10 września 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-alpha03 Wersja 1.10.0-alpha03 zawiera te zmiany.

Wersja 1.10.0-alpha02

27 sierpnia 2025 roku

Publikacja androidx.compose.material:material-*:1.10.0-alpha02 Wersja 1.10.0-alpha02 zawiera te zmiany.

Wersja 1.10.0-alpha01

13 sierpnia 2025 r.

Publikacja androidx.compose.material:material-*:1.10.0-alpha01 Wersja 1.10.0-alpha01 zawiera te zmiany.

Poprawki błędów

• Przeniesienie domyślnego minSdk z API 21 do API 23. (Ibdfca, b/380448311, b/435705964, b/435705223)

Wersja 1.9

Wersja 1.9.5

19 listopada 2025 r.

Publikacja androidx.compose.material:material-*:1.9.5 Wersja 1.9.5 zawiera te zatwierdzenia.

Wersja 1.9.4

22 października 2025 r.

Publikacja androidx.compose.material:material-*:1.9.4 Wersja 1.9.4 zawiera te zatwierdzenia.

Wersja 1.9.3

8 października 2025 r.

Publikacja androidx.compose.material:material-*:1.9.3 Wersja 1.9.3 zawiera te zatwierdzenia.

Wersja 1.9.2

24 września 2025 r.

Publikacja androidx.compose.material:material-*:1.9.2 Wersja 1.9.2 zawiera te zatwierdzenia.

Wersja 1.9.1

10 września 2025 r.

Publikacja androidx.compose.material:material-*:1.9.1 Wersja 1.9.1 zawiera te zatwierdzenia.

Wersja 1.9.0

13 sierpnia 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0 Wersja 1.9.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.8.0

Zmiany w zachowaniu

• Sprawdzanie kodu w Compose wymaga teraz minimalnej wersji AGP 8.8.2. Jeśli nie możesz uaktualnić AGP, możesz zamiast tego uaktualnić Lint, używając w pliku gradle.properties wersji android.experimental.lint.version=8.8.2 lub nowszej. Aby uruchamiać sprawdzanie kodu Compose w IDE, musisz mieć Androida Studio Ladybug lub nowszego.

Zmiany w interfejsie API

• Projekty wydane w Kotlinie 2.0 wymagają użycia KGP w wersji 2.0.0 lub nowszej. (Idb6b5)
• Interfejsy API pola tekstowego nie są już eksperymentalne. (I7480f)

Poprawki błędów

• ExposedDropdownMenu jest binarnie zgodna ze starszymi wersjami. (I133f7)

Wersja 1.9.0-rc01

30 lipca 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-rc01 Wersja 1.9.0-rc01 zawiera te zatwierdzenia.

Wersja 1.9.0-beta03

16 lipca 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-beta03 Wersja 1.9.0-beta03 zawiera te zatwierdzenia.

Wersja 1.9.0-beta02

2 lipca 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-beta02 Wersja 1.9.0-beta02 zawiera te zatwierdzenia.

Wersja 1.9.0-beta01

18 czerwca 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-beta01 Wersja 1.9.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

• Hiperlinki w Text(AnnotatedString) mają teraz domyślnie styl Material. (I0e8ed, b/339843816)

Wersja 1.9.0-alpha04

4 czerwca 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-alpha04 Wersja 1.9.0-alpha04 zawiera te zatwierdzenia.

Wersja 1.9.0-alpha03

20 maja 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-alpha03 Wersja 1.9.0-alpha03 zawiera te zatwierdzenia.

Wersja 1.9.0-alpha02

7 maja 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-alpha02 Wersja 1.9.0-alpha02 zawiera te zatwierdzenia.

Wersja 1.9.0-alpha01

23 kwietnia 2025 r.

Publikacja androidx.compose.material:material-*:1.9.0-alpha01 Wersja 1.9.0-alpha01 zawiera te zatwierdzenia.

Zmiany w zachowaniu

• Sprawdzanie kodu w Compose wymaga teraz minimalnej wersji AGP 8.8.2. Jeśli nie możesz uaktualnić AGP, możesz zamiast tego uaktualnić Lint, używając w pliku gradle.properties wersji android.experimental.lint.version=8.8.2 (lub nowszej). Aby uruchamiać sprawdzanie kodu Compose w IDE, musisz mieć Androida Studio Ladybug lub nowszego.

Zmiany w interfejsie API

• Projekty wydane w Kotlinie 2.0 wymagają użycia KGP w wersji 2.0.0 lub nowszej. (Idb6b5)
• Interfejsy API pola tekstowego nie są już eksperymentalne (I7480f, b/269651160)
• Zastąpienie terminu runWithTimingDisabled terminem runWithMeasurementDisabled, który lepiej opisuje działanie – wszystkie dane są wstrzymane. Dodatkowo udostępnij superklasę MicrobenchmarkScope, ponieważ ponowne zadeklarowanie funkcji runWithMeasurementDisabled w celu otwarcia dostępu nie jest możliwe, ponieważ jest ona wstawiana w kodzie. (I9e23b, b/389149423, b/149979716)

Poprawki błędów

• ExposedDropdownMenu jest binarnie zgodna ze starszymi wersjami. (I133f7)
• Naprawiono błąd powodujący awarię wskaźników postępu i wczytywania w przypadku przekazania wartości Float.NaN jako postępu. (I4fa96, b/352364576)

Wersja 1.8

Wersja 1.8.3

18 czerwca 2025 r.

Publikacja androidx.compose.material:material-*:1.8.3 Wersja 1.8.3 zawiera te zmiany.

Wersja 1.8.2

20 maja 2025 r.

Publikacja androidx.compose.material:material-*:1.8.2 Wersja 1.8.2 zawiera te zatwierdzenia.

Wersja 1.8.1

7 maja 2025 r.

Publikacja androidx.compose.material:material-*:1.8.1 Wersja 1.8.1 zawiera te zmiany.

Wersja 1.8.0

23 kwietnia 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0 Wersja 1.8.0 zawiera te zatwierdzenia.

Wersja 1.8.0-rc03

9 kwietnia 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-rc03 Wersja 1.8.0-rc03 zawiera te zmiany.

Wersja 1.8.0-rc02

26 marca 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-rc02 Wersja 1.8.0-rc02 zawiera te zmiany.

Wersja 1.8.0-rc01

12 marca 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-rc01 Wersja 1.8.0-rc01 zawiera te zmiany.

Wersja 1.8.0-beta03

26 lutego 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-beta03 Wersja 1.8.0-beta03 zawiera te zmiany.

Wersja 1.8.0-beta02

12 lutego 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-beta02 Wersja 1.8.0-beta02 zawiera te zmiany.

Wersja 1.8.0-beta01

29 stycznia 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-beta01 Wersja 1.8.0-beta01 zawiera te zmiany.

Wersja 1.8.0-alpha08

15 stycznia 2025 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha08 Wersja 1.8.0-alpha08 zawiera te zmiany.

Poprawki błędów

• Dodaje displayCutout do grupy wstawek, które komponenty Material domyślnie uwzględniają, aby uniknąć nakładania się treści z wycięciem na wyświetlaczu.
  • Jest to zmiana zachowania, która wpłynie na sposób działania komponentów uwzględniających wcięcia w wyświetlaczu. Obejmuje to wartość domyślną parametru WindowInsets w przypadku komponentów Material 3 uwzględniających wcięcia oraz wartości WindowInsets podane w komponencie.
  • Domyślne obiekty dla Material 2 i Material 3. Jeśli ta zmiana spowoduje niepożądane działanie, ręcznie określ parametr WindowInsets dla każdego komponentu. (I43ee9, b/362508045)
• Aktywność używana jako host dla testowanego komponentu kompozycyjnego podczas korzystania z funkcji ComposeContentTestRule.setContent używa teraz motywu Theme.Material.Light.NoActionBar, aby uniknąć nakładania się elementu ActionBar na treści testowe w przypadku pakietu SDK 35. Aby zrezygnować z tego działania, możesz usunąć zależność od ui-test-manifest i dodać wpis aktywności w AndroidManifest.xml aplikacji testowej dla ComponentActivity z wybranym motywem. (I7ae1b, b/383368165)

Wkład zewnętrzny

• Udostępnij sheetGesturesEnabled w ModalBottomSheetLayout. (I3f032, b/329543529)

Wersja 1.8.0-alpha07

11 grudnia 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha07 Wersja 1.8.0-alpha07 zawiera te zmiany.

Poprawki błędów

• Naprawiono problem z nieprawidłowym działaniem modyfikatorów rozmiaru pola tekstowego. (I90d4c, b/356905963)

Wersja 1.8.0-alpha06

13 listopada 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha06 Wersja 1.8.0-alpha06 zawiera te zmiany.

Wersja 1.8.0-alpha05

30 października 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha05 Wersja 1.8.0-alpha05 zawiera te zmiany.

Poprawki błędów

• Zoptymalizuj działanie komponentu Scaffold contentPadding, aby uniknąć ciągłego ponownego komponowania treści, gdy zmienia się komponent contentPadding. (I8c8e2, b/373904168)
• Spraw, aby suwak materiału zmieniał wartość po naciśnięciu klawiszy sterujących. (I1c442)

Wersja 1.8.0-alpha04

16 października 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha04 Wersja 1.8.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

• Usuń readOnly z TextFields', aby przypiąć do stabilnej wersji podstawowej. (I3aaba)

Poprawki błędów

• Dodaje obsługę efektu falowania w rozwijanych komponentach na Androidzie S+, np. na karcie, która rozwija się po kliknięciu. Wcześniej efekt rozchodzenia się nie wypełniał nowego rozmiaru, ale teraz będzie się rozszerzał do nowych granic. (If509a, b/183019123)

Wersja 1.8.0-alpha02

18 września 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha02 Wersja 1.8.0-alpha02 zawiera te zmiany.

Wersja 1.8.0-alpha01

4 września 2024 r.

Publikacja androidx.compose.material:material-*:1.8.0-alpha01 Wersja 1.8.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

• Dodaliśmy nowy konstruktor NavGraphBuilder.bottomSheet do tworzenia komponentu BottomSheet z argumentami bezpiecznymi ((I28589, I777db, b/351858980)).
• Dodano nowe przeciążenia funkcji TextField i OutlinedTextField, które przyjmują argument TextFieldState (I3b74c).

Wersja 1.7

Wersja 1.7.8

12 lutego 2025 r.

Publikacja androidx.compose.material:material-*:1.7.8 Wersja 1.7.8 zawiera te zmiany.

Wersja 1.7.7

29 stycznia 2025 r.

Publikacja androidx.compose.material:material-*:1.7.7 Bez zmian w porównaniu z wersją 1.7.6.

Wersja 1.7.6

11 grudnia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.6 Wersja 1.7.6 zawiera te zmiany.

Wersja 1.7.5

30 października 2024 r.

Publikacja androidx.compose.material:material-*:1.7.5 Wersja 1.7.5 zawiera te zmiany.

Wersja 1.7.4

16 października 2024 r.

Publikacja androidx.compose.material:material-*:1.7.4 Wersja 1.7.4 zawiera te zmiany.

Wersja 1.7.2

18 września 2024 r.

Publikacja androidx.compose.material:material-*:1.7.2 Wersja 1.7.2 zawiera te zmiany.

Wersja 1.7.1

10 września 2024 r.

• Brak zmian w artefaktach Androida. Usunięto -desktop artefaktów, a dodano -jvmStubs i -linuxx64Stubs artefakty. Żaden z tych celów nie jest przeznaczony do użycia. Są to tylko symbole zastępcze, które mają pomóc w pracach nad Jetbrains Compose.

Wersja 1.7.0

4 września 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0 Wersja 1.7.0 zawiera te zmiany.

Ważne zmiany od wersji 1.6.0

• Komponenty Material zostały przeniesione, aby korzystać z nowych interfejsów API efektu falowania, i nie wysyłają już zapytań do RippleTheme.
• Komponenty Material, które wcześniej akceptowały wartość MutableInteractionSource i miały domyślną wartość remember { MutableInteractionSource() }, akceptują teraz wartość MutableInteractionSource z możliwością wartości null i mają domyślną wartość null. Jeśli nie używasz funkcji podnoszenia i nie korzystasz z funkcji MutableInteractionSource, przekaż wartość null. Dzięki temu niektóre komponenty mogą tworzyć instancję tylko wtedy, gdy jest to potrzebne, co zwiększa wydajność. Zalecamy też wprowadzenie podobnych zmian we własnych komponentach.
• BottomDrawer, ModalBottomSheet, BackdropScaffold i standardowy Bottomsheet zostały przeniesione do stabilnego interfejsu API.

Wersja 1.7.0-rc01

21 sierpnia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-rc01 Wersja 1.7.0-rc01 zawiera te zmiany.

Wersja 1.7.0-beta07

7 sierpnia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta07 Wersja 1.7.0-beta07 zawiera te zmiany.

Wersja 1.7.0-beta06

24 lipca 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta06 Wersja 1.7.0-beta06 zawiera te zmiany.

Wersja 1.7.0-beta05

10 lipca 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta05 Wersja 1.7.0-beta05 zawiera te zmiany.

Wersja 1.7.0-beta04

26 czerwca 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta04 Wersja 1.7.0-beta04 zawiera te zmiany.

Wersja 1.7.0-beta03

12 czerwca 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta03 Wersja 1.7.0-beta03 zawiera te zmiany.

Wersja 1.7.0-beta02

29 maja 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta02 Wersja 1.7.0-beta02 zawiera te zmiany.

Zmiany w interfejsie API

• Aktualizacja interfejsu API do stylizowania linków: przeniesiono TextLinkStyles do TextStyle i usunięto TextDefaults z materiału (I5477b)

Wersja 1.7.0-beta01

14 maja 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-beta01 Wersja 1.7.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

• Zaktualizowano interfejs API do pobierania linków w tekście z motywem Material. W szczególności usunęliśmy metody z TextDefaults do tworzenia tematycznych LinkAnnotations i parsowania kodu HTML z tematycznymi linkami. Zamiast tego dodaliśmy do funkcji kompozycyjnej Text parametr TextLinkStyles, który umożliwia stylowanie linków. (I31b93)

Wersja 1.7.0-alpha08

1 maja 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha08 Wersja 1.7.0-alpha08 zawiera te zmiany.

Zmiany w interfejsie API

• Naprawiono problem z niezastosowaniem backgroundColor do TextFieldDecorationBox i OutlinedTextFieldDecorationBox. Pudełka dekoracyjne akceptują teraz parametr shape. (I371c2, b/307694651)
• Pole RippleConfiguration#isEnabled zostało usunięte, a pole LocalRippleConfiguration może teraz przyjmować wartość null. Aby wyłączyć efekt fali, zamiast podawać RippleConfiguration z wartością isEnabled = false, podaj null do LocalRippleConfiguration. (I22725)
• Oprócz normalnego stylu, stylu po najechaniu kursorem i stylu po zaznaczeniu linki tekstowe mają też opcję stylu po kliknięciu. TextDefaults ma argument pressedStyle, który to potwierdza. (Ic473f, b/139312671)

Poprawki błędów

• OutlinedTextField górny odstęp od etykiety uwzględnia teraz rozmiar czcionki systemowej. (Idc781)

Wersja 1.7.0-alpha07

17 kwietnia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha07 Wersja 1.7.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

• Oprócz normalnego stylu, stylu po najechaniu kursorem i stylu po zaznaczeniu linki tekstowe mają też opcję stylu po kliknięciu. (I5f864, b/139312671)
• Dodano obiekt TextDefaults, który zawiera metody tworzenia obiektu LinkAnnotation i parsowania ciągu znaków z tagami HTML, które stosują MaterialTheme do linków. (I98532, b/139312671)

Wersja 1.7.0-alpha06

3 kwietnia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha06 Wersja 1.7.0-alpha06 zawiera te zmiany.

Ogłoszenie

• androidx.compose.material nie wymaga już używania tej samej wersji każdego artefaktu w tej grupie Maven. Użytkownicy mogą łączyć ze sobą różne wersje podstawowych bibliotek Compose (Ie5fba).

Zmiany w interfejsie API

• Przeniesiono więcej domyślnych wartości ModalDrawer i BottomDrawer do obiektu DrawerDefaults. (Ib5b2e)

Wersja 1.7.0-alpha05

20 marca 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha05 Wersja 1.7.0-alpha05 zawiera te zmiany.

Zmiany w interfejsie API

• Oznaczenie ScaffoldSubcomposeInMeasureFix zostało usunięte. (I67363)

Wersja 1.7.0-alpha04

6 marca 2024 roku

Publikacja androidx.compose.material:material-*:1.7.0-alpha04 Wersja 1.7.0-alpha04 zawiera te zmiany.

Nowe funkcje

• Dodaliśmy nowy artefakt androidx.compose.material:material-navigation, który dodaje obsługę arkuszy u dołu jako miejsc docelowych podczas korzystania z Navigation Compose. Zastępuje to bibliotekę materiałów do nawigacji w Accompanist. (d65d57, b/180247978)

Wersja 1.7.0-alpha03

21 lutego 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha03 Wersja 1.7.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• BottomDrawer został przeniesiony z wersji eksperymentalnej do stabilnej. BottomDrawerState udostępnia teraz postęp jako funkcję, co umożliwia sprawdzanie postępu między określonymi celami. BottomDrawerState umożliwia teraz dostosowywanie specyfikacji animacji, a confirmStateChange nie jest już końcową funkcją lambda. (I9c029, b/261423850)
• BackdropScaffold został przeniesiony z wersji eksperymentalnej do stabilnej. Specyfikacja animacji jest teraz specyfikacją tween zgodnie z wytycznymi. Parametr snackbarHost funkcji BackdropScaffold nie jest już ostatnim parametrem, aby uniknąć pomyłek z funkcjami LAMBDA na końcu. BackdropScaffoldState udostępnia interfejs API progress(from, to) do sprawdzania postępu między punktami zakotwiczenia. (I73f48, b/261423218)
• Standardowe arkusze dolne zostały przeniesione z wersji eksperymentalnej do stabilnej. Przestarzałe konstruktory zostały usunięte. Specyfikacja animacji jest teraz specyfikacją przejścia zgodnie z wytycznymi. (I3c1a8, b/278692145, b/261409034)
• Modalne arkusze u dołu zostały przeniesione z wersji eksperymentalnej do stabilnej. Przestarzałe konstruktory zostały usunięte. Specyfikacja animacji jest teraz specyfikacją tween zgodnie z wytycznymi. (Ic53f4, b/278692145, b/266780235, b/261409034)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował awarię BackdropScaffold w określonych scenariuszach w połączeniu z LookaheadScope. (I51396)
• Usunięto podkompozycję w BottomSheetScaffold, aby zwiększyć wydajność. Rozwiązaliśmy problem, który powodował awarię BottomSheetScaffold w określonych sytuacjach w połączeniu z LookaheadScope. (I2f90c)
• Usunięto podkompozycję w ModalBottomSheetLayout, co poprawiło wydajność. (I7a025)

Wersja 1.7.0-alpha02

7 lutego 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha02 Wersja 1.7.0-alpha02 zawiera te zatwierdzenia.

Wersja 1.7.0-alpha01

24 stycznia 2024 r.

Publikacja androidx.compose.material:material-*:1.7.0-alpha01 Wersja 1.7.0-alpha01 zawiera te zatwierdzenia.

Zmiany w zachowaniu

• Komponenty Material zostały przeniesione, aby korzystać z nowych interfejsów API efektu falowania, i nie wysyłają już zapytań do RippleTheme.

Zmiany w interfejsie API

• rememberRipple i RippleTheme zostały wycofane z material-ripple, a do bibliotek material i innych bibliotek systemu projektowania dodano nowe interfejsy API ripple i RippleConfiguration.

• Komponenty Material, które wcześniej akceptowały wartość MutableInteractionSource i domyślnie zapamiętywały wartość { MutableInteractionSource() }, teraz akceptują wartość MutableInteractionSource z możliwością przypisania wartości null i domyślnie przyjmują wartość null. Jeśli nie używasz funkcji podnoszenia i nie korzystasz z funkcji MutableInteractionSource, przekaż wartość null. Dzięki temu niektóre komponenty mogą tworzyć instancję tylko wtedy, gdy jest to potrzebne, co zwiększa wydajność. Zalecamy też wprowadzenie podobnych zmian we własnych komponentach.

Wersja 1.6

Wersja 1.6.8

12 czerwca 2024 r.

Publikacja androidx.compose.material:material-*:1.6.8 Wersja 1.6.8 zawiera te zmiany.

Wersja 1.6.7

1 maja 2024 r.

Publikacja androidx.compose.material:material-*:1.6.7 Wersja 1.6.7 zawiera te zmiany.

Wersja 1.6.6

17 kwietnia 2024 r.

Publikacja androidx.compose.material:material-*:1.6.6 Brak zmian od ostatniej wersji.

Wersja 1.6.5

3 kwietnia 2024 r.

Publikacja androidx.compose.material:material-*:1.6.5 Wersja 1.6.5 zawiera te zmiany.

Wersja 1.6.4

20 marca 2024 r.

Publikacja androidx.compose.material:material-*:1.6.4 Wersja 1.6.4 zawiera te zmiany.

Wersja 1.6.3

6 marca 2024 roku

Publikacja androidx.compose.material:material-*:1.6.3 Wersja 1.6.3 zawiera te zmiany.

Poprawki błędów

• Napraw regresję w ExposedDropdownMenu, aby można było ponownie ustawić na nim fokus. (c0e0ed, b/323694447)

Wersja 1.6.2

21 lutego 2024 r.

Publikacja androidx.compose.material:material-*:1.6.2 Wersja 1.6.2 zawiera te zatwierdzenia.

Wersja 1.6.1

7 lutego 2024 r.

Publikacja androidx.compose.material:material-*:1.6.1 Wersja 1.6.1 zawiera te zatwierdzenia.

Wersja 1.6.0

24 stycznia 2024 r.

Publikacja androidx.compose.material:material-*:1.6.0 Wersja 1.6.0 zawiera te zatwierdzenia.

Wersja 1.6.0-rc01

10 stycznia 2024 r.

Publikacja androidx.compose.material:material-*:1.6.0-rc01 Wersja 1.6.0-rc01 zawiera te zatwierdzenia.

Wersja 1.6.0-beta03

13 grudnia 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-beta03 Wersja 1.6.0-beta03 zawiera te zatwierdzenia.

Wersja 1.6.0-beta02

29 listopada 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-beta02 Wersja 1.6.0-beta02 zawiera te zatwierdzenia.

Wersja 1.6.0-beta01

15 listopada 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-beta01 Wersja 1.6.0-beta01 zawiera te zatwierdzenia.

Wersja 1.6.0-alpha08

18 października 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha08 Wersja 1.6.0-alpha08 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wycofaj funkcję materialIcon na rzecz jej przeciążenia, które przyjmuje parametr autoMirror. (Ia338d)

Poprawki błędów - Automatyczne zwiększanie wysokości elementu nawigacyjnego w przypadku dużej ilości treści. (0c4ecc, b/272336962)

Wersja 1.6.0-alpha07

4 października 2023 roku

Publikacja androidx.compose.material:material-*:1.6.0-alpha07 Wersja 1.6.0-alpha07 zawiera te zatwierdzenia.

• Aktualizacje zależności

Wersja 1.6.0-alpha06

20 września 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha06 Wersja 1.6.0-alpha06 zawiera te zatwierdzenia.

Zmiana powodująca niezgodność w zachowaniu

• Usunięto z BottomSheetScaffold funkcje związane z szufladą. Aby uzyskać poprzednią funkcjonalność, umieść element BottomSheetScaffold w komponencie Drawer. Przykład znajdziesz w sekcji BottomSheetScaffoldWithDrawerSample. (I1dcc8)

Zmiany w interfejsie API

• Wprowadzono tymczasową flagę, która określa, czy komponent Scaffold ma mierzyć swoje elementy podrzędne podczas pomiaru czy podczas umieszczania. Domyślnie będzie to pomiar. Jeśli masz problemy z nowym działaniem, zgłoś je. (If6e3b)

Wersja 1.6.0-alpha05

6 września 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha05 Wersja 1.6.0-alpha05 zawiera te zatwierdzenia.

Nowe funkcje

• Dodano obsługę automatycznego odbijania ikon w przypadku renderowania w układach od prawej do lewej. Ikony w modułach material-icons-core i material-icons-extended udostępniają teraz dodatkowe zestawy ikon, które obsługują automatyczne odbijanie lustrzane, jeśli ikona na to pozwala. Nowe zestawy mają prefiks Icons.AutoMirrored.Filled... itp. i zawierają ikony, które będą automatycznie odzwierciedlane w układach od prawej do lewej. Listę ikon, które mogą (i powinny) być automatycznie odzwierciedlane, znajdziesz na tej stronie.

Zmiany w interfejsie API

• Dodano obsługę automatycznego odbijania ikon w przypadku renderowania w układach od prawej do lewej. Ikony w modułach material-icons-core i material-icons-extended udostępniają teraz dodatkowe zestawy ikon, które obsługują automatyczne odbijanie lustrzane, jeśli ikona na to pozwala. Nowe zestawy mają prefiks Icons.AutoMirrored.Filled... itp. i zawierają ikony, które będą automatycznie odzwierciedlane w układach od prawej do lewej. Listę ikon, które mogą (i powinny) być automatycznie odzwierciedlane, znajdziesz na tej stronie. Właściwości ikon podane wcześniej są teraz oznaczone jako wycofane i zawierają sugestię bloku zastępczego, która ułatwia migrację. Jeśli nie masz specjalnych rozwiązań do obsługi ikon w przypadku języków pisanych od prawej do lewej, zalecamy przejście na nowy zestaw ikon. Na przykład Icons.Filled.ArrowBack należy przekształcić w Icons.AutoMirrored.Filled.ArrowBack. (I4b511)

Wersja 1.6.0-alpha04

23 sierpnia 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha04 Wersja 1.6.0-alpha04 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że niektóre komponenty używające Subcomposition (np. BottomSheetScaffold) w komponencie Scaffold w LookaheadScope próbowały odczytać swój rozmiar zbyt wcześnie. (If2c5d)
• Poprawiliśmy obliczenia DropdownMenu w offset, aby przesunięcia wzdłuż osi X zależały wyłącznie od lokalnego kierunku układu, a przesunięcia wzdłuż osi Y nie były już odwracane, gdy menu znajduje się u dołu ekranu. (Iccc74, b/294103942)
• Zoptymalizowaliśmy wewnętrzną strukturę elementu BottomSheetScaffold i rozwiązaliśmy potencjalny problem z elementem BottomSheetScaffold w elemencie LookaheadLayout. (Ic0afa)

Wersja 1.6.0-alpha03

9 sierpnia 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha03 Wersja 1.6.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Komponenty Material2 mają teraz osobny interfejs API do przekazywania windowInsets, aby obsługiwać funkcję od krawędzi do krawędzi na Androidzie. W przeciwieństwie do komponentów material3 komponenty material2 nie obsługują domyślnie wcięć, dlatego wartość należy przekazywać ręcznie. Zapoznaj się z odpowiednimi przykładami. (I655e8)

Wersja 1.6.0-alpha02

26 lipca 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha02 Wersja 1.6.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Przenosimy zależność od gęstości na poziom komponentu. Dotyczy to tych komponentów: SwipeToDismiss i komponentów opartych na arkuszach. Użyj nowego przeciążenia, w którym gęstość jest parametrem. (I1846e)
• Dodatkowe adnotacje określające dozwolone dane wejściowe funkcji kompozycyjnych (I51109)
• Zaktualizowano pliki interfejsu API, aby dodać adnotacje o pomijaniu zgodności (I8e87a, b/287516207)
• Dodano nowe wyrównanie do początku dla FabPosition (Ib7aea, b/170592777)
• TextFieldColorsWithIcons w Materialu 2 zostało wycofane na rzecz TextFieldColors. Zastępując leadingIconColor lub trailingIconColor, zastąp też przeciążenie za pomocą interactionSource. (Id57ed, b/199377790)

Wersja 1.6.0-alpha01

21 czerwca 2023 r.

Publikacja androidx.compose.material:material-*:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zatwierdzenia.

Zmiany w zachowaniu

• W typografii Material 2 znak includeFontPadding jest teraz domyślnie zastępowany znakiem false. Domyślny styl wysokości wiersza został też zmieniony na Trim.None i Alignment.Center, a do TextStyle w Typography dodano wyraźne lineHeight (w sp). Jeśli chcesz dostosować te wartości, zapoznaj się z dokumentacją interfejsu API. Szczegółowe wyjaśnienie tych zmian znajdziesz w tym poście na blogu. (Icabc3, I3f801, I04c03)

Zmiany w interfejsie API

• Interfejsy API Swipeable Material zostały wycofane. Skorzystaj z interfejsów API AnchoredDraggableFoundation, które są zoptymalizowane pod kątem prostych i złożonych przypadków użycia. (I732e0)

Poprawki błędów

• BottomSheetState, ModalBottomSheetState i BottomDrawerState udostępniają teraz właściwość postępu, która wskazuje postęp między bieżącym (ustalonym) punktem zakotwiczenia a najbliższym punktem zakotwiczenia w kierunku przesunięcia. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861)

Wersja 1.5

Wersja 1.5.4

18 października 2023 r.

Publikacja androidx.compose.material:material-*:1.5.4 Wersja 1.5.4 zawiera te zatwierdzenia.

Wersja 1.5.3

4 października 2023 roku

Publikacja androidx.compose.material:material-*:1.5.3 Ta wersja nie zawiera żadnych zmian

Wersja 1.5.2

27 września 2023 r.

Publikacja androidx.compose.material:material-*:1.5.2 Wersja 1.5.2 zawiera te zatwierdzenia.

Wersja 1.5.1

6 września 2023 r.

androidx.compose.material:material-*:1.5.1 zostaje opublikowany bez zmian. Wersja 1.5.1 zawiera te zatwierdzenia.

Wersja 1.5.0

9 sierpnia 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0 Wersja 1.5.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.4.0

Zmiany w interfejsie API

• Wprowadzono zmiany w interfejsach Swipeable1 API w BottomSheetScaffold. Parametr confirmStateChange użytkownika BottomSheetState został zmieniony na confirmValueChange. progress jest teraz udostępniana jako wartość zmiennoprzecinkowa. animateTo i snapTo są wewnętrzne. Zamiast niej używaj zasad expand() i collapse(). Elementy direction i overflow zostały usunięte. offset zostało zastąpione przez requireOffset(). I323b4
• Oznacz funkcję snapTo w komponencie Drawer jako interfejs API, który nie jest eksperymentalny. (Ib9c18, b/261425368)
• Dodaliśmy parametr koloru ścieżki dla kołowych wskaźników postępu oraz parametr zakończenia linii dla kołowych i liniowych wskaźników postępu. (Ie668c, b/216325962, b/222964817)
• Zmieniliśmy nazwę confirmStateChange na confirmValueChange w przypadku ModalBottomSheetState, ModalBottomSheetState.Saver i rememberModalBottomSheetState. (Ib48d1)
• Dodaj Modifier.minimumInteractiveComponentSize. Można go użyć do zarezerwowania co najmniej 48 dp, aby odróżnić interakcje dotykowe, jeśli element jest mniejszy. (I33f58, b/258495559)
• Wprowadzono zmiany w interfejsach API do przesuwania w ModalBottomSheetLayout. Funkcja animateTo w ModalBottomSheetState nie przyjmuje już parametru animationSpec, a udostępniany offset może mieć teraz wartość null. Użyj requireOffset, aby wymagać przesunięcia. (Ia2e79)
• Dodawanie adnotacji @JvmDefaultWithCompatibility (I8f206)
• Wprowadzono zmiany w interfejsach API z możliwością przesuwania w ModalDrawer. DrawerState. animateTo zastąpiono metodami otwierania i zamykania, a przesunięcie jest teraz dopuszczalne. Użyj requireOffset, aby wymagać przesunięcia. (I3de9e)
• Zaktualizowano panele i arkusze, aby prawidłowo opóźniać naciśnięcia w przypadku, gdy gesty mogą stać się zdarzeniami przewijania.
• Dodano parametr minLines do komponentów tekstowych material i material3, TextField i OutlinedTextField, który umożliwia ustawienie minimalnej wysokości komponentu w wierszach (I4af1d).

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że pullRefresh nie wykorzystywał prędkości, co powodowało wyświetlanie przewijania poza zakres. Zmieniono też sygnaturę interfejsu API funkcji onRelease w Modifier.pullRefresh, aby zwracała wartość zmiennoprzecinkową dla zużytej prędkości (I7db65, b/266874741).
• BottomSheetState, ModalBottomSheetState i BottomDrawerState udostępniają teraz właściwość postępu, która wskazuje postęp między bieżącym (ustalonym) punktem zakotwiczenia a najbliższym punktem zakotwiczenia w kierunku przesunięcia. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861)
• Naprawiliśmy AlertDialog działanie odrzucania, aby pojawiało się pod działaniem potwierdzania, gdy działania były ułożone jeden nad drugim, aby zmieścić się w oknie dialogowym. Ta poprawka dostosowuje implementację do specyfikacji Material Design. (I029de, b/235454277)
• Gdy wartość parametru gesturesEnabled to fałsz, element BottomSheetScaffold nie będzie już uczestniczyć w przewijaniu zagnieżdżonym. (I634f3, b/215403277)
• Naprawiliśmy błąd, który powodował awarię BottomSheetScaffold, gdy w przypadku slotów podano puste treści. (Ib24a5, b/235588730)
• Poprawki PullRefreshIndicator przechwytywania kliknięć i zdarzeń wskaźnika. (2494256, b/271777421)
• Rozwiązaliśmy problem, który powodował awarię ModalBottomSheetLayout w przypadku zmiany orientacji. Animacje układu (np. Modifier.animateContentSize) w treści arkusza działają teraz płynnie. (I2f981, b/266780234)

Wersja 1.5.0-rc01

26 lipca 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zatwierdzenia.

Wersja 1.5.0-beta03

28 czerwca 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-beta03 Wersja 1.5.0-beta03 zawiera te zatwierdzenia.

Poprawki błędów

• BottomSheetState, ModalBottomSheetState i BottomDrawerState udostępniają teraz właściwość postępu, która wskazuje postęp między bieżącym (ustalonym) punktem zakotwiczenia a najbliższym punktem zakotwiczenia w kierunku przesunięcia. (I1b317, b/271169225, b/276375124, b/276776071, b/270066861)

Wersja 1.5.0-beta02

7 czerwca 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-beta02 Wersja 1.5.0-beta02 zawiera te zatwierdzenia.

Wersja 1.5.0-beta01

24 maja 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Przesunięcia DrawerState i BottomDrawerState nie mogą już mieć wartości null. Zamiast tego zwracają wartość Float.NaN, aby wskazać brak przesunięcia. (Ie9855)
• Dodaliśmy opcję przekazywania wartości ScrollState podczas tworzenia elementu DropdownMenu lub ExposedDropdownMenu, aby kontrolować stan przewijania w pionie wyświetlanych elementów menu. (Idb009, b/185304441)
• Dodaj obsługę włączania i wyłączania gestu ModalBottomSheetLayout, aby użytkownik mógł skonfigurować tę funkcję w przypadku bardziej zaawansowanego arkusza u dołu ekranu (I40af0).
• Dodano parametr koloru do BasicText, aby umożliwić wydajne animowanie lub ustawianie koloru tekstu. (Iffd88, b/246961787)
• Zmiana nazwy usługi Semantics z isContainer na isTraversalGroup (I121f6)

Poprawki błędów

• Naprawiliśmy AlertDialog działanie odrzucania, aby pojawiało się pod działaniem potwierdzania, gdy działania były ułożone jeden nad drugim, aby zmieścić się w oknie dialogowym. Ta poprawka dostosowuje implementację do specyfikacji Material Design. (I029de, b/235454277)

Wersja 1.5.0-alpha04

10 maja 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-alpha04 Wersja 1.5.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Przenosimy zależność od gęstości na poziom komponentu. Dotyczy to tych komponentów: BottomDrawer, ModalBottomSheetLayout, BottomSheetScaffold, Switch, ModalDrawer. Użyj nowego przeciążenia, w którym gęstość jest parametrem. (I8fbd8)

Wersja 1.5.0-alpha03

19 kwietnia 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-alpha03 Wersja 1.5.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Zaktualizuj wewnętrzne elementy BottomDrawer, aby korzystać z nowych interfejsów API SwipeableV2. Z tego powodu BottomDrawerState będzie teraz zawierać tylko interfejsy API zdefiniowane na poziomie klasy i nie będzie dziedziczyć metod ani właściwości z SwipeableState. Używamy kompozycji z wewnętrznym SwipeableV2State. Przesunięcie jest teraz właściwością zmiennoprzecinkową, która może przyjmować wartość null. Bieżąca wartość i wartość docelowa przesunięcia są nadal dostępne za pomocą właściwości currentValue i targetValue. Poprzednie metody poziomu klasy, takie jak otwieranie/rozwijanie/zamykanie i właściwości, takie jak isOpen/isClosed, są nadal obsługiwane. (Iad40c, b/178529942, b/220676296)

Poprawki błędów

• Zaktualizowano wewnętrzne elementy komponentu Przełącznik. Podczas przeciągania przełącznik będzie wyświetlać podgląd najbliższego stanu (stanu docelowego). (Id90d4)
• Animowane treści arkusza (np. Modifier.animateContentSize w treści arkusza) w BottomSheetScaffold zostały zoptymalizowane i działają teraz płynnie. (Ia913c, b/270518202, b/254446195)
• BottomSheetScaffold nie będzie już uczestniczyć w zagnieżdżonym przewijaniu, gdy gesturesEnabled będzie mieć wartość false. (I634f3, b/215403277)

Wersja 1.5.0-alpha02

5 kwietnia 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiliśmy błąd, który powodował awarię BottomSheetScaffold, gdy w przypadku slotów podano puste treści. (Ib24a5, b/235588730)
• Naprawia problem z PullRefreshIndicator przechwytującym kliknięcia i zdarzenia wskaźnika (2494256, b/271777421)

Wersja 1.5.0-alpha01

22 marca 2023 r.

Publikacja androidx.compose.material:material-*:1.5.0-alpha01 Wersja 1.5.0-alpha01 zawiera te zatwierdzenia.

Poprawki błędów

• Dodaj przykład zmiany układu chipgroup. Zaktualizuj poziomy odstęp między elementami podrzędnymi w przykładzie grupy pojedynczych elementów, aby był zgodny ze specyfikacją. (I3b155)
• Rozwiązaliśmy problem, który powodował awarię ModalBottomSheetLayout w przypadku zmiany orientacji. Animacje układu (np. Modifier.animateContentSize) w treści arkusza działają teraz płynnie. (I2f981, b/266780234)

Wersja 1.4

Wersja 1.4.3

3 maja 2023 r.

androidx.compose.material:material-*:1.4.3 jest publikowana bez zmian (tylko ze zmianą numeru wersji).

Wersja 1.4.2

19 kwietnia 2023 r.

Publikacja androidx.compose.material:material-*:1.4.2 Wersja 1.4.2 zawiera te zatwierdzenia.

Wersja 1.4.1

5 kwietnia 2023 r.

Publikacja androidx.compose.material:material-*:1.4.1 Wersja 1.4.1 zawiera te zatwierdzenia.

Wersja 1.4.0

22 marca 2023 r.

Publikacja androidx.compose.material:material-*:1.4.0 Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

Zmiany w interfejsie API

• Dodaj Modifier.minimumInteractiveComponentSize. Można go użyć do zarezerwowania co najmniej 48 dp, aby odróżnić interakcje dotykowe, jeśli element jest mniejszy. (I33f58, b/258495559)
• Wprowadzono zmiany w interfejsach API do przesuwania w ModalDrawer. DrawerStateanimateTo została zastąpiona metodami open i close, a przesunięcie jest teraz dopuszczalne. Użyj requireOffset, aby wymagać przesunięcia. (I3de9e)
• Dodano parametr minLines do komponentów tekstowych material i material3, TextField i OutlinedTextField, który umożliwia ustawienie minimalnej wysokości komponentu w wierszach (I4af1d).
• Dodano parametr minLines do parametrów BasicText i BasicTextField. Umożliwia ustawienie minimalnej wysokości tych komponentów w liczbie wierszy (I24294, b/122476634).

Wersja 1.4.0-rc01

8 marca 2023 r.

androidx.compose.material:material-*:1.4.0-rc01 zostaje opublikowany bez zmian. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta02

22 lutego 2023 roku

Publikacja androidx.compose.material:material-*:1.4.0-beta02 Wersja 1.4.0-beta02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wprowadzono zmiany w interfejsach API do przesuwania w BottomSheetScaffold. Parametr confirmStateChange użytkownika BottomSheetState został zmieniony na confirmValueChange. progress jest teraz udostępniana jako wartość zmiennoprzecinkowa. animateTo i snapTo są wewnętrzne. Zamiast niej używaj zasad expand() i collapse(). Elementy direction i overflow zostały usunięte. offset zostało zastąpione przez requireOffset(). (I323b4)

Poprawki błędów

• Usunięto role semantyczne z obszarów klikalnych i wybieralnych, a komponenty, które ich używały, zaktualizowano tak, aby ustawiały role za pomocą modyfikatora semantics (Ibb4ba).
• Drobna aktualizacja rozszerzonych ikon Material, która wprowadza zmiany w wypełnionych ikonach desktop_mac, directions i kitchen. (I65f5e)

Wersja 1.4.0-beta01

8 lutego 2023 r.

Publikacja androidx.compose.material:material-*:1.4.0-beta01 Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Rozwiązaliśmy problem, który powodował, że pullRefresh nie wykorzystywał prędkości, co powodowało wyświetlanie przewijania poza zakres. Zmieniono też sygnaturę interfejsu API funkcji onRelease w Modifier.pullRefresh, aby zwracała wartość zmiennoprzecinkową dla zużytej prędkości (I7db65, b/266874741).
• Przywróć funkcję pobierania właściwości LocalMinimuTouchTargetEnforcement i oznacz ją jako wycofaną, a następnie przekieruj do LocalMinimumInteractiveComponentEnforcement. (I60dd5)

Wersja 1.4.0-alpha05

25 stycznia 2023 r.

Publikacja androidx.compose.material:material-*:1.4.0-alpha05 Wersja 1.4.0-alpha05 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował nieprawidłowe obliczanie stanu ModalBottomSheetLayout's HalfExpanded i wyświetlanie arkusza jako pływającego. (I8c615, b/265610459)
• Naprawiliśmy błąd w ModalBottomSheetLayout, który w pewnych okolicznościach powodował awarię arkusza podczas przechodzenia ze stanu ukrytego do widocznego. (Ia9265, b/265444789)

Wersja 1.4.0-alpha04

11 stycznia 2023 r.

Publikacja androidx.compose.material:material-*:1.4.0-alpha04 Wersja 1.4.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano właściwość semantyczną IsContainer w przestrzeniach. Ta właściwość zostanie użyta w późniejszej zmianie, która określa kolejność przechodzenia na podstawie znaczenia semantycznego elementów, takich jak powierzchnie. (I63379)
• Oznacz funkcję snapTo w komponencie Drawer jako interfejs API, który nie jest eksperymentalny. (Ib9c18, b/261425368)
• Dodaliśmy parametr koloru ścieżki dla kołowych wskaźników postępu oraz parametr zakończenia linii dla kołowych i liniowych wskaźników postępu. (Ie668c, b/216325962, b/222964817)
• Zmieniliśmy nazwę confirmStateChange na confirmValueChange w przypadku ModalBottomSheetState, ModalBottomSheetState.Saver i rememberModalBottomSheetState. (Ib48d1)
• Większa możliwość zwracania wartości null przez wycofane i ukryte funkcje (Ibf7b0)
• Dodaj Modifier.minimumInteractiveComponentSize. Można go użyć do zarezerwowania co najmniej 48 dp, aby odróżnić interakcje dotykowe, jeśli element jest mniejszy. (I33f58, b/258495559)
• Wprowadzono zmiany w interfejsach API do przesuwania w ModalBottomSheetLayout. Funkcja animateTo w ModalBottomSheetState nie przyjmuje już parametru animationSpec, a wartość offset jest teraz dopuszczalna. Użyj requireOffset, aby wymagać offset. (Ia2e79)

Poprawki błędów

• Arkusz ModalBottomSheetLayout ma teraz maksymalną szerokość 640 dp. (I71a4f, b/234927577)
• Rozwiązaliśmy problem polegający na tym, że rememberPullRefreshState nie aktualizował z czasem wartości refreshThreshold i refreshingOffset. (Ifed10, b/263159832)
• Postęp wskaźników postępu jest teraz prawidłowo ograniczony do oczekiwanego zakresu. (I8a7eb, b/262262727)
• Gdy ModalBottomSheetState nie otrzyma jeszcze żadnych kotwic, zaktualizuje currentValue bez animacji, gdy zamiast wyjątku zostaną wywołane snapTo lub animateTo. (I2c91b)
• Poprawiono stan włączenia w implementacji Material 2 FilterChip. (Id326a, b/261329817)
• Usunęliśmy błąd, który powodował awarię ModalBottomSheetLayout, jeśli podczas obracania z orientacji pionowej do poziomej był on HalfExpanded. Sprawdź, czy przekazujesz prawidłowy initialValue, np. sprawdzając konfigurację. (Ie8df7, b/182882364)
• Rozwiązaliśmy problem, który powodował awarię ModalBottomSheetLayout, jeśli zawartość arkusza była pusta. ModalBottomSheetLayout umożliwia teraz tworzenie pustych arkuszy. Jeśli arkusz jest pusty, będzie miał tylko stan Ukryty. (Ic2288, b/200980998, b/216693030)

Znany problem

• Podczas aktualizacji z wersji androidx.compose.foundation:1.4.0-alpha03 do androidx.compose.foundation:1.4.0-alpha04 może wystąpić błąd java.lang.NoSuchFieldError. Tutaj zgłoszono pierwotnie problem. Poprawka została przesłana i będzie dostępna w następnej aktualizacji Compose. Aby rozwiązać ten problem, zaktualizuj biblioteki androidx.compose.material i androidx.compose.material3 do najnowszej wersji (1.1.0-alpha04) lub przywróć starszą wersję biblioteki androidx.compose.foundation (1.4.0-alpha03).

Wersja 1.4.0-alpha03

7 grudnia 2022 r.

Publikacja androidx.compose.material:material-*:1.4.0-alpha03 Wersja 1.4.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodawanie adnotacji @JvmDefaultWithCompatibility (I8f206)
• Wprowadzono zmiany w interfejsach API Swipeable w ModalDrawer. DrawerState animateTo zostało zastąpione metodami open i close, a przesunięcie może teraz przyjmować wartość null. Użyj requireOffset, aby wymagać przesunięcia. (I3de9e)
• Dodano interfejs Modifier API do wysyłania zapytań o informacje o przewijaniu elementów nadrzędnych. (I2ba9d, b/203141462)
• Używany w Clickable do prawidłowego opóźniania interakcji z naciśnięciem, gdy gesty mogą stać się zdarzeniami przewijania.
• Rozwiązaliśmy problem z nieprawidłowym opóźnianiem efektów falowania przez element Clickables, gdy jest używany w elemencie Scrollable ViewGroup.
• Zaktualizowano panele i arkusze, aby prawidłowo opóźniać naciśnięcia w przypadku, gdy gesty mogą stać się zdarzeniami przewijania.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że po wywołaniu funkcji onRefresh funkcja PullRefreshIndicator mogła się zawieszać, jeśli stan odświeżania nie został zmieniony na „true”. (Ie2416, b/248274004)

Aktualizacje zależności

• Biblioteki Compose UI i Compose Material zależą teraz od biblioteki Lifecycle w wersji 2.5.1. (I05ab0, b/258038814)

Wersja 1.4.0-alpha02

9 listopada 2022 r.

Publikacja androidx.compose.material:material-*:1.4.0-alpha02 Wersja 1.4.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Atrybuty awaitFirstDown i waitForUpOrCancellation akceptują teraz PointerEventPass, co zapewnia większą elastyczność. (I7579a, b/212091796)
• Dodano parametr minLines do komponentów tekstowych material i material3, TextField i OutlinedTextField, który umożliwia ustawienie minimalnej wysokości komponentu w wierszach (I4af1d).
• Dodano parametr minLines do parametrów BasicTex i BasicTextField. Umożliwia ustawienie minimalnej wysokości tych komponentów w wierszach (I24294, b/122476634).

Wersja 1.4.0-alpha01

24 października 2022 r.

Publikacja androidx.compose.material:material-*:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaliśmy nową metodę awaitEachGesture() dla wzorców do wykrywania gestów. Działa podobnie jak forEachGesture(), ale pętla gestów działa w całości w ramach AwaitPointerEventScope, więc zdarzenia nie mogą zostać utracone między iteracjami.
• Element forEachGesture() został wycofany na rzecz elementu awaitEachGesture(), ponieważ umożliwia on utratę zdarzeń między gestami. (Iffc3f, b/251260206)

Wersja 1.3

Wersja 1.3.1

9 listopada 2022 r.

Publikacja androidx.compose.material:material-*:1.3.1 Wersja 1.3.1 zawiera te zatwierdzenia.

Wersja 1.3.0

24 października 2022 r.

Publikacja androidx.compose.material:material-*:1.3.0 Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.2.0

Zmiana powodująca niezgodność

• Maksymalna obsługiwana wysokość w oknach i wyskakujących okienkach została zmniejszona do 8 dp.

Zmiany w interfejsie API

• Dodanie komponentu „Przeciągnij, aby odświeżyć” do Compose (I29168).
• Zmiana nazwy parametru z wartości na wartość w suwaku zakresu (I3b79a).

Wersja 1.3.0-rc01

5 października 2022 r.

Publikacja androidx.compose.material:material-*:1.3.0-rc01 Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta03

21 września 2022 r.

Publikacja androidx.compose.material:material-*:1.3.0-beta03 Wersja 1.3.0-beta03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodanie komponentu „Przeciągnij, aby odświeżyć” do Compose (I29168)

Wersja 1.3.0-beta02

7 września 2022 roku

Publikacja androidx.compose.material:material-*:1.3.0-beta02 Wersja 1.3.0-beta02 zawiera te zatwierdzenia.

Brak zmian od wersji 1.3.0-beta01

Wersja 1.3.0-beta01

24 sierpnia 2022 r.

Publikacja androidx.compose.material:material-*:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiana powodująca niezgodność

Maksymalna obsługiwana wysokość w oknach i wyskakujących okienkach została zmniejszona do 8 dp.

Maksymalna obsługiwana wysokość dla okien dialogowych i wyskakujących w Compose została zmniejszona z 30 dp do 8 dp. Ta zmiana dotyczy zarówno niestandardowych okien dialogowych i wyskakujących w stylu Material Design, jak i tych z interfejsem użytkownika. Ta zmiana została wprowadzona, aby wyeliminować błąd ułatwień dostępu w wersjach Androida starszych niż S i zapewnić, że usługi ułatwień dostępu w tych oknach będą mogły wchodzić w interakcje z zawartością w oknie dialogowym lub wyskakującym.

Ta zmiana będzie miała wpływ tylko na użytkowników, którzy tworzą niestandardowe okno lub wyskakujące okienko z ustawionym poziomem podniesienia powyżej 8 dp. Rozważ zmniejszenie wysokości okna dialogowego lub wyskakującego. Jeśli chcesz zrezygnować z tego nowego zachowania, rozważ utworzenie własnego okna lub wyskakującego okienka z ustawionym odpowiednim poziomem. Nie jest to zalecane, ponieważ może negatywnie wpłynąć na ułatwienia dostępu. Deweloper musi zadbać o to, aby dolna część okna lub wyskakującego okienka była interaktywna i czytelna dla usług ułatwień dostępu.

Wersja 1.3.0-alpha03

10 sierpnia 2022 r.

Publikacja androidx.compose.material:material-*:1.3.0-alpha03 Wersja 1.3.0-alpha03 zawiera te zatwierdzenia.

Wersja 1.3.0-alpha02

27 lipca 2022 roku

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

Wkład zewnętrzny

• Rozwiązywanie problemu AnimatedVisibility za pomocą FloatingActionButton w Scaffold (I3a0ae, b/224005027)

Wersja 1.3.0-alpha01

29 czerwca 2022 r.

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

Zmiany w interfejsie API

• Zmiana nazwy parametru z values na value w RangeSlider (I3b79a)

Poprawki błędów

• Zaktualizuj przykładową plakietkę, aby podać bardziej szczegółowy opis treści. (I10b9d)

Wersja 1.2

Wersja 1.2.1

10 sierpnia 2022 r.

Publikacja androidx.compose.material:material-*:1.2.1 Wersja 1.2.1 zawiera te zatwierdzenia.

Wersja 1.2.0

27 lipca 2022 roku

Publikacja androidx.compose.material:material-*:1.2.0 Wersja 1.2.0 zawiera te zatwierdzenia.

Wersja 1.2.0-rc03

29 czerwca 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-rc03 Wersja 1.2.0-rc03 zawiera te zatwierdzenia.

• Brak zmian od wersji 1.2.0-rc02.

Wersja 1.2.0-rc02

22 czerwca 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-rc02 Wersja 1.2.0-rc02 zawiera te zatwierdzenia.

Wersja 1.2.0-rc01

15 czerwca 2022 r.

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

Zmiany w interfejsie API

• Interfejsy w bibliotekach Compose są teraz tworzone przy użyciu domyślnych metod interfejsu jdk8 (I5bcf1).

Poprawki błędów

• Aktualizuje plakietkę z kartą ikony wiodącej, aby przymocować plakietkę do etykiety zamiast do ikony. (I90993)

Wersja 1.2.0-beta03

1 czerwca 2022 r.

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

Poprawki błędów

• Usunęliśmy błąd, który powodował, że element BottomSheetScaffold był rysowany nad cieniem górnego paska aplikacji. BottomSheetScaffold uwzględnia teraz też stan arkusza podczas umieszczania wyskakujących komunikatów: w stanie zwiniętym wyskakujące komunikaty są umieszczane nad arkuszem i przyciskiem FAB, a w stanie rozwiniętym są przytwierdzane do dołu arkusza. (Ia80b5, b/187771422)

Wersja 1.2.0-beta02

18 maja 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-beta02 Wersja 1.2.0-beta02 zawiera te zmiany.

Wersja 1.2.0-beta01

11 maja 2022 roku

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

Nowe funkcje

• To pierwsza wersja beta 1.2.

Zmiany w interfejsie API

• Zmieniono nazwę funkcji TextFieldDefaults.BorderStroke, która rysuje obramowanie w OutlinedTextField, na TextFieldDefaults.BorderBox. (I5f295)

Wersja 1.2.0-alpha08

20 kwietnia 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha08 Wersja 1.2.0-alpha08 zawiera te zmiany.

Zmiany w interfejsie API

• Częściowe wykorzystanie (obniżenie lub pozycja) zostało wycofane w PointerInputChange. Możesz użyć consume(), aby w pełni wykorzystać zmianę. Możesz użyć isConsumed, aby sprawdzić, czy ktoś inny wcześniej wykorzystał tę zmianę.
• PointerInputChange::copy() zawsze tworzy teraz płytką kopię. Oznacza to, że po wykorzystaniu jednej kopii PointerInputChange zostaną wykorzystane kolejne kopie. Jeśli chcesz utworzyć niepowiązany element PointerInputChange, użyj konstruktora. (Ie6be4, b/225669674)

Wersja 1.2.0-alpha07

6 kwietnia 2022 roku

Publikacja androidx.compose.material:material-*:1.2.0-alpha07 Wersja 1.2.0-alpha07 zawiera te zmiany.

Wersja 1.2.0-alpha06

23 marca 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha06 Wersja 1.2.0-alpha06 zawiera te zmiany.

Zmiany w interfejsie API

• Aktualizacje interfejsu API klikalnych kart w celu dostosowania go do zmian w interfejsie Surface API (I56bcb)
• Aktualizacje interfejsu Material 2 Surface API, które dodają dodatkowe przeciążone funkcje dla powierzchni, które można wybrać i przełączać. (Ifcca5)

Wersja 1.2.0-alpha05

9 marca 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha05 Wersja 1.2.0-alpha05 zawiera te zmiany.

Zmiany w interfejsie API

• Wartości LazyVerticalGrid i LazyHorizontalGrid są teraz stabilne. (I307c0)
• LazyVerticalGrid/LazyHorizontalGrid i wszystkie powiązane interfejsy API zostały przeniesione do podpakietu .grid. Zaktualizuj importy z androidx.compose.foundation.lazy do androidx.compose.foundation.lazy.grid. (I2d446, b/219942574)
• Cofnięto poprzednią zmianę polegającą na poleganiu wyłącznie na widoku w przypadku WindowInsetsControllerCompat, i ponownie wymagane jest okno, które jest niezbędne do zarządzania niektórymi flagami okna. Wycofano ViewCompat.getWindowInsetsController na rzecz WindowCompat.getInsetsController, aby mieć pewność, że używane jest prawidłowe okno (np. jeśli widok znajduje się w oknie dialogowym). (I660ae, b/219572936)
• Tekst:includeFontPadding jest teraz domyślnie wyłączony. Problemy z obcinaniem wynikające z includeFontPadding=false zostały rozwiązane i nie powinno już dochodzić do obcinania w przypadku wysokich skryptów. (I31c84, b/171394808)
• Dodano nowy interfejs API LazyVerticalGrid do określania rozmiarów osi poprzecznej (I17723).

Wersja 1.2.0-alpha04

23 lutego 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha04 Wersja 1.2.0-alpha04 zawiera te zmiany.

Zmiany w interfejsie API

• Add support for filter chips (I39a6e, b/192585545)
• Dodano: TextFieldDecorationBox i OutlinedTextFieldDecorationBox. Używanie ich razem z BasicTextFieldpomoże Ci utworzyć niestandardowe pole tekstowe oparte na polach tekstowych Material Design, ale z większą liczbą opcji dostosowywania.
• Dodaliśmy możliwość dostosowywania dopełnienia poziomego i pionowego w polach tekstowych. (I8c9f1, b/203764564, b/191543915, b/189971673, b/183136600, b/179882597, b/168003617)

• Dodano adnotacje ComposableTarget, ComposableTargetMarker i ComposableOpenTarget, które umożliwiają zgłaszanie w czasie kompilacji, kiedy funkcja typu „composable” jest wywoływana w sposób, który nie jest zgodny z jej przeznaczeniem.

  W większości przypadków adnotacje te mogą być wywnioskowane przez wtyczkę kompilatora Compose, więc bezpośrednie używanie tych adnotacji powinno być rzadkie . Nie można wywnioskować przypadków, w których tworzy się i używa niestandardowego aplikatora, abstrakcyjnych funkcji kompozycyjnych (takich jak metody interfejsu), pól lub zmiennych globalnych, które są kompozycyjnymi wyrażeniami lambda (zmienne lokalne i parametry są wywnioskowane), lub gdy używa się funkcji ComposeNode lub powiązanych funkcji kompozycyjnych.

  W przypadku niestandardowych funkcji stosujących funkcje kompozycyjne, które wywołują ComposeNode lub ReusableComposeNode, należy dodać adnotację CompoableTarget do funkcji i wszystkich typów parametrów lambda kompozycyjnych. Zalecamy jednak utworzenie adnotacji oznaczonej symbolem ComposableTargetMarker, a następnie użycie tej adnotacji zamiast symbolu ComposableTarget. Adnotacja kompozycyjna oznaczona symbolem ComposableTargetMarker jest równoważna adnotacji ComposbleTarget z pełną i jednoznaczną nazwą klasy atrybutu jako parametrem applier. Przykład użycia elementu ComposableTargetMarker znajdziesz w sekcji anroidx.compose.ui.UiComposable. (I38f11)

Wersja 1.2.0-alpha03

9 lutego 2022 r.

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

Poprawki błędów

• Przykładowa dodana grupa elementów (I97080, b/192585545)

Wersja 1.2.0-alpha02

26 stycznia 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha02 Wersja 1.2.0-alpha02 zawiera te zmiany.

Zmiany w interfejsie API

• Dodaliśmy NonRestartableComposable do metod, które są przeciążeniami istniejących metod bez złożonej logiki. Zmniejsza to liczbę sprawdzania przez kompilator zapamiętywania (równości) wszystkich parametrów, które powtarzają się w wywoływanej funkcji wewnętrznej. (I90490)
• Dodanie obsługi elementu działania (I07100, b/192585545)

Wersja 1.2.0-alpha01

12 stycznia 2022 r.

Publikacja androidx.compose.material:material-*:1.2.0-alpha01 Wersja 1.2.0-alpha01 zawiera te zmiany.

Aktualizacje zależności

• Teraz zależy od Kotlin 1.6.10.

Wkład zewnętrzny

• ModalBottomSheetState ma teraz flagę isSkipHalfExpanded. Można ją ustawić za pomocą konstruktora lub zaktualizować później, ustawiając właściwość isSkipHalfExpanded obiektu ModalBottomSheetState na wartość true. Aktualizacja wartości isSkipHalfExpanded powoduje ponowne skomponowanie arkusza. (I18b86, b/186669820)

Wersja 1.1

Wersja 1.1.1

23 lutego 2022 r.

Publikacja androidx.compose.material:material-*:1.1.1 Wersja 1.1.1 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązanie problemu NullPointerException na stronie androidx.compose.ui.platform.RenderNodeLayer.updateDisplayList (aosp/1947059, b/206677462)
• Rozwiązaliśmy problem z awarią spowodowaną przez zawartość schowka podczas odczytu ze schowka na Androidzie. (I06020, b/197769306)
• Poprawiono układ od prawej do lewej w LazyVerticalGrid (aosp/1931080, b/207510535)

Wersja 1.1.0

9 lutego 2022 r.

Publikacja androidx.compose.material:material-*:1.1.0 Wersja 1.1.0 zawiera te zmiany.

Ważne zmiany od wersji 1.0.0

• Stabilna obsługa efektu przewijania w Androidzie 12
• Ulepszenia rozmiaru obszaru dotykowego
• Pamiętaj, że w przypadku Compose 1.0 komponenty Material rozszerzą swój obszar układu, aby spełnić wytyczne dotyczące ułatwień dostępu w interfejsie Material w zakresie rozmiaru docelowego elementu dotykowego. Na przykład docelowy element dotykowy przycisku zostanie powiększony do minimalnego rozmiaru 48x48 dp, nawet jeśli ustawisz mniejszy rozmiar przycisku. Dzięki temu biblioteka Compose Material zachowuje się tak samo jak komponenty Material Design, co zapewnia spójne działanie, jeśli używasz widoków i biblioteki Compose. Ta zmiana zapewnia też, że gdy tworzysz interfejs za pomocą komponentów Compose Material, spełnione zostaną minimalne wymagania dotyczące dostępności docelowych elementów dotykowych.
• Stabilna obsługa kolumny nawigacji
• Przekształca kilka eksperymentalnych interfejsów API w stabilne.
• Obsługa nowszych wersji języka Kotlin

Wersja 1.1.0-rc03

26 stycznia 2022 r.

Publikacja androidx.compose.material:material-*:1.1.0-rc03 Wersja 1.1.0-rc03 zawiera te zatwierdzenia.

Zmiany w działaniu

Pamiętaj, że w przypadku Compose 1.0 komponenty Material rozszerzą swój obszar układu, aby spełnić wymagania dotyczące rozmiaru docelowego elementu dotykowego określone w wytycznych dotyczących ułatwień dostępu. Na przykład docelowy element dotykowy przycisku zostanie powiększony do minimalnego rozmiaru 48x48 dp, nawet jeśli ustawisz mniejszy rozmiar przycisku. Dzięki temu biblioteka Compose Material zachowuje się tak samo jak komponenty Material Design, co zapewnia spójne działanie, jeśli używasz widoków i biblioteki Compose. Ta zmiana zapewnia też, że gdy tworzysz interfejs za pomocą komponentów Compose Material, spełnione zostaną minimalne wymagania dotyczące dostępności docelowych elementów dotykowych.

Poprawki błędów

• Dodano lepsze informacje do debugowania w inspektorze układu podczas sprawdzania modyfikatorów minimalnego obszaru docelowego dotknięcia. (aosp/1955036)

Wersja 1.1.0-rc01

15 grudnia 2021 roku

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

Poprawki błędów

• Poprawienie promienia zaokrąglenia stosowanego w przypadku Checkboxes (I38b03, b/175198975, b/202309440)

Wersja 1.1.0-beta04

1 grudnia 2021 r.

Publikacja androidx.compose.material:material-*:1.1.0-beta04 Wersja 1.1.0-beta04 zawiera te zmiany.

Nowe funkcje

• Zaktualizowano, aby była zgodna z Kotlinem 1.6.0

Wersja 1.1.0-beta03

17 listopada 2021 r.

Publikacja androidx.compose.material:material-*:1.1.0-beta03 Wersja 1.1.0-beta03 zawiera te zmiany.

Wersja 1.1.0-beta02

3 listopada 2021 r.

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

Poprawki błędów

• Efekty falowania i inne wskaźniki będą teraz opóźniane tylko wtedy, gdy znajdują się w kontenerze Modifier.scrollable(), a nie zawsze w przypadku zdarzenia naciśnięcia. (Ibefe0, b/203141462)

Wersja 1.1.0-beta01

27 października 2021 roku

Publikacja androidx.compose.material:material-*:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Nowe funkcje

• Efekty falowania obsługują teraz stany najechania kursorem i aktywacji, więc najechanie kursorem lub aktywowanie komponentu, takiego jak przycisk, spowoduje wyświetlenie prawidłowej nakładki stanu.

Wersja 1.1.0-alpha06

13 października 2021 r.

Publikacja androidx.compose.material:material-*:1.1.0-alpha06 Wersja 1.1.0-alpha06 zawiera te zmiany.

Zmiany w interfejsie API

• Dodano przeciążenie bez elementów podrzędnych dla układu, co zwiększa wydajność (Ib0d9a).
• Implementacja ExposedDropdownMenu na podstawie ExposedDropdownMenuBox z elementami TextField i DropdownMenu wewnątrz (If60b2)
• Do usługi PopupProperties dodano usługę dismissOnOutsideClick, która zastąpiła wycofaną usługę dismissOnClickOutside. Nowa właściwość otrzymuje pozycję kliknięcia i granice elementu zakotwiczonego, co zapewnia większą kontrolę nad tym, czy należy wywołać funkcję onDismissRequest. Może to być przydatne np. w zapobieganiu zamykaniu kotwicy w przypadku dotknięcia jej.
  • Do PopupProperties dodano updateAndroidWindowManagerFlags, co zapewnia niskopoziomową kontrolę nad flagami przekazywanymi przez wyskakujące okienko do Menedżera okien Androida. Parametrem funkcji lambda będą flagi obliczone na podstawie wartości PopupProperties, które powodują powstanie flag WindowManager, np. focusable. Wynikiem funkcji lambda będą ostateczne flagi, które zostaną przekazane do menedżera okien Androida. Domyślnie funkcja updateAndroidWindowManagerFlags pozostawia flagi obliczone na podstawie parametrów bez zmian. Tego interfejsu API należy używać ostrożnie, tylko w przypadkach, gdy wyskakujące okienko ma bardzo specyficzne wymagania dotyczące działania. (I6e9f9)

Wersja 1.1.0-alpha05

29 września 2021 r.

Publikacja androidx.compose.material:material-*:1.1.0-alpha05 Wersja 1.1.0-alpha05 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaje minimalny rozmiar docelowego elementu dotykowego w przypadku komponentów Material, które nie mają dostępnego docelowego elementu dotykowego. Dodaje to dodatkowe odstępy wokół komponentów, aby zapewnić im wystarczająco duży docelowy obszar dotykowy. Może to zmienić istniejące interfejsy, które zakładają, że rozmiar tych komponentów jest ich rozmiarem wizualnym i nie uwzględniają rozmiaru docelowego obszaru dotykowego. Możesz użyć eksperymentalnego elementu LocalMinimumTouchTargetEnforcement CompositionLocal, aby wyłączyć to zachowanie w całej hierarchii, ale ma to być tylko tymczasowe rozwiązanie, dopóki nie zaktualizujesz istniejących interfejsów, aby uwzględniały nowy minimalny rozmiar. (I9b966, b/149691127, b/171509422)
• Dodaliśmy eksperymentalny interfejs TextFieldColorsWithIcons, który rozszerza TextFieldColors, aby udostępniać InteractionSource do leadingColor i trailingColor. Umożliwia to modyfikowanie wyglądu elementu TextField w zależności od stanu zaznaczenia. (I66923, b/198402662)

Wersja 1.1.0-alpha04

15 września 2021 r.

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

Zmiany w interfejsie API

• Wycofano funkcje performGesture i GestureScope, które zostały zastąpione przez funkcje performTouchInput i TouchInjectionScope. (Ia5f3f, b/190493367)
• Dodano zakres od touchBoundsInRoot do SemanticsNode, który obejmuje minimalny rozmiar docelowego elementu dotykowego, aby deweloperzy mogli mieć pewność, że docelowe elementy dotykowe spełniają minimalne wymagania dotyczące ułatwień dostępu. (I2e14b, b/197751214)

Poprawki błędów

• Zezwalaj na rozszerzanie granic docelowego obszaru kliknięcia poza region przycinania na potrzeby minimalnego docelowego obszaru kliknięcia. (I43e10, b/171509422)
• Zaktualizowano element kompozycyjny Divider, aby uwzględniał parametr Dp.Hairline dotyczący grubości, co umożliwia rysowanie separatorów o szerokości 1 piksela niezależnie od gęstości wyświetlacza. (I16ffb, b/196840810)

Wersja 1.1.0-alpha03

1 września 2021 roku

Publikacja androidx.compose.material:material-*:1.1.0-alpha03 Wersja 1.1.0-alpha03 zawiera te zmiany.

Nowe funkcje

• Zaktualizowano 1.1.0-alpha03 Compose, aby zależał od Kotlin 1.5.30. (I74545)

Zmiany w interfejsie API

• Dodano metodę testową, aby uzyskać przycięte granice. (I6b28e)
• Dodano minimalny rozmiar docelowego elementu dotykowego do ViewConfiguration, aby można go było używać w semantyce i w przypadku danych wejściowych wskaźnika, co zapewnia dostępność. (Ie861c)

Wersja 1.1.0-alpha02

18 sierpnia 2021 r.

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

Wkład zewnętrzny

• Naprawiliśmy działanie elementu SwipeableState w sytuacji, gdy przesunięcie przesunięcia mieści się w granicach błędu zaokrąglenia kotwicy. (I03d39, b/191993377)

Wersja 1.1.0-alpha01

4 sierpnia 2021 r.

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

Zmiany w interfejsie API

• Zaktualizowana metoda DrawScope#drawImage, która wykorzystuje prostokąty źródłowe i docelowe, aby wykorzystać opcjonalny parametr FilterQuality. Jest to przydatne w przypadku grafiki pikselowej, która ma być pikselowana po powiększeniu. Zaktualizowano funkcję BitmapPainter i kompozycję Image, aby korzystały też z opcjonalnego parametru FilterQuality (Ie4fb0, b/180311607)
• Zmiana nazwy BadgeBox na BadgedBox, zmiana parametrów w celu akceptowania komponentu Badge. Dodano komponent Badge, który jest typową treścią plakietki w komponencie BadgedBox. (I639c6)
• Dodano komponent NavigationRail. Informacje o sposobie użycia znajdziesz w dokumentacji i przykładach (I8de77).

Poprawki błędów

• Dodano przykład kolumny nawigacji wyrównanej do dołu i aplikację katalogową demo. (I3cffc)
• Okna dialogowe są teraz dopasowywane do rozmiaru platformy. Aby zastąpić to działanie, ustaw usePlatformDefaultWidth na false. (Iffaed, b/192682388)
• Dodaliśmy do aplikacji katalogu wersję demonstracyjną paska nawigacyjnego. (I04960)
• Dodaliśmy do aplikacji katalogu wersję demonstracyjną plakietki. (If285d)

Wersja 1.0

Wersja 1.0.5

3 listopada 2021 r.

Publikacja androidx.compose.material:material-*:1.0.5 Wersja 1.0.5 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiliśmy awarię śledzenia instancji derivedStateOf. (aosp/1792247)

Wersja 1.0.4

13 października 2021 r.

Publikacja androidx.compose.material:material-*:1.0.4 Wersja 1.0.4 zawiera te zatwierdzenia.

Aktualizacje zależności

• Zaktualizowano, aby zależał od Kotlin 1.5.31

Wersja 1.0.3

29 września 2021 r.

Publikacja androidx.compose.material:material-*:1.0.3 Wersja 1.0.3 zawiera te zatwierdzenia.

Aktualizacje zależności

• Zaktualizowano, aby zależał od Kotlin 1.5.30

Wersja 1.0.2

1 września 2021 roku

Publikacja androidx.compose.material:material-*:1.0.2 Wersja 1.0.2 zawiera te zatwierdzenia.

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

Wersja 1.0.1

4 sierpnia 2021 r.

Publikacja androidx.compose.material:material-*:1.0.1 Wersja 1.0.1 zawiera te zatwierdzenia.

Aktualizacje zależności

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

Wersja 1.0.0

28 lipca 2021 roku

Publikacja androidx.compose.material:material-*:1.0.0 Wersja 1.0.0 zawiera te zatwierdzenia.

Główne funkcje wersji 1.0.0

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

Znane problemy

• Jeśli używasz Androida Studio Bumblebee Canary 4 lub AGP 7.1.0-alpha04/7.1.0-alpha05, może wystąpić ten błąd:

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

  Aby to naprawić, tymczasowo zwiększ wartość parametru minSdkVersion do 24 lub wyższej w pliku build.gradle. Ten problem zostanie rozwiązany w kolejnej wersji Androida Studio Bumblebee i AGP 7.1. (b/194289155)

Wersja 1.0.0-rc02

14 lipca 2021 roku

Publikacja androidx.compose.material:material-*:1.0.0-rc02 Wersja 1.0.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

• Okna dialogowe są teraz dopasowywane do rozmiaru platformy. Aby zastąpić to działanie, ustaw wartość usePlatformDefaultWidth na false. (Iffaed, b/192682388)

Wersja 1.0.0-rc01

1 lipca 2021 r.

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

Zmiany w interfejsie API

• Dodano komponent BadgeBox. Informacje o jego użyciu znajdziesz w dokumentacji i przykładach (I5e284).
• Nazwa elementu useDefaultMaxWidth w PopupProperties została zmieniona na usePlatformDefaultWidth. (I05710)
• Okna dialogowe mogą teraz korzystać z całej szerokości ekranu. (I83929, b/190810877)
• Dodano eksperymentalną implementację suwaka zakresu (I2f4b3)

Poprawki błędów

• Aby zachować zgodność ze specyfikacjami Material Design, w przypadku komponentu OutlinedTextField z nieprawidłowym wpisem przestaliśmy używać koloru błędu dla etykiety, gdy jest ona używana jako obiekt zastępczy. Jest to prawdą, gdy w polu tekstowym nie ma tekstu wejściowego i pole tekstowe nie jest zaznaczone. Wraz z tą zmianą zmieniło się też znaczenie parametru error:Boolean w funkcji TextFieldColors.labelColor(): będzie ona teraz zwracać wartość false nawet wtedy, gdy dane wejściowe są nieprawidłowe, jeśli etykieta jest używana jako symbol zastępczy. (I45f78)

Wersja 1.0.0-beta09

16 czerwca 2021 r.

Publikacja androidx.compose.material:material-*:1.0.0-beta09 Wersja 1.0.0-beta09 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano parametr Shape do komponentu OutlinedTextField, aby można było dostosować kształt obramowania (I8f39e, b/181322957).
• TextOverflow jest zmieniany na klasę wbudowaną. (I433af)

Poprawki błędów

• Scrim w komponentach BottomDrawer, BackdropScaffold i ModalBottomSheetLayout zniknie, gdy zostanie przekazany Color.Unspecified (I2d899, b/182063309)

Dodane reguły profilu

W tej wersji dodaliśmy reguły profilu do tych modułów kompozycji (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

Czym są reguły profilu?

• Reguły profilu dla biblioteki są określone w pliku tekstowym baseline-prof.txt znajdującym się w katalogu src/main lub w odpowiednim katalogu. Plik zawiera regułę w każdym wierszu. W tym przypadku reguła jest wzorcem dopasowywanym do metod lub klas w bibliotece. Składnia tych reguł jest nadzbiorem formatu profilu ART czytelnego dla człowieka, który jest używany podczas korzystania z adb shell profman --dump-classes-and-methods .... Reguły te przyjmują jedną z 2 form, aby kierować reklamy na metody lub klasy.

• Reguła metody będzie mieć ten wzorzec:

  <FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
  

• Reguła klasy będzie miała następujący wzorzec:

  <CLASS_DESCRIPTOR>
  

• W tym przypadku <FLAGS> to co najmniej jeden z tych znaków: H, S i P. Wskazuje on, czy ta metoda powinna być oznaczona jako „Hot”, „Startup” lub „Post Startup”.

• <CLASS_DESCRIPTOR> to deskryptor klasy, do której należy kierowana metoda. Na przykład klasa androidx.compose.runtime.SlotTable będzie miała deskryptor Landroidx/compose/runtime/SlotTable;.

• Symbol <METHOD_SIGNATURE> to sygnatura metody, która zawiera jej nazwę, typy parametrów i typy zwracanych wartości. Na przykład metoda fun isPlaced(): Boolean w LayoutNode ma sygnaturę isPlaced()Z.

• Wzorce mogą zawierać symbole wieloznaczne (**, * i ?), dzięki czemu jedna reguła może obejmować wiele metod lub klas.

Do czego służą reguły?

• Metoda oznaczona flagą H jest „gorącą” metodą i powinna zostać skompilowana z wyprzedzeniem.

• Metoda oznaczona flagą S jest wywoływana podczas uruchamiania i powinna być skompilowana z wyprzedzeniem, aby uniknąć kosztów kompilacji i interpretacji w momencie uruchamiania.

• Metoda oznaczona flagą P jest wywoływana po uruchomieniu.

• Klasa obecna w tym pliku wskazuje, że jest używana podczas uruchamiania i powinna być wstępnie przydzielona w stercie, aby uniknąć kosztów ładowania klasy.

Jak to działa?

• Biblioteki mogą definiować te reguły, które będą pakowane w artefakty AAR. Gdy zostanie utworzony plik APK zawierający te artefakty, reguły zostaną połączone, a połączone reguły zostaną użyte do utworzenia kompaktowego binarnego profilu ART, który jest specyficzny dla pliku APK. ART może następnie wykorzystać ten profil podczas instalowania pliku APK na urządzeniach, aby skompilować z wyprzedzeniem określony podzbiór aplikacji i zwiększyć jej wydajność, zwłaszcza podczas pierwszego uruchomienia. Nie będzie to miało wpływu na aplikacje, które można debugować.

Wersja 1.0.0-beta08

2 czerwca 2021 r.

Publikacja androidx.compose.material:material-*:1.0.0-beta08 Wersja 1.0.0-beta08 zawiera te zatwierdzenia.

Nowe funkcje

Zmiana w interfejsie API, która może wpłynąć na działanie

• ZMIANA ZACHOWANIA: komponent Card teraz obsługuje kliknięcia, co sprawia, że kliknięcia dodane za pomocą Card(Modifier.clickable) nie mają żadnego efektu. Użyj nowego eksperymentalnego przeciążenia komponentu Card, które akceptuje onClick. (Ia8744, b/183775620)
  • Dodano nowe przeciążenie karty, które obsługuje kliknięcia oraz inne funkcje klikania: wskazanie, źródło interakcji, włączanie i wyłączanie. Nie można było użyć zwykłej karty bez możliwości kliknięcia z elementem Modifier.clickable, ponieważ w takich przypadkach karta nie przycina efektu rozchodzenia się fali.
• ZMIANA ZACHOWANIA: komponent Surface wykorzystuje teraz kliknięcia, co sprawia, że kliknięcia dodane za pomocą Surface(Modifier.clickable) nie mają żadnego efektu. Używaj nowej eksperymentalnej wersji komponentu Surface, która akceptuje onClick. (I73e6c, b/183775620)
  • Dodano nowe przeciążenie Surface, które obsługuje kliknięcia i inne funkcje klikalne: wskazanie, interactionSource, włączone/wyłączone. Nie można było użyć zwykłej, nieklikanej powierzchni z elementem Modifier.clickable, ponieważ w takich przypadkach nie będzie ona przycinać efektu rozchodzenia się fali.

Zmiany w interfejsie API

• FabPosition został przekształcony w klasę wbudowaną z wyliczenia, aby umożliwić potencjalne rozszerzenie w przyszłości (I030fb).
• Zmieniono sposób używania wyliczeń na klasy wbudowane, aby uniknąć problemów z wyczerpującymi instrukcjami „when” po dodaniu nowych wartości wyliczenia. (I2b5eb)
• Dodaje limit czasu kliknięcia do elementów klikalnych i przełączalnych, aby zapobiec wyświetlaniu efektu fali podczas przewijania lub przeciągania (Ia2704, b/168524931).
• Właściwości semantyczne ContentDescription i Text nie są już pojedynczymi wartościami, ale listami. Dzięki temu można je scalić w takiej postaci, w jakiej są, zamiast je łączyć. Udostępniliśmy też lepsze interfejsy API do testowania, które pozwalają wykorzystać te zmiany (Ica6bf, b/184825850).
• Środowisko wykonawcze Modifier.focusModifier() zostało wycofane i zastąpione środowiskiem Modifier.focusTarget() (I6c860)
• Zastąpiono wyliczenie FocusState interfejsem FocusState (Iccc1a, b/187055290).
• Usunięto LocalRippleNativeRendering, ponieważ implementacja efektu fali opartego na widoku jest stabilna (I7fab3, b/188569367)

Poprawki błędów

• Modifier.onGloballyPositioned() została zmieniona, aby raportować współrzędne tego modyfikatora w łańcuchu modyfikatorów, a nie współrzędne układu po zastosowaniu wszystkich modyfikatorów. Oznacza to, że kolejność modyfikatorów wpływa teraz na to, jakie współrzędne będą raportowane. (Ieb67d, b/177926591)
• Dodaliśmy plik README do istniejącego katalogu komponentów Material w Compose. (If9191)

Wersja 1.0.0-beta07

18 maja 2021 r.

Publikacja androidx.compose.material:material-*:1.0.0-beta07 Wersja 1.0.0-beta07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Nie musisz już używać metod rozszerzających do obsługi tras w Navigation Compose. (I22beb, b/172823546)

Wersja 1.0.0-beta06

5 maja 2021 roku

Publikacja androidx.compose.material:material-*:1.0.0-beta06 Wersja 1.0.0-beta06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Ripple zostało przeniesione do wewnętrznego korzystania z RippleDrawable na urządzeniach z Androidem. Oznacza to, że animacje rozchodzenia się fali będą wykonywane w wątku renderowania, a więc będą płynne nawet wtedy, gdy wątek interfejsu będzie obciążony, np. podczas przechodzenia między ekranami. Nie zmienia to interfejsu API efektu fali, ale w wyniku tej zmiany mogą wystąpić zmiany w jego działaniu. Aby ułatwić migrację, dodano LocalRippleNativeRendering. W przypadku tego elementu CompositionLocal podaj wartość false, aby w ramach elementu CompositionLocalProvider wrócić do poprzedniej implementacji efektu falowania. Ten interfejs API jest tymczasowy i zostanie w przyszłości usunięty, więc jeśli napotkasz problemy, które spowodują, że będziesz musiał go użyć, zgłoś błąd. (I902f8, b/168777351, b/183019123)
• Dodano interfejsy API ułatwień dostępu CollectionInfo i CollectionItemInfo, które umożliwiają oznaczanie kolekcji i jej elementów dla usług ułatwień dostępu (Id54ef, b/180479017).
• Dodano interfejs API ułatwień dostępu error, który umożliwia oznaczanie węzła zawierającego nieprawidłowe dane wejściowe (I12997, b/180584804, b/182142737).

Poprawki błędów

• Zaktualizowano implementację wstawek katalogu Compose Material z: https://github.com/google/accompanist/pull/365. (I25dc3)
• Elementy podrzędne Row i Column z atrybutem weight(fill = false) nie powodują już, że element nadrzędny wypełnia całą dostępną przestrzeń osi głównej. (Ied94d, b/186012444, b/184355105)

Wersja 1.0.0-beta05

21 kwietnia 2021 r.

Publikacja androidx.compose.material:material-*:1.0.0-beta05 Wersja 1.0.0-beta05 zawiera te zatwierdzenia.

Poprawki błędów

• Dodaliśmy do istniejącego katalogu Compose Material obrazy kafelków komponentów, selektor motywów i bardziej szczegółowe adresy URL menu. (I9b58e)

Wersja 1.0.0-beta04

7 kwietnia 2021 r.

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

Zmiany w interfejsie API

• ZMIANA API: DrawerState stan nie rozszerza już eksperymentalnego stanu SwipeableState.
  • ZMIANA INTERFEJSU API: interfejs BottomDrawerState został oznaczony jako eksperymentalny, aby pasował do komponentu BottomDrawer, który jest już eksperymentalny (I81114, b/181656094)
• Zmiana nazw hideSoftwareKeyboard i showSoftwareKeyboard na hide() i show() w SoftwareKeyboardController.
  • Udostępnia pełny interfejs CompositionLocal dla LocalSoftwareKeyboardController, co umożliwia jego ustawienie (szczególnie przydatne w testach) (I579a6).
• Dodano interfejs API ułatwień dostępu LiveRegion. Jeśli węzeł jest oznaczony jako aktywny region, usługi ułatwień dostępu automatycznie powiadomią użytkownika o jego zmianach (Idcf6f, b/172590946).

Poprawki błędów

• Dodano implementację katalogu Compose Material do istniejącego modułu. Obecnie brakuje: obrazów kafelków komponentów, selektora motywów (zostanie dodany w ramach kolejnych zmian). (Ie7a94)

Wersja 1.0.0-beta03

24 marca 2021 r.

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

Zmiany w interfejsie API

• Środowisko wykonawcze DefaultMonotonicFrameClock zostało wycofane. Wywołanie funkcji Calling withFrameNanos lub Recomposer.runRecomposeAndApplyChanges bez MonotonicFrameClock spowoduje teraz zgłoszenie wyjątku IllegalStateException. (I4eb0d)
• Dodaliśmy nowy interfejs API LeadingIconTab, który umożliwia wyświetlanie ikony i tekstu w karcie. (I23267)

Wkład zewnętrzny

• [by Jossi Wolf] BottomDrawer teraz otacza zawartość miejsca na szufladę. BottomDrawer nie zgłasza błędu IllegalStateException, gdy element nadrzędny ma nieskończoną wysokość. Jeśli dolny panel jest mniejszy niż 50% panelu nadrzędnego, otworzy się w stanie rozwiniętym. Dokumenty dotyczące BottomDrawerState i ModalBottomSheetLayoutState zostały zaktualizowane. BottomDrawerState#isOpen zwraca teraz wartość „prawda”, jeśli jest w stanie otwartym lub rozwiniętym. (I87241)

Wersja 1.0.0-beta02

10 marca 2021 r.

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

Zmiany w interfejsie API

• Dodano nowy lokalny interfejs API LocalSoftwareKeyboardControllercomposition localSoftwareKeyboardController, który zastępuje poprzedni interfejs SoftwareKeyboardController w polu TextField. (I5951e, b/168778053)

Poprawki błędów

• Wymuszanie ograniczeń dotyczących publicznego korzystania z eksperymentalnych interfejsów API (I6aa29, b/174531520)
• Zmieniono domyślne wyrównanie w poziomie w przypadku komponentów TopAppBar i BottomAppBar na „Start”, zgodnie z komponentem Row (Ib2dc7).
• Dodano nowy moduł i interfejs zastępczy dla katalogu Compose Material, który jest obecnie zagnieżdżony w istniejących wersjach demonstracyjnych testów integracyjnych. (Idfcb3)
• androidx.compose.ui:ui nie zależy już od AppCompat ani Fragment. Jeśli w aplikacji używasz elementu ComposeView oraz komponentów Fragment lub AppCompat, upewnij się, że korzystasz z AppCompat w wersji 1.3 lub nowszej albo z Fragment w wersji 1.3 lub nowszej. Te wersje są potrzebne do prawidłowego ustawienia właścicieli cyklu życia i zapisanego stanu wymaganych w przypadku elementu ComposeView. (I1d6fa, b/161814404)

Wersja 1.0.0-beta01

24 lutego 2021 r.

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

To pierwsza wersja Compose 1.0.0 w wersji beta.

Zmiany w interfejsie API

• Zmieniliśmy nazwy modyfikatorów rozmiaru. Zmieniono nazwy modyfikatorów Modifier.width/height/size na requiredWidth/requiredHeight/requiredSize. Zmieniono nazwy modyfikatorów Modifier.preferredWidth/preferredHeight/preferredSize na width/height/size. (I5b414)
• imageResource i vectorResource są teraz funkcjami rozszerzającymi odpowiednio elementy ImageBitmap i ImageVector. Funkcje load{Image,Vector,Font}Resource zostały usunięte. (I89130)
• Modyfikatory rozmiaru do rozmiarów wewnętrznych nie są już eksperymentalne. (I15744)
• Usunięto asercje dp (I798d2)
• Usunięto wywołanie zwrotne SoftwareKeyboardController ze wszystkich pól tekstowych. Wkrótce zostanie ono zastąpione nowym interfejsem API. (Iae869, b/168778053)
• Funkcje lambda działań Switch, Checkbox i RadioButton mogą teraz przyjmować wartość null. Przykłady pól wyboru w wierszu z możliwością kliknięcia zostały zaktualizowane, aby korzystać z tej funkcji. (If601b, b/171819073)
• InteractionState zostało zastąpione przez [Mutable]InteractionSource
  • Interfejsy odpowiadają za wysyłanie i zbieranie zdarzeń interakcji.
  • Zamiast przekazywać wartość interactionState = remember { InteractionState() } do komponentów takich jak Button i Modifier.clickable(), użyj wartości interactionSource = remember { MutableInteractionSource() }.
  • Zamiast: Interaction.Pressed in interactionState używaj funkcji rozszerzających w obiekcie InteractionSource, np. InteractionSource.collectIsPressedAsState().
  • W przypadku złożonych przypadków użycia możesz użyć InteractionSource.interactions, aby obserwować strumień interakcji. Więcej informacji znajdziesz w dokumentacji i przykładach dotyczących InteractionSource.
  • (I85965, b/152525426, b/171913923, b/171710801, b/174852378)
• Dodanie interfejsu AccessibilityMananger i LocalAccessibilityMananger do CompositionLocals (I53520)
• Usunięto przestarzałe metody LayoutCoordinates. Zamiast właściwości positionInParent i boundsInParent używaj funkcji (I580ed, b/169874631, b/175142755)
• Suwak obsługuje teraz stan włączony/wyłączony (I6d56b, b/179793072)
• Utworzono nową klasę TextInputSession dla sesji wprowadzania danych z komponentów tekstowych niskiego poziomu, takich jak CoreTextField. (I8817f, b/177662148)
• Usunięto AnimationEndReason.Interrupted. Jeśli animacja zostanie przerwana, zostanie zgłoszony wyjątek CancellationException. (I2cbbc, b/179695417)
• Usunięto @ExperimentalRippleApi i zmieniono RippleAlpha na klasę z właściwościami zamiast interfejsu. (I6df7c)
• Dodano interfejs TextFieldColors, który reprezentuje różne kolory używane w polach TextField i OutlinedTextField w różnych stanach. W przypadku domyślnej implementacji zobacz TextFieldDefaults.textFieldColors i TextFieldDefaults.outlinedTextFieldColors.
  • Zmiana nazwy parametru isErrorValue w elementach TextField i OutlinedTextField na isError. (I831f9, b/171305338, b/168004067)
• Dodanie modyfikatora selectionGroup, który umożliwia oznaczanie kolekcji kart lub przycisków opcji na potrzeby ułatwień dostępu (Ie5c29).

• Dodanie funkcji LazyListState.animateScrollToItem

  Ta metoda umożliwia płynne przewijanie do określonego elementu na liście. (I4bfd7)

• Zmieniono nazwę ScrollableState.smoothScrollBy() na animateScrollBy() Zmieniono nazwę LazyListState.snapToItemIndex() na scrollToItem() Zmieniono nazwę ScrollState.smoothScrollTo() na animateScrollTo() (I35ded)

• Wszystkie funkcje kompozycyjne oznaczone symbolem @ReadOnlyComposable są teraz weryfikowane w czasie kompilacji, aby mieć pewność, że wywołują tylko inne funkcje kompozycyjne oznaczone symbolem @ReadOnlyComposables (I58961).

• Interfejs TargetAnimation API został usunięty. (If47d1, b/177457083)

• Pozycja przewijania w funkcjach Modifier.verticalScroll()/horizontalScroll() jest teraz reprezentowana przez liczby całkowite (I81298).

• Pakiety metod smoothScrollBy i scrollBy zostały zmienione na androidx.compose.foundation.gestures.* (I3f7c1, b/175294473)

• Klasa FlingConfig została zmieniona na FlingBehavior i umożliwia teraz dostosowywanie animacji zawieszenia zamiast wstępnie zdefiniowanych zanikań. (I02b86, b/175294473)

• Zmieniliśmy nazwy modyfikatorów rozmiaru. Zmieniono nazwy modyfikatorów Modifier.width/height/size na requiredWidth/requiredHeight/requiredSize. Zmieniono nazwy modyfikatorów Modifier.preferredWidth/preferredHeight/preferredSize na width/height/size. (I5b414)

• Zmieniliśmy nazwę parametru defaultMinSizeConstraints na defaultMinSize. (I4eaae)

• Szkolenie zostało przeniesione do pakietu podstawowego. Klasa VelocirtTracker została przeniesiona z ui.gesture do ui.input.pointer. (Iff4a8, b/175294473)

• Funkcje drawerState.open() i drawerState.close() są teraz funkcjami zawieszającymi. Aby uzyskać zakres kompozycji i wywołać te funkcje, użyj funkcji rememberCoroutineScope() (I16f60, b/175294473).

• Element Providers został zmieniony na CompositionLocalProvider

  • Konstruktor Composition nie akceptuje już parametru key i został wycofany.
  • currentCompositeKeyHash został przekształcony w właściwość najwyższego poziomu typu „composable”, a nie w funkcję najwyższego poziomu typu „composable”.
  • Klasy CompositionData i CompositionGroup zostały przeniesione do przestrzeni nazw androidx.compose.runtime.tooling
  • Funkcja ComposableLambda stała się interfejsem zamiast konkretnej klasy i nie ma już parametrów typu.
  • ComposableLambdaN stał się interfejsem zamiast klasy konkretnej i nie ma już parametrów typu.
  • Funkcja snapshotFlow została przeniesiona do przestrzeni nazw androidx.compose.runtime
  • metoda scalania SnapshotMutationPolicy nie jest już eksperymentalna;
  • Usunęliśmy 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.
  • Usunięto metody isJoinedKey, joinedKeyLeft i joinedKeyRight. 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 języku Kotlin 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)

• Zmodyfikowano element Modifier.scrollable. Teraz zamiast klasy ScrollableController używa interfejsu Scrollable (I4f5a5, b/174485541, b/175294473).

• Funkcja Modifier.draggable akceptuje teraz DraggableState zamiast zwykłej funkcji lambda. Stan możesz utworzyć za pomocą rememberDraggableState { delta -> }, aby uzyskać takie samo działanie jak wcześniej (Ica70f, b/175294473).

• Funkcje ZoomableController.smoothScaleBy i ZoomableController.stopAnimation są teraz funkcjami zawieszania. (I7f970, b/177457083)

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

• Wprowadziliśmy te zmiany w interfejsie Material API:

  • Dodano parametr contentPadding do komponentów TopAppBar i BottomAppBar, aby umożliwić dostosowywanie domyślnego dopełnienia.
  • Zmieniono kolejność parametrów w komponencie BackdropScaffold, aby była zgodna z wytycznymi interfejsu API, zgodnie z którymi parametry wymagane powinny występować przed parametrami opcjonalnymi.
  • Parametr icon w elemencie BottomNavigationItem został przeniesiony i jest teraz po parametrach selected i onClick.
  • Zmieniono nazwę parametru alwaysShowLabels w elemencie BottomNavigationItem na alwaysShowLabel.
  • W kilku komponentach zmieniliśmy nazwy parametrów bodyContent na content.
  • Zmieniono kolejność parametrów w zdarzeniu ButtonDefaults.buttonColors(). Pamiętaj, że typ parametrów nie uległ zmianie, więc nie spowoduje to błędu w kodzie. Upewnij się, że używasz nazwanych parametrów lub ręcznie zaktualizuj kolejność, w przeciwnym razie kod nie będzie działać tak jak wcześniej.
  • Dodano parametr secondaryVariant do elementu darkColors(). Ten kolor jest zwykle taki sam jak secondary w ciemnym motywie, ale dodajemy go, aby zapewnić spójność i umożliwić dalsze dostosowywanie.
  • Usunęliśmy z publicznego interfejsu API funkcje ElevationDefaults i animateElevation(), ponieważ nie były one powszechnie używane ani przydatne.
  • Zmieniliśmy nazwę pola onValueChangeEnd w Slider na onValueChangeFinished i umożliwiliśmy przypisywanie do niego wartości null.
  • Zmieniono nazwę parametru text w Snackbar na content, aby zachować spójność.
  • Dodano parametr contentPadding do DropdownMenuItem, aby umożliwić dostosowywanie domyślnego dopełnienia, i sprawiono, że content jest rozszerzeniem RowScope.
  • Zmieniono nazwę ModalDrawerLayout na ModalDrawer.
  • Zmieniono nazwę BottomDrawerLayout na BottomDrawer.
  • (I1cc66)

• Komponent BasicTextField akceptuje teraz obiekt Brush zamiast Color, co zapewnia większe możliwości dostosowywania (I83a36).

• imageResource i vectorResource są teraz funkcjami rozszerzającymi odpowiednio elementy ImageBitmap i ImageVector. Funkcje load{Image,Vector,Font}Resource zostały usunięte. (I89130)

• Zmieniono funkcję Indication#createIndication() na Indication#rememberUpdatedIndication(InteractionState) i usunięto parametr InteractionState z funkcji IndicationInstance#drawIndication(). Funkcja IndicationInstance powinna odpowiadać tylko za rysowanie efektów wizualnych, a nie za uruchamianie animacji ani zapisywanie stanu w odpowiedzi na zmiany InteractionState. Animacje i zapisy stanu powinny odbywać się w ramach rememberUpdatedIndication(). Parametr indication w pliku Modifier.indication został też zmieniony na wymagany. (Ic1764, b/152525426)

Poprawki błędów

• Dodano nowy lokalny interfejs API LocalSoftwareKeyboardController do zastąpienia poprzedniego interfejsu SoftwareKeyboardController w polu TextField. (I658b6, b/168778053)

Wersja 1.0.0-alpha12

10 lutego 2021 r.

Publikacja androidx.compose.material:material-*:1.0.0-alpha12 Wersja 1.0.0-alpha12 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Modifier.pointerInput wymaga teraz kluczy pamięci, aby wskazywać, kiedy korutyna wykrywania danych wejściowych wskaźnika powinna zostać ponownie uruchomiona w przypadku nowych zależności. (I849cd)
• Elementy BottomDrawerLayout i ListItem zostały oznaczone jako @ExperimentalMaterialApi (Id766e).
• Dodano PaddingValues.Absolute, którego można używać w interfejsach API akceptujących PaddingValues. (Ia5f30)
• Metoda onImeActionPerformed jest wycofana. Zamiast niej używaj KeyboardActions (If0bbd, b/179071523)
• Aby lepiej dopasować konwencje nazewnictwa do ImageBitmap i ImageVector, zmieniliśmy nazwę ImagePainter na BitmapPainter, aby była podobna do VectorPainter. (Iba381, b/174565889)
• Funkcje Animatable.snapTo i Animatable.stop są teraz funkcjami zawieszania (If4288).
• Funkcja ComponentActivity.setContent została przeniesiona do androidx.activity.compose.setContent w module androidx.activity:activity-compose. (Icf416)
• Metody destrukcji i copy() zostały usunięte z kilku klas, w których były rzadko używane. (I26702, b/178659281)
• Ustawienie funkcji halfExpand() i expand() w ModalBottomSheetState jako wewnętrznych (Ic914e)
• Zmieniono funkcję Indication#createInstance na @Composable i zmieniono LocalIndication tak, aby zawierała Indication, a nie () -> Indication. (I5eeea, b/157150564)
• Przeniesiono AlertDialog i DropdownMenu, aby na razie były dostępne tylko na Androidzie. Dodano parametr PopupProperties do DropdownMenu, aby umożliwić dalszą konfigurację bazowego okna wyskakującego. (I9c443)
• Funkcja loadFontResource została wycofana. Zamiast nich używaj fontResource. imageResource, loadImageResource, vectorResource i loadVectorResource zostały wycofane. Zamiast tego użyj painterResource. (I6b809)
• Usunięto parametry toggle i toggleModifier z komponentu DropdownMenu oraz zmieniono nazwy parametrów dropdownModifier, dropdownOffset i dropdownContent na odpowiednio modifier, offset i content. Komponent DropdownMenu działa teraz tak samo jak Popup, czyli do określania pozycji menu używany jest układ nadrzędny. W większości przypadków możesz przenieść element toggle, aby był elementem równorzędnym elementu DropdownMenu, i umieścić oba w elemencie Box. Więcej informacji o korzystaniu z tego interfejsu API znajdziesz w zaktualizowanym przykładzie w dokumentacji. (I884fb)
• Funkcja toIntPx() została zmieniona na roundToPx(). (I9b7e4, b/173502290)
• Zmieniliśmy nazwę klasy IntBounds na IntRect i ulepszyliśmy interfejs API. (I1f6ff)
• Dodano działania semantyczne rozwijania i zwijania. Dodano funkcje expand i halfExpand w ModalBottomSheetState (Ib5064)
• Modyfikator Modifier.dragGestureFilter został wycofany. Zamiast niej użyj zasady Modifier.pointerInput { detectDragGestures (...)}. Możesz też użyć modyfikatora Modifier.draggable do przeciągania w jednej osi (I0ba93, b/175294473).
• Zmieniliśmy nazwę Ambients, aby pasowała do zmiany nazwy Ambient -> CompositionLocal. Komponenty Ambients miały wcześniej nazwy AmbientFoo, a teraz komponenty CompositionLocals mają nazwy LocalFoo. (I2d55d)
• Zaznaczenie zostało przeniesione do modelu podstawowego. (I7892b)
• Podobnie jak wcześniej usunęliśmy funkcję state { 0 } i teraz promujemy używanie funkcji remember { mutableStateOf(0) }, usuniemy funkcję savedInstanceState { 0 }. Zamiast tego używaj rememberSaveable { mutableStateOf(0) }. Będzie ona automatycznie zapisywać i przywracać stan, jeśli typ użyty w MutableState można zapisać w Bundle. Jeśli wcześniej przekazywano niestandardowy obiekt zapisujący, teraz trzeba użyć nowego przeciążenia funkcji rememberSaveable, które ma parametr stateSaver. Użycie będzie wyglądać tak: val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) } (Ib4c26, b/177338004)
• Dodano ProgressBarRangeInfo.Indeterminate, aby oznaczać nieokreślone paski postępu na potrzeby ułatwień dostępu (I6fe05)

• Adnotacja @ComposableContract została wycofana 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ł(a) usunięty(a).
  • (I60a9d)

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

• Funkcja rememberSavedInstanceState() została zmieniona na rememberSaveable() i przeniesiona do pakietu androidx.compose.runtime.saveable. (I1366e, b/177338004)

• Funkcje Saver, listSaver(), mapSaver(), autoSaver zostały przeniesione z androidx.compose.runtime.savedinstancestate do androidx.compose.runtime.saveable (I77fe6)

• Parametry w klasach RounderCornerShape, CutCornerShape i CornerBasedShape zostały zmienione z left/right na start/end, aby obsługiwać automatyczne odbijanie kształtu w kierunku od prawej do lewej. Kształty AbsoluteRounderCornerShape i AbsoluteCutCornerShape zostały wprowadzone w przypadkach, gdy automatyczne dublowanie nie jest pożądane. (I61040, b/152756983)

• Zmieniliśmy parametry text i icon komponentu Tab oraz parametr label komponentu BottomNavigationItem, aby dopuszczały wartość null. Dzięki temu lepiej odzwierciedlają zachowanie komponentu, gdy te parametry są lub nie są podane, ponieważ wpływa to na rozmiar i układ komponentu. Jeśli obecnie przekazujesz wartość emptyContent(), aby oznaczyć brak tekstu, ikony lub etykiety, zamiast niej użyj wartości null. (I57ed4)

• Zmiana nazwy parametru koloru contentColorFor na backgroundColor (I5bb67)

• Wycofano TabDefaults i zastąpiono go TabRowDefaults. (I0f189)

• Wprowadzono interfejs ColorMatrix API, który służy do modyfikowania wartości RGB treści źródłowych. Zrefaktoryzowano interfejs ColorFilter API, aby był interfejsem i pasował do implementacji PathEffect. (Ica1e8)

• Właściwość AnimatedValue/Float została wycofana. Zamiast tego użyj interfejsu Animatable. (I71345, b/177457083)

• Dodano interfejs API SemanticsProperties.PaneTitle. (I20d5a)

• Dodaliśmy włączone parametry do elementów Tab i BottomNavigationItem, aby uniemożliwić ich klikanie. Zmieniono BottomNavigationItem na RowScope.BottomNavigationItem, aby lepiej wyrazić wymagania dotyczące układu w interfejsie API. (Id683d)

• Funkcje tapGestureFilter, doubleTapGestureFilter, longPressGestureFilter i pressIndicaitonGestureFilter zostały wycofane. Zamiast tego użyj Modifier.clickable lub Modifier.pointerInput z funkcją detectTapGestures. (I6baf9, b/175294473)

• Dodaj parametr layoutDirection do metody createOutline klasy Shape. Umożliwia to tworzenie kształtów uwzględniających kierunek układu. (I57c20, b/152756983)

• Użytkownik Recomposer.current() został usunięty. [Abstract]ComposeView now default to lazily created, window-scoped Recomposers driven by the ViewTreeLifecycleOwner for the window. Ponowne komponowanie i tyknięcia animacji oparte na withFrameNanos są wstrzymywane, gdy cykl życia hosta jest zatrzymany. (I38e11)

Poprawki błędów

• Ikona będzie teraz skalowana w górę, aby dopasować się do swojego rozmiaru, z uwzględnieniem zastosowanych do niej modyfikatorów rozmiaru. Na przykład Icon(.., modifier = Modifier.size(50.dp) będzie teraz rysowany w przestrzeni o wymiarach 50 x 50 dp. (Ib2ba9, b/178796190)

Wersja 1.0.0-alpha11

28 stycznia 2021 roku

Publikacja androidx.compose.material:material-*:1.0.0-alpha11 Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

• Promuje niektóre interfejsy Material API, aby nie były już @Experimental (I5d20e)
• Do obrazu i ikony dodano parametr opisu treści. Służy do przekazywania opisu usługom ułatwień dostępu (I2ac4c).
• Zmienia interfejsy parametrów stanowych Material na funkcje @Composable, które zwracają State<T>. Dodaje Animatable.asState(), aby ułatwić przekształcenie obiektu Animatable w stan. Zmienia też animateElevation na rozszerzenie zawieszające w przypadku Animatable. (If613c)
• Snackbar, SnackbarHost, SnackbarHostState nie są już @ExperimentalMaterialAPI (Id1fb5)
• Zmienia typografię, kształty i pozycję karty, aby nie były już klasami danych. Dodaje funkcję kopiowania typografii i kształtów, aby zastępować wygenerowane elementy. (I40037)
• Usunięto niektóre wcześniej wycofane interfejsy API Material Design (Ifaa25)

Poprawki błędów

• Funkcje onCommit, onDispose i onActive zostały wycofane na rzecz interfejsów SideEffect i DisposableEffect API (If760e).
• Wycofano przejście oparte na TransitionDefinition (I0ac57)
• Stan początkowy w funkcji updateTransition jest teraz obsługiwany (Ifd51d)
• Funkcja WithConstraints została przekształcona w BoxWithConstraints i przeniesiona do pakietu foundation.layout. (I9420b, b/173387208)

• Wycofanie funkcji scrollBy bez zawieszania, usunięcie funkcji scrollTo bez zawieszania

  Zalecamy teraz używanie funkcji zawieszania do kontrolowania przewijania i oczekiwania na jego zakończenie. W ramach tej zmiany wycofujemy lub usuwamy wersje tych funkcji, które nie powodują zawieszenia. (Ie9ced)

• Wycofanie funkcji smoothScrollBy, która nie jest funkcją zawieszającą Zalecamy teraz używanie funkcji zawieszających do sterowania przewijaniem i oczekiwania na zakończenie przewijania. W ramach tej zmiany wycofujemy wersje tych funkcji, które nie są zawieszane. (I12880)

• Wprowadzono ComposeContentTestRule, która rozszerza ComposeTestRule i definiuje setContent, która została usunięta z ComposeTestRule. Dodano metodę fabryczną createEmptyComposeRule(), która zwraca obiekt ComposeTestRule i nie uruchamia aktywności. Użyj tej opcji, gdy chcesz uruchomić aktywność podczas testu, np.za pomocą ActivityScenario.launch (I9d782, b/174472899).

• Efekt fali używany w komponentach Button i FloatingActionButton nie może być już dostosowywany przez podanie nowego komponentu Indication za pomocą AmbientIndication – nigdy nie miało to być sposobem na dostosowywanie tych komponentów, a teraz są one zgodne z innymi komponentami Material. Aby dostosować efekty falowania w aplikacji, zapoznaj się z informacjami o motywie RippleTheme. (I546c5)

• Funkcja animateAsState została zmieniona na animateFooAsState, gdzie Foo to typ animowanej zmiennej, np. Float, Dp, Offset itp. (Ie7e25)

• Komponent BasicTextField otrzymał nowy parametr o nazwie decorationBox. Umożliwia dodawanie do pola tekstowego elementów dekoracyjnych, takich jak ikony, symbole zastępcze czy etykiety, oraz zwiększanie obszaru docelowego kliknięcia. (I16996)

• Poprawka błędu, który uniemożliwiał ustawienie szerokości pola tekstowego materiału na mniej niż 280 pikseli dp (I78373).

• Usunięto parametr canDrag z funkcji Modifier.draggable (Ic4bec, b/175294473)

• Usuń displaySize, ponieważ należy go unikać. Zwykle lepiej jest używać rozmiaru onRoot() lub co najmniej rozmiaru okna. (I62db4)

• Komponent Surface może teraz mieć wiele elementów podrzędnych układu. (I66a92, b/144488459)

• Funkcje invalidate i compositionReference() zostały wycofane na rzecz funkcji currentRecomposeScope i rememberCompositionReference. (I583a8)

• Zmiana PopupPositionProvider na używanie współrzędnych względnych okna, a nie współrzędnych globalnych. Zmienia nazwę parentGlobalBounds na anchorBounds, a windowGlobalBounds na windowSize: IntSize (I2994a).

• Wartości Duration i Uptime zostaną zastąpione wartościami Long milliseconds, a ten krok usuwa zależność danych wejściowych wskaźnika od tych klas. (Ia33b2, b/175142755, b/177420019)

• Usunięto funkcję AnimatedFloat.fling, która akceptuje FlingConfig. Zamiast niej użyj metody suspend Animatable.animateDecay. (I4659b, b/177457083)

• elementy, które można kliknąć, przełączać i wybierać, można teraz tworzyć poza kompozycją (I0a130, b/172938345, b/175294473);

• Zastosowano funkcjonalny interfejs (Ib14e5)

• Komponenty ScrollableColumn i ScrollableRow zostały wycofane. Używanie elementu ScrollableColumn jest mniej wydajne niż LazyColumn w przypadku dużej zawartości przewijanej, ponieważ w przypadku LazyColumn możemy tylko tworzyć, mierzyć i rysować widoczne elementy. Aby zapobiec nieefektywnemu korzystaniu z tej funkcji, postanowiliśmy wycofać ScrollableColumn i ScrollableRow oraz promować zamiast nich LazyColumn i LazyRow. Użytkownicy mogą nadal decydować, że nie potrzebują leniwego zachowania, i używać modyfikatorów bezpośrednio, np. Column(Modifier.verticalScroll(rememberScrollState())) (Ib976b, b/170468083).

• Nowa metoda fabryczna items(count: Int) dla zakresu LazyColumn/LazyRow/LazyVerticalGrid. items(items: List) i itemsIndexed(items: List) są teraz funkcjami rozszerzającymi, więc musisz je ręcznie importować, gdy są używane. Nowe przeciążenia rozszerzeń dla tablic: items(items: Array) i itemsIndexed(Array) (I803fc, b/175562574)

• Usunięto eksperymentalne metody monotonicFrameAnimationClockOf (Ib753f, b/170708374)

• Wycofano metody globalnych współrzędnych i wprowadzono nowe metody współrzędnych oparte na oknach. (Iee284)

• Dodano Modifier.toolingGraphicsLayer, który dodaje modyfikator warstwy graficznej, gdy włączone jest sprawdzanie. (I315df)

• Metoda FocusRequester.createRefs została oznaczona jako eksperymentalna, ponieważ może ulec zmianie. (I2d898, b/177000821)

• Właściwość SemanticsPropertyReceiver.hidden została zmieniona na invisibleToUser i oznaczona jako @ExperimentalComposeUiApi. Zmiana nazwy AccessibilityRangeInfo na ProgressBarRangeInfo. stateDescriptionRange na progressBarRangeInfo. Zmieniono nazwę AccessibilityScrollState na ScrollAxisRange. Zmieniono nazwę horizontalAccessibilityScrollState na horizontalScrollAxisRange. Zmieniono nazwę verticalAccessibilityScrollState na verticalScrollAxisRange. (Id3148)

• Używanie TestCoroutineDispatcher w testach (I532b6)

• Zaktualizowano interfejs API grafiki wektorowej, aby obsługiwał analizowanie odcieni zastosowanych do głównego elementu grafiki wektorowej. (Id9d53, b/177210509)

Wersja 1.0.0-alpha10

13 stycznia 2021 r.

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

Zmiany w interfejsie API

• Zmodyfikowano Velocity, aby zawierał części składowe i operacje matematyczne. (Ib0447)
• Zmieniono nazwę @ExperimentalTesting na @ExperimentalTestApi, aby była zgodna z podobnymi eksperymentalnymi adnotacjami interfejsu API (Ia4502, b/171464963)
• Zmiana nazwy pozycji na DpOffset i usunięcie funkcji getDistance() (Ib2dfd)
• Zmiana nazwy funkcji Color.useOrElse() na Color.takeOrElse() (Ifdcf5)
• Dodaj przełącznik do pliku foundation Strings.kt (I4a5b7, b/172366489)
• Komponenty FlowRow i FlowColumn zostały wycofane. Zamiast tego użyj niestandardowego układu. (I09027)
• Funkcje Modifier.focus() i Modifier.focusRequester() zostały wycofane. Zamiast tego użyj funkcji Modifier.focusModifier() i Modifier.focusReference(). (I75a48, b/175160751, b/175160532, b/175077829)
• Przeniesiono klasę nativeClass do modułu ui i ustawiono ją jako wewnętrzną. Zaktualizowano użycie nativeClass w implementacjach equals, aby zamiast niego używać „is MyClass”. (I4f734)

Poprawki błędów

• Dodano obsługę wyłączonych i tylko do odczytu pól tekstowych (I35279, b/171040474, b/166478534)
• animate() zastępuje teraz animateAsState(), która zwraca State<T> zamiast T. Umożliwia to lepszą wydajność, ponieważ zakres unieważnienia można zawęzić do miejsca, w którym odczytywana jest wartość stanu. (Ib179e)
• Dodaj interfejs API roli Semantics i dodaj rolę jako parametr do klikalnego, wybieralnego i przełączalnego elementu SemanticsModifier. Zmiana funkcji Modifier.progressSemantics, aby można było jej używać także w przypadku suwaka. (I216cd)

Wersja 1.0.0-alpha09

16 grudnia 2020 roku

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

Zmiany w interfejsie API

• dodano interfejs API do ręcznego wywoływania animacji rozliczenia i przeciągania w modyfikatorze swipeable (Iaa17a, b/162408885);
• Zmieniono nazwy obiektów *Constants, np. ButtonConstants, tak aby kończyły się na Defaults, np. ButtonDefaults. Usuwa też niepotrzebne prefiksy default z właściwości w tych nowych obiektach. (Ibb915, b/159982740)

• Compose obsługuje funkcje pobierające właściwości, które mogą wywoływać funkcje kompozycyjne. Obsługa tej funkcji nie zostanie wycofana, ale zmieni się składnia deklarowania funkcji pobierającej właściwość jako @Composable.

  Obecnie przestarzała składnia polegała na dodaniu adnotacji do samej właściwości:

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

  Prawidłowa składnia w tym przypadku to dodanie adnotacji do funkcji pobierającej właściwość:

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

  Obie składnie będą działać przez pewien czas, ale starsza składnia zostanie ostatecznie uznana za błąd kompilacji. (Id9197)

• Dodano bibliotekę androidx.compose.material:material-ripple zawierającą interfejsy API efektu falowania, które umożliwiają tworzenie interaktywnych komponentów bez konieczności korzystania z pozostałej części biblioteki Material. Funkcja rememberRippleIndication została wycofana i zastąpiona funkcją rememberRipple. (Ibdf11)

Poprawki błędów

• Funkcje lambda w modyfikatorach przesunięcia zwracają teraz IntOffset zamiast Float. (Ic9ee5, b/174137212, b/174146755)

• Przebudowano klasę ShaderBrush, aby leniwie tworzyć instancję shadera, gdy dostępne są informacje o rozmiarze środowiska rysowania. Przydaje się to do definiowania gradientów, które w momencie kompozycji zajmują pełne granice rysowania elementu kompozycyjnego, bez konieczności implementowania niestandardowych implementacji DrawModifier.

  Wycofano interfejsy API konstruktora funkcji gradientu na rzecz metod fabrykujących w obiekcie Gradient. (I511fc, b/173066799)

• Modifier.focusObserver został wycofany. Zamiast tego użyj Modifier.onFocusChanged lub Modifier.onFocusEvent (I30f17, b/168511863, b/168511484)

• Wycofanie funkcji LazyColumnFor, LazyRowFor, LazyColumnForIndexed i LazyRowForIndexed. Zamiast tego używaj komponentów LazyColumn i LazyRow (I5b48c).

• Przeniesiono klasy Dp.VectorConverter, Position.VectorConverter itp. do pakietu animation-core i wycofano stare klasy VectorConveters (If0c4b).

• Interfejs Autofill API jest teraz interfejsem eksperymentalnym i wymaga zgody użytkownika (I0a1ec).

• Dodawanie deklaracji destrukcyjnych do tworzenia instancji FocusRequester (I35d84, b/174817008)

• accessibilityLabel została zmieniona na contentDescription. accessibilityValue została zmieniona na stateDescription. (I250f2)

• Nowa funkcja infiniteRepeatable do tworzenia obiektu InfiniteRepeatableSpec (I668e5)

• Zmieniliśmy nieznacznie pozycjonowanie menu DropdownMenu zgodnie ze specyfikacją Material. (I34c72, b/168594123)

• Dodano obsługę stanu interakcji w przypadku pól tekstowych. (I61d91)

• Dodano Modifier.clearAndSetSemantics, aby wyczyścić semantykę elementów podrzędnych i ustawić nową. (I277ca)

• Przeniesiono ContentDrawScope do modułu ui-graphics, aby był razem z DrawScope. (Iee043, b/173832789)

Wersja 1.0.0-alpha08

2 grudnia 2020 r.

androidx.compose.material:material:1.0.0-alpha08, androidx.compose.material:material-icons-core:1.0.0-alpha08 i androidx.compose.material:material-icons-extended:1.0.0-alpha08 są dostępne. Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Motyw MaterialTheme ustawia teraz prawidłowe kolory uchwytów zaznaczenia i tła zaznaczenia. Aplikacje inne niż Material mogą ręcznie używać AmbientTextSelectionColors, aby dostosować kolory używane do zaznaczania. (I1e6f4, b/139320372, b/139320907)
• Dodano sprawdzanie składni nazw i pozycji parametrów funkcji lambda, aby zapewnić zgodność ze wskazówkami dotyczącymi Compose. Zgodnie z kontrolą składni i wskazówkami zmieniliśmy też nazwy niektórych interfejsów API, które używały children jako nazwy funkcji lambda na końcu, na content. (Iec48e)
• Zmiana nazwy VectorAsset na ImageVector. Przeniesienie i zmiana nazwy VectorAsset na Builder, aby była klasą wewnętrzną ImageVector zgodnie z wytycznymi rady API. Dodano alias typu VectorAssetBuilder, aby zapewnić zgodność z ImageVector.Builder. (Icfdc8)
• Zmieniliśmy nazwy ImageAsset i powiązanych metod na ImageBitmap. (Ia2d99)
• Przeniesiono właściwości semantyczne podstaw do interfejsu (I6f05c)
• Interfejs fun RippleIndication() został wycofany i zastąpiony interfejsem rememberRippleIndication(), aby zachować spójność z innymi interfejsami API. (Id8e2c)
• Dodano parametr singleLine do komponentów BasicTextField, TextField i OutlinedTextField. Ustaw ten parametr na „true”, aby pole tekstowe było pojedynczą linią z możliwością przewijania w poziomie. (I57004, b/168187755)

Poprawki błędów

• Dodaj działanie semantyczne Odrzuć (I2b706)
• Przeniesiono interfejsy API DrawModifier z pakietu androidx.compose.ui do pakietu androidx.compose.ui.draw. Utworzono plik DrawModifierDeprecated.kt, aby zawierał aliasy typów i metody pomocnicze ułatwiające migrację z przestarzałych interfejsów API na obecne. (Id6044, b/173834241)
• Zmiana nazwy Modifier.drawLayer na Modifier.graphicsLayer Zaktualizowano też powiązane klasy do GraphicsLayer zgodnie z opiniami na temat interfejsu API. (I0bd29, b/173834241)
• Element <T> został usunięty z deklaracji SubcomposeLayout. Możesz teraz używać tego atrybutu bez określania typu. (Ib60c8)
• Dodano interfejsy Modifier.scale/rotate jako ułatwienia dla drawLayer.
  • Zmieniono nazwę Modifier.drawOpacity na Modifier.alpha
  • Nazwa Modifier.drawShadow została zmieniona na Modifier.shadow (I264ca, b/173208140)
• Parametr wyrównania elementu Box został zmieniony na contentAlignment. (I2c957)
• Modyfikatory offsetPx zostały zmienione na offset. Zamiast parametru State przyjmują teraz parametry lambda. (Ic3021, b/173594846)
• Wprowadzono interfejsy API SweepGradientShader i SweepGradientBrush. (Ia22c1)
• Dodaliśmy sprawdzanie parametrów modyfikatora w funkcjach kompozycyjnych. Ta kontrola lint sprawdza nazewnictwo, typ zwracany, wartość domyślną i kolejność parametru pod kątem zgodności z wytycznymi Compose. (If493b)
• Zaktualizowany interfejs TextFieldValue API
  • pole TextFieldValue.composition zostało ustawione jako tylko do odczytu.
  • usunięto wyjątek zgłaszany w przypadku nieprawidłowego zakresu wyboru (I4a675, b/172239032);
• Dodano nowe przeciążenie Modifier.drawLayer(). Przyjmuje blok lambda w nowym zakresie GraphicsLayerScope, w którym definiujesz parametry warstwy w sposób umożliwiający pominięcie ponownego komponowania i ponownego układu, gdy nastąpi zmiana stanu. DrawLayerModifier jest teraz wewnętrzny w ramach przygotowań do przeniesienia jego logiki do metody placeable.placeWithLayer() LayoutModifier (I15e9f, b/173030831).
• Wycofaliśmy właściwości Ambients, których nazwy miały sufiks Ambient, i zastąpiliśmy je nowymi właściwościami z prefiksem Ambient, zgodnie z innymi właściwościami Ambients i wytycznymi interfejsu Compose API. (I33440)
• Dodano sprawdzanie kodu, aby upewnić się, że fabryki modyfikatorów używają wewnętrznie interfejsu androidx.compose.ui.composed {} zamiast być oznaczane jako @Composable. (I3c4bc)
• Argument semantyczny mergeAllDescendants został zmieniony na mergeDescendants. (Ib6250)
• Kontrola czasu w testach (TestAnimationClock i jej zastosowania) jest teraz eksperymentalna (I6ef86, b/171378521).
• Usuwanie starego modułu ui-test i jego elementów zastępczych (I3a7cb)
• W celu zachowania spójności z innymi jednostkami nazwa TextUnit.Inherit została zmieniona na TextUnit.Unspecified. (Ifce19)
• Interfejs wyrównania został zaktualizowany i jest już funkcjonalny. (I46a07, b/172311734)
• W przypadku elementu LayoutIdParentData zmieniliśmy nazwę identyfikatora na layoutId. Zmieniliśmy nazwę Measurable.id na Measurable.layoutId. (Iadbcb, b/172449643)

Wersja 1.0.0-alpha07

11 listopada 2020 roku

androidx.compose.material:material:1.0.0-alpha07, androidx.compose.material:material-icons-core:1.0.0-alpha07 i androidx.compose.material:material-icons-extended:1.0.0-alpha07 są dostępne. Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wyróżnienie zostało wycofane i zastąpione przez AmbientContentAlpha. AmbientContentAlpha to prostsza abstrakcja, która reprezentuje preferowaną wartość alfa treści otoczenia dla części hierarchii, podobnie jak AmbientContentColor reprezentuje preferowany kolor treści otoczenia. Tekst i ikona domyślnie korzystają teraz z bieżącej wartości AmbientContentAlpha. Aby uzyskać ten sam efekt w komponentach, możesz ręcznie wykonać to działanie: color.copy(alpha = AmbientContentAlpha.current). Zamiast używać funkcji ProvideEmphasis, możesz bezpośrednio podać wartość za pomocą AmbientContentAlpha i użyć nowych poziomów domyślnych w ContentAlpha, aby zastąpić stare poziomy EmphasisLevels. (Idf03e, b/159017896)
• Dodaje androidx.compose.material.AmbientContentColor, aby zastąpić androidx.compose.foundation.AmbientContentColor (I84f7b, b/172067770).
• Dodaje androidx.compose.material.Text, aby zastąpić androidx.compose.foundation.Text jako komponent tekstowy wysokiego poziomu, który można dostosowywać za pomocą motywu. W przypadku podstawowego komponentu tekstowego, który nie korzysta z koloru ani stylu tekstu z motywu, użyj BasicText. (Ie6ae0)
• Dodano maxLines do pól tekstowych (Ib2a5b)
• Aktualizacja pól tekstowych, aby akceptowały KeyboardOptions (Ida7f3)
• Obecnie podczas obliczania nakładek wysokościowych usługa Surface używa bezwzględnej (całkowitej) wysokości, więc powierzchnia zagnieżdżona w innej powierzchni będzie używać połączonej wysokości do rysowania nakładki. (I7bd2b, b/171031040)

Poprawki błędów

• captureToBitmap przeniesiono do: captureToImage. (I86385)
• Podstawowe style AmbientTextStyle, ProvideTextStyle i AmbientContentColor zostały wycofane. Zamiast tego używaj nowych wersji dostępnych w bibliotece Material. W przypadku aplikacji innych niż Material Design utwórz własny system projektowania z motywami, które można wykorzystać w komponentach. (I74acc, b/172067770)
• foundation.Text został wycofany i zastąpiony przez material.Text. Podstawowy interfejs API tekstu, który nie korzysta z wartości z motywu, znajdziesz w artykule androidx.compose.foundation.BasicText. (If64cb)
• Zmiana nazwy KeyboardOptions na ImeOptions (I82f36)
• Przeniesiono KeyboardType i ImeAction do KeyboardOptions (I910ce)
• Komponent BaseTextField został wycofany. Zamiast tego użyj BasicTextField. (I896eb)
• Usunięto adnotację ExperimentalSubcomposeLayoutApi. Funkcja SubcomposeLayout może być teraz używana bez dodawania adnotacji @OptIn (I708ad)
• Elementy FirstBaseline i LastBaseline zostały przeniesione do pakietu androidx.compose.ui.layout (Ied2e7).
• Zaktualizowano interfejs Icon API, aby przyjmował wartość Color.Unspecified jako możliwy kolor odcienia, który będzie rysować podany zasób lub malarza bez filtra ColorFilter. Wcześniej próby zignorowania odcienia za pomocą Color.Unspecified powodowały odcień w przezroczystym kolorze, co w efekcie nie powodowało renderowania. (I049e2, b/171624632)
• Zmieniliśmy nazwę parametru relativePaddingFrom na paddingFrom. Dodano modyfikator paddingFromBaseline, który ułatwia określanie odległości od granic układu do linii bazowych tekstu. (I0440a, b/170633813)
• Aby zachować spójność z interfejsami SideEffect i DisposableEffect API, nazwa LaunchedTask została zmieniona na LaunchedEffect. Aby zachęcać do stosowania sprawdzonych metod, nie zezwalamy na używanie funkcji LaunchedEffect bez parametrów subject. (Ifd3d4)
• Element MeasureResult został przeniesiony poza element MeasureScope. (Ibf96d, b/171184002)
• Kilka symboli związanych z układem zostało przeniesionych z pakietu androidx.compose.ui do pakietu androidx.compose.layout.ui. (I0fa98, b/170475424)

Wersja 1.0.0-alpha06

28 października 2020 r.

androidx.compose.material:material:1.0.0-alpha06, androidx.compose.material:material-icons-core:1.0.0-alpha06 i androidx.compose.material:material-icons-extended:1.0.0-alpha06 są dostępne. Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• androidx.compose.foundation.Icon został przeniesiony do androidx.compose.material.Icon. Jeśli nie chcesz korzystać z biblioteki Material, możesz też użyć komponentu Image lub funkcji Modifier.paint() z obiektem Painter. (I9f622)
• Dodaje FloatingActionButtonElevation, aby reprezentować poziom uniesienia używany przez przyciski FAB w różnych stanach. Domyślną implementację znajdziesz w sekcji FloatingActionButtonConstants.defaultElevation() (I2d4f5).
• Dodaje interfejs SwitchColors, który reprezentuje kolory używane przez przełącznik w różnych stanach. Aby dostosować te kolory, zapoznaj się z informacjami o stałych wartościach SwitchConstants.defaultColors. (I93805)
• Dodaje interfejsy ButtonElevation i ButtonColors, które reprezentują wysokość i kolory używane przez przyciski w różnych stanach. Aby dostosować te parametry, zapoznaj się z funkcjami domyślnymi w ButtonConstants. (Ic5b7b)
• Dodaje interfejs RadioButtonColors do reprezentowania kolorów używanych przez RadioButton w różnych stanach. Aby dostosować kolory używane w różnych stanach, użyj RadioButtonConstants.defaultColors(). (I74130)
• Dodaje interfejs CheckboxColors, który reprezentuje kolory używane przez pole wyboru w różnych stanach. Aby dostosować kolory używane w różnych stanach, użyj metody CheckboxConstants.defaultColors(). (I7dbdb)

Poprawki błędów

• Komponenty Material nie ustawiają już wysokości jako zIndex. Oznacza to, że w ramach tego samego elementu nadrzędnego element podrzędny z większym rozmiarem cienia nie będzie automatycznie rysowany na wierzchu elementu podrzędnego z mniejszym rozmiarem cienia. Jeśli nadal potrzebujesz takiego zachowania, ustaw ręcznie Modifier.zIndex() w odpowiednich miejscach (I70417, b/170623932).
• Wycofanie funkcji VectorPainter na rzecz funkcji rememberVectorPainter, aby lepiej wskazywać, że interfejs API funkcji kompozycyjnych wewnętrznie wykorzystuje funkcję „remember” do utrwalania danych w różnych kompozycjach. (Ifda43)
• Włącz przejścia w ComposeTestRule; usuń opcję włączania migającego kursora z ComposeTestRule. (If0de3)
• Dodano opcję klawiatury jednoliniowej w komponencie CoreTextField (I72e6d)
• Zmieniliśmy nazwę interfejsu Radius API na CornerRadius, aby lepiej odzwierciedlała sposób jego użycia w Compose. Zaktualizowano dokumentację, aby wskazać, że ujemne promienie zaokrąglenia są ograniczone do zera. (I130c7, b/168762961)
• Zmieniono DrawScope i ContentDrawScope, aby były interfejsami, a nie klasami abstrakcyjnymi.
  • Utworzono implementację CanvasDrawScope interfejsu DrawScope
  • Zmiana implementacji DrawScope na CanvasScope
  • Utworzono DrawContext do opakowywania zależności dla DrawScope
  • Usunięto wycofane metody w DrawScope (I56f5e)
• Funkcja Box została przekształcona w funkcję wbudowaną. (Ibce0c, b/155056091)

Wersja 1.0.0-alpha05

14 października 2020 r.

androidx.compose.material:material:1.0.0-alpha05, androidx.compose.material:material-icons-core:1.0.0-alpha05 i androidx.compose.material:material-icons-extended:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wyskakujące okienka i okna dialogowe dziedziczą teraz FLAG_SECURE z okna nadrzędnego. Dodano też opcję wyraźnej konfiguracji (I64966, b/143778148, b/143778149).
• Domyślne progi stanów w przypadku modyfikatora swipeable wynoszą teraz 56 dp (Iab825, b/168610267).
• wszystkie stany komponentu Scaffold oznaczone jako @Stable; właściwość drawerGesturesEnabled w komponencie ScaffoldState przeniesiona do komponentu Scaffold; (I36645, b/168297016)
• Usuwa typ dopuszczający wartość null z parametrów lambda elementu Scaffold. Aby oznaczyć brak treści dla danego parametru, możesz użyć funkcji emptyContent(). (I2b318, b/157633857, b/158551084)

• Wycofuje interfejsy contentColor() i currentTextStyle() i zastępuje je odpowiednio AmbientContentColor i AmbientTextStyle. Aktualną wartość możesz uzyskać, używając .current w przypadku właściwości otoczenia, tak jak w przypadku każdego innego otoczenia. Ta zmiana została wprowadzona w celu zapewnienia spójności i uniknięcia wielu sposobów wykonania tego samego działania. Dodatkowo zmienia nazwy niektórych właściwości otoczenia, aby lepiej opisać ich przeznaczenie:

  • ContentColorAmbient -> AmbientContentColor
  • TextStyleAmbient -> AmbientTextStyle
  • IndicationAmbient -> AmbientIndication
  • EmphasisAmbient -> AmbientEmphasisLevels
  • RippleThemeAmbient -> AmbientRippleTheme (I37b6d)

• Dodaje AmbientElevationOverlay, co umożliwia dostosowywanie lub wyłączanie domyślnej nakładki podniesienia stosowanej do elementów Surface w ciemnym motywie. (I5b74d)

Poprawki błędów

• W ramach standaryzacji wartości wartowniczych dla klas wbudowanych zmieniamy nazwę Color.Unset na Color.Unspecified, aby zachować spójność z innymi klasami wbudowanymi (I97611, b/169797763).
• Wprowadzono TextOverflow.None. Gdy wartość parametru overflow to None, komponent Text nie będzie już obsługiwać przepełnienia i będzie zgłaszać do komponentu LayoutNode swój rzeczywisty rozmiar. (I175c9, b/158830170)
• Zmiana nazwy launchInComposition na LaunchedTask, aby była zgodna z wytycznymi interfejsu API Compose (I99a8e).
• Interfejs OnPositionedModifier został zmieniony na OnGloballyPositionedModifier, a metoda onPositioned() na onGloballyPositioned(). (I587e8, b/169083903)

Wersja 1.0.0-alpha04

1 października 2020 roku

androidx.compose.material:material:1.0.0-alpha04, androidx.compose.material:material-icons-core:1.0.0-alpha04 i androidx.compose.material:material-icons-extended:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Udostępnia parametry InteractionState w komponentach Material z zachowywaniem stanu, aby umożliwić przenoszenie stanu oraz odczytywanie i kontrolowanie stanu. (Iaca5f, b/168025711, b/167164434)
• Zmienia parametry *color elementów RadioButton i TriStateCheckbox, aby umożliwić pełne dostosowanie kolorów używanych w każdym stanie, a także zmianę sposobu animacji kolorów między stanami. Więcej informacji znajdziesz w nowych funkcjach kolorów animateDefault* w plikach CheckboxConstants i RadioButtonConstants. (I1c532)
• Zmieniono nazwę funkcji rememberBackdropState na rememberBackdropScaffoldState i dodano dodatkowy parametr zegara animacji. Zmiana nazwy parametru backdropScaffoldState w komponencie BackdropScaffold na scaffoldState. Zmiana nazwy BackdropConstants na BackdropScaffoldConstants. (Ib644d)
• Dodano eksperymentalny komponent BottomSheetScaffold. (Ie02f0, b/148996320)
• Dodano eksperymentalny komponent ModalBottomSheetLayout. (Ic209e, b/148996320)
• Zmienia nazwę ButtonConstants/FloatingActionButtonConstants.defaultAnimatedElevation na defaultElevation i zwraca teraz wartość Dp zamiast AnimatedValue. (I5f3ed)

Poprawki błędów

• Zaktualizowano wiele interfejsów API grafiki.
  • Zaktualizowano interfejsy API przekształceń skali i rotacji, aby używały jednego parametru Offset do reprezentowania współrzędnych punktu obrotu zamiast oddzielnych parametrów zmiennoprzecinkowych dla współrzędnych x/y w DrawScope i DrawTransform.
  • Usunięto metody Rect.expandToInclude i Rect.join
  • Zaktualizowana dokumentacja dotycząca promienia, w której oprócz kształtu eliptycznego podano też owalny.
  • Dodano dokumentację, aby wskazać, że publiczny konstruktor wbudowanej klasy Radius nie powinien być wywoływany bezpośrednio, ale obiekty Radius powinny być tworzone za pomocą konstruktorów funkcji.
  • Usunięto interfejsy API RoundRect do wysyłania zapytań o wartości topRight, bottomRight, bottomCenter itp.
  • Wycofanie Rect.shift na rzecz Rect.translate
  • Usunięto interfejsy API RoundRect.grow i Rect.shrink
  • Zmiana nazwy RoundRect.outerRect na Rect.boundingRect
  • Usunięto metody RoundRect.middleRect/tallMiddleRect/wideMiddleRect i Rect.isStadium
  • Zmiana nazwy RoundRect.longestSide na RoundRect.maxDimension
  • Zmiana nazwy RoundRect.shortestSide na RoundRect.minDimension
  • Zmiana RoundRect.center na właściwość zamiast funkcji
  • Zaktualizowano konstruktor RoundRect, aby korzystał z właściwości Radius zamiast z poszczególnych parametrów wartości promienia x/y.
  • Usunięto interfejsy API rozmiaru, które zakładały, że jest to prostokąt o początku w punkcie 0,0
  • Dodano interfejs API niszczenia do Radius
  • Przeniesiono różne funkcje rozszerzenia RoundRect, aby były właściwościami
  • (I8f5c7, b/168762961)
• Klasa foundation.Box została wycofana. Zamiast tego użyj foundation.layout.Box. (Ie5950, b/167680279)
• Grupa została zmieniona na Box. Dotychczasowy komponent Box zostanie wycofany na rzecz nowego komponentu Box w pakiecie compose.foundation.layout. Nowy element Box układa elementy podrzędne jeden na drugim, gdy ma ich kilka. Różni się to od poprzedniego elementu Box, który zachowywał się podobnie do elementu Column. (I94893, b/167680279)
• Parametry dekoracji pola zostały wycofane. Jeśli chcesz dodać dekoracje lub dopełnienie do elementu Box, użyj zamiast tego modyfikatorów (Modifier.background, Modifier.border, Modifier.padding) (Ibae92, b/167680279).
• Zaktualizowano wiele interfejsów API grafiki.
  • Zaktualizowano interfejsy DrawScope API o metody przekształcania w określonym zakresie, aby wskazać, że przekształcenie jest stosowane tylko w wywołaniu zwrotnym i usuwane po jego wywołaniu.
  • Zaktualizowana dokumentacja clipPath, w której zamiast zaokrąglonego prostokąta jest mowa o ścieżce
  • Poprawiono odstępy w dokumentacji parametru right w elemencie clipPath
  • Zmieniono nazwę DrawScope.drawCanvas na drawIntoCanvas i usunięto parametr rozmiaru
  • Zmieniono nazwy parametrów dx/dy w metodzie inset na horizontal i vertical.
  • Dodano przeciążenie wstawki, które zapewnia tę samą wartość wstawki dla wszystkich 4 obszarów.
  • Usunięto dokumentację dotyczącą metody wstawiania, która wskazywała, że wstawianie będzie stosowane do wszystkich 4 stron.
  • Zaktualizowana dokumentacja klasy Rect
  • Zaktualizowano komentarze dotyczące parametrów Rect, aby były zgodne ze stylem kdoc.
  • Usunięto Rect.join i Rect.expandToInclude
  • Utworzono przeciążenie funkcji Rect.translate(offset) i wycofano funkcję Rect.shift
  • (If086a, b/167737376)
• Uniemożliwiliśmy statyczne importowanie treści z zakresów układu (np. alignWithSiblings w RowScope). Zamiast tego użyj alternatywnego zakresu: with(RowScope) { Modifier.alignWithSiblings(FirstBaseline) }. (I216be, b/166760797)

Wersja 1.0.0-alpha03

16 września 2020 roku

androidx.compose.material:material:1.0.0-alpha03, androidx.compose.material:material-icons-core:1.0.0-alpha03 i androidx.compose.material:material-icons-extended:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Zmienia nazwę parametru BottomNavigationItem na onClick (I91925, b/161809324)onSelect
• Dodaje parametr InteractionState do elementów BottomNavigationItem i Tab, co umożliwia przenoszenie tego stanu i dostosowywanie wyglądu komponentu w różnych stanach. (Ia3e9e, b/168025711)
• Usuwa parametry disabledBackgroundColor i disabledContentColor z przycisków. Zamiast tego używaj nowych domyślnych funkcji kolorów w ButtonConstants. Jeśli ustawiasz już jawnie contentColor lub backgroundColor, zamiast tego użyj tych funkcji domyślnych i dostosuj niektóre lub wszystkie parametry, aby uniknąć nadpisywania koloru w przypadku stanów włączonych i wyłączonych. (If9b52)
• Kolor tła pola tekstowego nie stosuje już domyślnie przezroczystości alfa. Zamiast tego każdy kolor podany w parametrze backgroundColor zostanie zastosowany bezpośrednio. (Iecee9, b/167951441)
• Zmieniliśmy nazwę InnerPadding na PaddingValues. (I195f1, b/167389171)
• Parametry resistanceFactorAtMin i resistanceFactorAtMax w Modifier.swipeable zostały zastąpione pojedynczym parametrem oporu. W SwipeableConstants dodano nową metodę defaultResistanceConfig. (I54238)
• Dodaje obsługę animowanego stanu podniesienia dla komponentów Button i FloatingActionButton. Wysokość jest teraz animowana między stanem domyślnym a naciśniętym. Aby dostosować wysokość między stanami, użyj ButtonConstants.defaultAnimatedElevation() i FloatingActionButtonConstants.defaultAnimatedElevation() zamiast ustawiać stałą wartość Dp we wszystkich przypadkach. (I37925)
• Etykieta stała się parametrem opcjonalnym w polach TextField i OutlinedTextField (I267f6, b/162234081)

Poprawki błędów

• Funkcje testowania globalnego, takie jak onNode czy waitForIdle, są teraz wycofane. Przejdź na ich nowe odpowiedniki zdefiniowane w ComposeTestRule (I7f45a).
• Interfejs DpConstraints i interfejsy API, które go używają, zostały wycofane. (I90cdb, b/167389835)
• Parametry minWidth i maxWidth modyfikatora widthIn zostały zmienione na min i max. Podobnie w przypadku modyfikatorów preferredWidthIn, heightIn i preferredHeightIn. (I0e5e1, b/167389544)
• Usuń działania semantyczne przewijania do przodu i do tyłu. Dodano kroki w AccessibilityRangeInfo. (Ia47b0)
• W interfejsach API układu wszystkie wystąpienia słowa „gravity” zostały zmienione na „align” lub „alignment”. (I2421a, b/164077038)
• Dodano metody onNode i inne metody globalne w klasie ComposeTestRule, ponieważ obecne metody globalne zostaną wycofane. (Ieae36)
• Przeniesiono createAndroidComposeRule i AndroidInputDispatcher z androidx.ui.test.android do androidx.ui.test (Idef08, b/164060572)

Wersja 1.0.0-alpha02

2 września 2020 r.

androidx.compose.material:material:1.0.0-alpha02, androidx.compose.material:material-icons-core:1.0.0-alpha02 i androidx.compose.material:material-icons-extended:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaliśmy eksperymentalny komponent BackdropScaffold. (Iad908)

Poprawki błędów

• Matrix4 został zastąpiony przez Matrix. Wszystkie pozostałe części pakietu vectormath zostały usunięte. (Ibd665, b/160140398)

Wersja 1.0.0-alpha01

26 sierpnia 2020 r.

androidx.compose.material:material:1.0.0-alpha01, androidx.compose.material:material-icons-core:1.0.0-alpha01 i androidx.compose.material:material-icons-extended:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 zawiera te zatwierdzenia.

Znany problem

= Pierwszego znaku w materiale TextField nie można usunąć za pomocą klawisza Backspace (b/165956313)

Wersja 0.1.0-dev

Wersja 0.1.0-dev17

19 sierpnia 2020 r.

androidx.compose.material:material:0.1.0-dev17, androidx.compose.material:material-icons-core:0.1.0-dev17 i androidx.compose.material:material-icons-extended:0.1.0-dev17 są dostępne. Wersja 0.1.0-dev17 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Wycofane wcześniej komponenty RadioGroup i RadioGroupItems zostały usunięte. Zamiast tego użyj wiersza i przycisku radiowego (I381b7, b/163806637).
• Usunięto wywołania zwrotne onFocusChanged z pola tekstowego. Zamiast tego użyj Modifier.focusObserver. (I51089, b/161297615)
• Funkcja Modifier.drawBorder została wycofana. Zamiast tego użyj Modifier.border. Klasa danych Border została zastąpiona przez BorderStroke (I4257d, b/158160576)
• Zmieniliśmy nazwy niektórych właściwości w SwipeableState: swipeTarget –> targetValue, swipeProgress –> progress, swipeDirection –> direction. Dodaliśmy funkcję rememberSwipeableState do tworzenia obiektów SwipeableState. (I2fc9c, b/163129614, b/163132293)
• Dodano obsługę paska powiadomień z rozmieszczaniem i prawidłowym kolejkowaniem. Możesz to zrobić za pomocą funkcji SnackbarHostState.showSnackbar. Dodatkowo:
  • Dodano komponenty SnackbarHost. Zawiera on wyskakujące okienka w zależności od stanu i odpowiada za przechodzenie między nimi.
  • Dodano SnackbarHostState, aby umożliwić kontrolę nad paskami powiadomień i ich hostami oraz oddzielić je od ScaffoldState. Dostęp do tego stanu możesz uzyskać również za pomocą scaffoldState.snackbarHostState.
  • Dodano przeciążenie paska powiadomień, aby obsługiwać wspólny interfejs między stanem hosta paska powiadomień a samymi paskami powiadomień. (I79aaa)
• Dodaje parametr enabled do IconButton i zmienia kolejność parametrów w IconToggleButton (I0a941, b/161809385, b/161807956)
• Usunięto wersję ListItem z interfejsem API opartym na ciągach znaków. Zamiast tego użyj wersji gniazda. (Ib8f57, b/161804681)
• Usunięto wycofany komponent FilledTextField. Zamiast tego użyj komponentu TextField, aby uzyskać implementację pola tekstowego wypełnionego zgodną z Material Design. (I5e889)
• AlertDialog używa teraz FlowRow w przypadku przycisków (I00ec1, b/161809319, b/143682374)
• Dodano parametry w modyfikatorze swipeable, które umożliwiają zmianę oporu podczas przesuwania poza granice. Usunięto parametry [min/max]Value. (I93d98)
• Dodano parametr backgroundColor do LinearProgressIndicator i usunięto wewnętrzny dopełnienie z CircularProgressIndicator. Dodano nową stałą ProgressIndicatorConstants.DefaultProgressAnimationSpec, której można używać jako domyślnej wartości AnimationSpec podczas animowania postępu między wartościami (If38b5, b/161809914, b/161804677).
• Do modyfikatora Modifier.swipeable dodano opcjonalny parametr velocityThreshold. (I698ba)
• bottomBarSize, fabSize i inne nie są już dostępne w ScaffoldState. Zamiast tego użyj Modifier.onPosition w komponencie, którego rozmiar chcesz poznać. Do komponentu Scaffold dodano parametry contentColor i Modifier (Ic6f7b, b/161811485, b/157174382).
• Zmiana nazw i kolejności niektórych parametrów w karcie w celu zachowania spójności z innymi interfejsami API (Ia2d12, b/161807532)
• Dzieli TabRow na TabRow i ScrollableTabRow, usuwając isScrollable z TabRow. Udostępnia też edgePadding w ScrollableTabRow, co pozwala kontrolować wolną przestrzeń przed i za kartami. (I583e8, b/161809544)
• Obiekt TabRow został usunięty i zastąpiony przez TabConstants. Element TabRow.TabPosition został przeniesiony na najwyższy poziom (TabPosition), a element indicatorContainer został zmieniony na indicator. Szczegółowe informacje o korzystaniu z zaktualizowanego interfejsu API i wartościach domyślnych znajdziesz w przykładach i dokumentacji. (I54d45, b/161809544)
• Parametr progów w modyfikatorze swipeable został zmodyfikowany.Przyjmuje teraz parę stanów (typu T) i zwraca próg między nimi w postaci ThresholdConfig. Do komponentu SwipeToDismiss dodano parametr dismissThresholds, który jest funkcją lambda (DismissDirection) -> ThresholdConfig. (Ie1080)
• Suwak ma więcej kolorów, co umożliwia szczegółowe dostosowywanie (I73e64, b/161810475)
• Parametr koloru karty został zmieniony na backgroundColor (I01fc1, b/161809546)
• Bar z przekąskami ma teraz konfigurowalne kolory tła i treści (I238f2, b/161804381)
• Do komponentów Drawers dodano parametry dostosowywania modyfikatora, backgroundColor, contentColor i scrimColor (I23655, b/161804378).
• Funkcja state { ... } została wycofana na rzecz jawnych wywołań funkcji remember { mutableStateOf(...) }, aby zwiększyć przejrzystość. Zmniejsza to ogólną powierzchnię interfejsu API i liczbę koncepcji zarządzania stanem oraz pasuje do wzorca by mutableStateOf() delegowania właściwości klasy. (Ia5727)
• Parametr dopełnienia przycisku został zmieniony na contentPadding (Id252e, b/161809394)
• Dodaj eksperymentalny komponent materiałowy SwipeToDismiss. (I129e5)

Poprawki błędów

• Usunięto onChildPositioned i OnChildPositionedModifier. Zamiast tego programiści powinni używać w układzie podrzędnym elementów onPositioned i OnPositionedModifier. (I4522e, b/162109766)
• Dodano funkcję lambda mergePolicy do SemanticsPropertyKey. Można jej użyć do zdefiniowania niestandardowych zasad scalania wszystkich elementów podrzędnych. Domyślna zasada polega na używaniu wartości nadrzędnej, jeśli jest już obecna, w przeciwnym razie używana jest wartość podrzędna. (Iaf6c4, b/161979921)
• IntSize jest teraz klasą wbudowaną (I2bf42).
• Nazwa PlacementScope.placeAbsolute() została zmieniona na PlacementScope.place(), a poprzednia nazwa PlacementScope.place() została zmieniona na PlacementScope.placeRelative(). W rezultacie metoda PlacementScope.place() nie będzie już automatycznie odzwierciedlać pozycji w kontekstach pisanych od prawej do lewej. Jeśli chcesz to zrobić, użyj zasady PlacementScope.placeRelative(). (I873ac, b/162916675)
• Wycofano PxBounds na rzecz Rect. Zaktualizowano wszystkie użycia PxBounds za pomocą funkcji rect i dodano odpowiednie adnotacje dotyczące wycofywania/zastępowania, aby ułatwić migrację. (I37038, b/162627058)
• Zmiana nazwy RRect na RoundRect, aby lepiej pasowała do wzorców nazewnictwa w Compose. Utworzono podobne konstruktory funkcji do RRect i wycofano konstruktory funkcji RRect (I5d325).

Wersja 0.1.0-dev16

5 sierpnia 2020 r.

androidx.compose.material:material:0.1.0-dev16, androidx.compose.material:material-icons-core:0.1.0-dev16 i androidx.compose.material:material-icons-extended:0.1.0-dev16 są dostępne. Wersja 0.1.0-dev16 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Klasa Colors jest teraz klasą finalną, a nie interfejsem. Zamiast rozszerzać i udostępniać niestandardową implementację, utwórz nowe środowisko dla niestandardowego obiektu motywu i uzyskaj dostęp do obiektu motywu za pomocą nowego środowiska w komponentach, podobnie jak działa wewnętrznie MaterialTheme. (Ibae84)
• Zmieniliśmy nazwę ColorPalette na Colors, aby lepiej odzwierciedlała system kolorów Material i uniknąć nieporozumień związanych z tym, że ColorPalette jest „ogólnym” obiektem motywu, a nie konkretną implementacją systemu kolorów Material. Dodatkowo zmienia nazwy lightColorPalette i darkColorPalette na lightColors i darkColors. (I9e976, b/161812111)
• Zmienia nazwy parametrów text, onSelected, activeColor i inactiveColor elementu BottomNavigationItem na label, onSelect, selectedContentColor i unselectedContentColor oraz aktualizuje kolejność parametrów zgodnie z wytycznymi. (Icb605, b/161809324)
• Modifier.stateDraggable został całkowicie przekształcony i zmieniono jego nazwę na Modifier.swipeable. Wprowadziliśmy nową klasę SwipeableState, a klasy DrawerState i BottomDrawerState zostały przekształcone tak, aby z niej dziedziczyć. [Modal/Bottom]DrawerLayout nie przyjmuje już parametru onStateChange. (I72332, b/148023068)
• Pakiet foundation.shape.corner został spłaszczony do foundation.share (I46491, b/161887429)
• Dodano adnotację ExperimentalMaterialApi. Oznaczono RippleTheme jako eksperymentalny (Ic5fa0, b/161784800)
• Komponent Material FilledTextField został zmieniony na TextField, a komponent podstawowy TextField został zmieniony na BaseTextField, aby ułatwić odkrywanie i używanie najprostszego interfejsu API (Ia6242, b/155482676).

Poprawki błędów

• Metoda OnChildPositioned została wycofana. Zamiast tego użyj OnPositioned w przypadku elementu podrzędnego. (I87f95, b/162109766)
• Poprawki w interfejsie API (I077bc)
  1. Usuwanie nieużywanego interfejsu OffsetBase
  2. Ujednolicenie klas Offset i IntOffset w celu zapewnienia spójnego interfejsu API
  3. Zmiana nazwy IntOffset.Origin na IntOffset.Zero w celu zachowania spójności z interfejsem Offset API
  4. Przeniesiono metodę nativeCanvas z interfejsu Canvas, aby umożliwić użytkownikom tworzenie własnych instancji Canvas.
  5. Utworzono klasę EmptyCanvas, aby refaktoryzować DrawScope i zamiast lateinit używać parametru niepustego, a także zapewnić, że pole nie będzie miało wartości null.
  6. Zmiana nazw wyliczeń ClipOp na format PascalCase
  7. Zmiana nazwy wyliczeń FilterQuality na Pascal Case
  8. Zmiana nazw wyliczeń StrokeJoin na Pascal Case
  9. Zmiana nazwy wyliczeń PointMode na Pascal Case
  10. Zmiana nazwy wyliczeń PaintingStyle na Pascal Case
  11. Zmiana nazwy wyliczeń PathFillType na Pascal Case
  12. Zmieniono nazwy wyliczeń StrokeCap na Pascal Case
  13. Zaktualizowano implementację DrawCache, aby nie używać już parametrów lateinit
  14. Zaktualizowano DrawScope, aby nie używać już leniwego delegowania w przypadku wewnętrznych parametrów fillPaint i strokePaint
  15. Zaktualizowano funkcję kompozycyjną Image, aby uniknąć używania Box, co zmniejsza obciążenie.
  16. Zaktualizowano klasę Outline, aby zawierała adnotacje @Immutable
  17. Zaktualizowano klasę PathNode, aby zawierała adnotacje @Immutable dla każdej instrukcji ścieżki.
  18. Zaktualizowano podkompozycję wektora, aby usunąć zbędne sprawdzanie warunkowe równości, ponieważ kompozycja już je obsługuje.
  19. Wyłączenie metod konstruktora towarzyszącego Rect na rzecz konstruktorów funkcji
  20. Zaktualizowano klasy Brush i konstruktory funkcji za pomocą interfejsów API @Immutable i @Stable.
  21. Zaktualizowano wyliczenie VertexMode, aby używać notacji PascalCase
  22. Zaktualizowano metodę selectPaint w klasie DrawScope, aby warunkowo zastępować parametry pędzla w obiekcie Paint, jeśli uległy zmianie.
  23. Aktualizacja klasy Size (dodanie interfejsu API destructuring, zmiana nazwy UnspecifiedSize na Unspecified i usunięcie nieużywanych metod)
• Przeniesienie okna do interfejsu (I47fa6)
• Użytkownik SemanticsNodeInteraction.performPartialGesture został usunięty. Zamiast niej używaj zasady SemanticsNodeInteraction.performGesture. (Id9b62)
• Nazwa SemanticsNodeInteraction.getBoundsInRoot() została zmieniona na SemanticsNodeInteraction.getUnclippedBoundsInRoot() (Icafdf, b/161336532)
• Interfejsy API obsługujące pisanie od prawej do lewej zostały zaktualizowane. Dodano LayoutDirectionAmbient, którego można używać do odczytywania i zmieniania kierunku układu. Usunięto Modifier.rtl i Modifier.ltr. (I080b3)
• Nazwa funkcji Modifier.deternimateProgress została zmieniona na Modifier.progressSemantics (I9c0b4)
• Aktualizuje pakiet material-icons-extended o najnowsze ikony dodane do Material.io/icons (I4b1d3).
• Wymagaj jawnego określenia typu T w przypadku transitionDefinition. (I1aded)
• Funkcja Modifier.plus została wycofana. Zamiast niej używaj funkcji Modifier.then. Słowo „wtedy” silniej sygnalizuje kolejność, a także uniemożliwia wpisanie znaku Modifier.padding().background() + anotherModifier, który przerywa łańcuch i utrudnia czytanie (Iedd58, b/161529964).
• Zmiana nazwy AndroidComposeTestRule na createAndroidComposeRule. (I70aaf)
• Dodaj elementy SemanticsMatcher isFocused() i isNotFocused(). (I0b760)
• Usunięto BaseGestureScope.globalBounds, którego nie należy używać w testach. Zamiast tego użyj współrzędnych lokalnych węzła, z którym wchodzisz w interakcję. (Ie9b08)
• Ustalona pozycja wyskakującego okienka na ekranach z wycięciem. (Idd7dd)
• Funkcja Modifier.drawBackground została zmieniona na Modifier.background (I13677)

Wersja 0.1.0-dev15

22 lipca 2020 r.

androidx.compose.material:material:0.1.0-dev15, androidx.compose.material:material-icons-core:0.1.0-dev15 i androidx.compose.material:material-icons-extended:0.1.0-dev15 są dostępne. Wersja 0.1.0-dev15 zawiera te zatwierdzenia.

Aktualizacja zależności

• Aby używać wersji 0.1.0-dev15 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. Używaj stanów i funkcji mutableStateOf jako alternatyw. Decyzja o wycofaniu została podjęta po dokładnym rozważeniu wszystkich argumentów.

  Uzasadnienie

  Uzasadnienie może obejmować m.in.:

  • Zmniejsza obszar interfejsu API i liczbę koncepcji, których musimy nauczyć
  • Jest bardziej zbliżony do innych porównywalnych zestawów narzędzi (Swift UI, React, Flutter).
  • Decyzja odwracalna. Zawsze możemy później przywrócić @Model.
  • Usuwa rzadkie przypadki użycia i trudne pytania dotyczące konfigurowania usługi @Model jako rzeczy, którymi musimy się zająć.
  • @Model klasy danych, equals, hashcode itp.
  • Jak mogę sprawić, aby niektóre usługi były „obserwowane”, a inne nie?
  • Jak określić, czy w obserwacji ma być używane równanie strukturalne czy referencyjne?
  • Zmniejsza „magię” w systemie. Zmniejszyłoby to prawdopodobieństwo, że ktoś uzna system za bardziej inteligentny, niż jest w rzeczywistości (np. że wie, jak porównać listy).
  • Ułatwia intuicyjne określanie szczegółowości obserwacji.
  • Ulepsza możliwość refaktoryzacji ze zmiennej -> właściwości w klasie
  • Może to otworzyć możliwości ręcznego dostosowywania ustawień do poszczególnych stanów.
  • Jest bardziej zgodny z pozostałą częścią ekosystemu i zmniejsza niejednoznaczność w odniesieniu do niezmiennych lub „przyjmujących zmienny stan”

  Notatki dotyczące migracji

  Prawie wszystkie dotychczasowe zastosowania symbolu @Model można łatwo przekształcić na jeden z 2 sposobów. W przykładzie poniżej znajduje się klasa @Model z 2 właściwościami (tylko na potrzeby przykładu) używana w funkcji kompozycyjnej.

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

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

  To podejście jest łatwiejsze dzięki klasom danych w języku Kotlin. Wszystkie dotychczasowe właściwości var przekształć we właściwości val klasy danych, a potem używaj state zamiast remember i przypisuj wartość stanu do sklonowanych kopii oryginału za pomocą metody wygody copy(...) klasy danych.

  Pamiętaj, że to podejście działa tylko wtedy, gdy jedyne zmiany w tej klasie zostały wprowadzone w tym samym zakresie, w którym utworzono instancję State. Jeśli klasa zmienia się wewnętrznie poza zakresem użycia i polegasz na obserwacji tej zmiany, użyj następnego podejścia.

  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

  Ułatwiają to delegaty właściwości Kotlin i interfejs mutableStateOf API, który umożliwia tworzenie instancji MutableState poza kompozycją. Zastąp wszystkie właściwości var oryginalnej klasy właściwościami var, których delegatem właściwości jest mutableStateOf. Dzięki temu sposób użycia klasy nie zmieni się w żaden sposób, a jedynie jej wewnętrzna implementacja. Zachowanie nie jest jednak całkowicie identyczne z oryginalnym przykładem, ponieważ każda właściwość jest teraz obserwowana lub subskrybowana indywidualnie, więc ponowne kompozycje, które zobaczysz po tej zmianie, mogą być bardziej ograniczone (co jest korzystne).

  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)

• Wywołanie zwrotne onFocusChange w polach tekstowych zostało zmienione na onFocusChanged (Ida4a1)

• Dodano parametr progów w stateDraggable, aby określić progi między punktami zakotwiczenia. Użyto go do ustawienia progu 56 dp w dolnym panelu. Klasa BottomDrawerLayout korzysta teraz z osobnego wyliczenia BottomDrawerState. (I533fa)

• Usuwa wcześniej wycofany modyfikator Modifier.ripple. Funkcja Clickable używa teraz efektu fali jako domyślnego wskaźnika (jeśli w aplikacji masz ustawiony element MaterialTheme{}), więc w większości przypadków możesz po prostu użyć funkcji Clickable i uzyskać efekt fali bez dodatkowych działań. Jeśli chcesz dostosować kolor, rozmiar lub parametr ograniczony efektu fali, możesz ręcznie utworzyć RippleIndication i przekazać go do funkcji clickable jako parametr indication. (I663b2, b/155375067)

• Usunięto wycofane zastąpienie funkcji FilledTextField (I7f8f8)

• Zmiana nazwy obiektu Button (zawierającego wartości domyślne używane przez funkcję Button) na ButtonConstants (I7c5f7, b/159687878)

• Miejsce na treść przycisku działa teraz jak wiersz (przydatne, gdy chcesz mieć ikonę z tekstem, zobacz przykłady w sekcji dotyczącej przycisku) (I0ff10, b/158677863)

• Elementy RadioGroup i RadioGroupItem zostały wycofane. Użyj komponentów Box z modyfikatorem selectable, Row i Column, aby utworzyć odpowiedni zestaw opcji radioButton zgodnie z projektem (I7f5cf, b/149528535).

• Dodano pole tekstowe Material Outlined (I1a518)

• Interfejsy androidx.ui.foundation.TextFieldValue i androidx.ui.input.EditorValue zostały wycofane. Elementy kompozycyjne TextField, FilledTextField i CoreTextField, które używają tego typu, również zostały wycofane. Zamiast tego użyj klasy androidx.ui.input.TextFieldValue (I4066d, b/155211005)

• TabRow.TabPosition nie zawiera pozycji w jednostkach dp, tylko w jednostkach IntPx (I34a07, b/158577776)

• Zastąpiono użycie IntPx przez Int. Zastąpiono IntPxPosition przez IntOffset. Zastąpiono IntPxSize wartością IntSize. (Ib7b44)

• Aby zmniejszyć liczbę klas używanych do reprezentowania informacji o rozmiarach, ujednolić użycie klasy Size zamiast PxSize. Dzięki temu możesz korzystać z zalet klasy wbudowanej, aby używać typu long do pakowania 2 wartości zmiennoprzecinkowych reprezentujących szerokość i wysokość. (Ic0191)

• Wycofuje Modifier.ripple. Funkcja Clickable używa teraz efektu fali jako domyślnego wskaźnika (jeśli w aplikacji masz ustawiony element MaterialTheme{}), więc w większości przypadków możesz po prostu użyć funkcji Clickable i uzyskać efekt fali bez dodatkowych działań. Jeśli chcesz dostosować kolor, rozmiar lub parametr ograniczony efektu fali, możesz ręcznie utworzyć RippleIndication i przekazać go do funkcji clickable jako parametr indication. (I101cd, b/155375067)

• Przebudowaliśmy interfejs Scaffold API: zmieniliśmy nazwy kilku parametrów i dodaliśmy nowe parametry, aby umożliwić lepsze dostosowywanie. Dodano funkcję pobierania rozmiarów elementów Fab, TopBar i BottomBar (I0e7ce).

• Dodano komponent DropdownMenu w ui-material, czyli implementację menu Material Design. (I9bb3d)

• Zezwalaj na ręczne pokazywanie i ukrywanie klawiatury ekranowej za pomocą klasy SoftwareKeyboardController (Ifb9d6, b/155427736)

• Do pakietu podstawowego dodano pole Modifier.indication. Używaj go do wyświetlania informacji o naciśnięciu, przeciągnięciu lub innych interakcjach w przypadku niestandardowych elementów interaktywnych (I8425f, b/155287131).

• Ujednolicone implementacje CanvasScope, dzięki czemu są teraz tylko DrawScope i ContentDrawScope. Zmieniono nazwę CanvasScope na DrawScope. Zaktualizowano DrawScope, aby zaimplementować interfejs Density i udostępnić podklasę LayoutDirection Deleted DrawScope w ContentDrawScope. Zaktualizowano Painter i PainterModifier, aby nie utrzymywały już właściwości RTL, ponieważ DrawScope już ją udostępnia bez ręcznego podawania (I1798e).

• Zmiana nazwy funkcji Emphasis.emphasize() na Emphasis.applyEmphasis() (Iceebe)

• Wyłączone przyciski są teraz wizualnie zgodne ze specyfikacją Material Design (I47dcb, b/155076924).

• Komponent FilledTextField obsługuje teraz działanie IME, transformację wizualną i typ klawiatury (I1f9cf, b/155075201).

• Dodaje parametr strokeWidth do CircularProgressIndicator, aby dostosować rozmiar obrysu. Aby zmienić rozmiar (wysokość) paska LinearProgressIndicator, możesz użyć Modifier.preferredHeight() lub innego modyfikatora rozmiaru. (Icea16, b/154919081)

• Dodaje parametr strokeWidth do CircularProgressIndicator, aby dostosować rozmiar obrysu. Aby zmienić rozmiar (wysokość) paska LinearProgressIndicator, możesz użyć Modifier.preferredHeight() lub innego modyfikatora rozmiaru. (Icea16, b/154919081)

• Dodano interfejs API slotu dla ikon na początku i na końcu komponentu FilledTextField oraz obsługę stanu błędu (Ic12e0).

• Domyślny kolor przycisków FAB i rozszerzonych przycisków FAB został zmieniony na MaterialTheme.colors.secondary. (I3b9b9, b/154118816)

• Zastąpiono wszystkie użycia wartości Color, które mogą przyjmować wartość null, w interfejsie API wartościami, które nie mogą przyjmować wartości null, i zamiast wartości null użyto wartości Color.Unset (Iabaa7).

• Zmieniono nazwę EdgeInsets na InnerPadding. Zmieniono nazwę parametru innerPadding w przypadku przycisków Material na padding. (I66165)

• Suwak jest teraz bezstanowy. Użytkownicy będą musieli samodzielnie przekazywać i aktualizować stan, tak jak w przypadku innych elementów sterujących. (Ia00aa)

• Usunięto komponent StaticDrawer. Jeśli jest to konieczne, użyj elementu Box o szerokości określonej w specyfikacji materiału (I244a7).

• Dodano implementację pola tekstowego wypełnionego w Material Design (Ic75cd)

• Dodano parametr modyfikatora do elementu ListItem i zmieniono kolejność parametrów, aby promować końcową treść wyrażenia lambda (I66e21)

• Dodaje parametr konstruktora defaultFontFamily do klasy Typography, co umożliwia określenie domyślnej rodziny czcionek, która będzie używana w przypadku wszystkich podanych stylów tekstów, które nie mają ustawionej rodziny. (I89d07)

• Tymczasowo usunęliśmy tabele danych o materiałach z interfejsu API. (Iaea61)

• Zmiana nazw parametrów w funkcji kompozycyjnej Divider (Ic4373)

• dzieci (Ia6d19)

• Usuwa MaterialTheme.emphasisLevels. Zamiast tego użyj EmphasisAmbient.current, aby pobrać poziomy podkreślenia (Ib5e40).

• System motywów kształtów został zaktualizowany zgodnie ze specyfikacją Material Design. Teraz możesz podać małe, średnie i duże kształty, które będą używane przez większość komponentów (Ifb4d1).

• Zmieniliśmy interfejsy API MaterialTheme, takie jak MaterialTheme.colors() i MaterialTheme.typography(), tak aby były właściwościami, a nie funkcjami. Usuń nawiasy z dotychczasowych wywołań. Nie powinno to spowodować żadnych zmian w działaniu. (I3565a)

• Przebudowano interfejsy API FloatingActionButton, aby akceptowały lambdy z funkcjami kompozycyjnymi zamiast typów prostych. Zobacz zaktualizowane przykłady, aby uzyskać informacje o użytkowaniu. (I00622)

• dodanie parametru enabled do komponentów Checkbox, Switch i Toggleable (I41c16)

• Efekt falowania jest teraz modyfikatorem. Dopóki Clickable nie zostanie przekonwertowany, zalecane jest użycie Clickable(onClick = { ... }, modifier = ripple()) (Ie5200, b/151331852, b/150060763).

• Komponenty Surface i Card zostały przeniesione z androidx.ui.material.surface do androidx.ui.material (I88a6d, b/150863888).

• Komponenty Button, FloatingActionButton i Clickable mają teraz osobny parametr enabled. Niektóre parametry w przypadku przycisku zmieniły nazwę lub kolejność. (I54b5a)

• Zmieniliśmy nazwę Image na ImageAsset, aby lepiej odróżnić dane Image od nadchodzącego komponentu Image, który będzie używany do tworzenia układu i rysowania treści. _Body:Utworzono metodę rozszerzenia w klasie android.graphics.Bitmap, Bitmap.asImageAsset(), aby utworzyć instancję klasy ImageAsset przydatną do łączenia tradycyjnego tworzenia aplikacji na Androida z platformą Compose (Id5bbd).

• Usunęliśmy interfejs Snackbar API z parametrami String na rzecz przeciążenia, które akceptuje lambdy z możliwością komponowania. Zobacz zaktualizowane przykłady informacji o użyciu (I55f80)

• Przebudowano interfejsy API kart, aby akceptowały wyrażenia lambda text i icon (Ia057e).

• Dodano komponent BottomNavigation. Informacje o sposobie użycia znajdziesz w dokumentacji i przykładach (I731a0).

• Dodano komponenty Icon, IconButton i IconToggleButton, a usunięto AppBarIcon. Możesz bezpośrednio zastąpić istniejące użycia AppBarIcon elementem IconButton, a będą one teraz miały prawidłowy docelowy element dotykowy. Informacje o użyciu znajdziesz w przykładach, a w sekcji Ikony znajdziesz udostępnione ikony Material Icons, których możesz używać bezpośrednio w tych komponentach. (I96849)

• Zastąpiono ButtonStyle odrębnymi funkcjami i usunięto przeciążenie tekstu (ciągu znaków). Informacje o użytkowaniu znajdziesz w zaktualizowanych przykładach. (If63ab, b/146478620, b/146482131)

• zmiana nazwy modyfikatora Border na DrawBorder (I8ffcc)

• W przypadku elementu LayoutCoordinates nie ma już właściwości position. Właściwość position nie ma sensu w przypadku modyfikatorów układu, obrotu ani skalowania. Zamiast tego programiści powinni używać funkcji parentCoordinates i childToLocal() do obliczania przekształcenia z jednego obiektu LayoutCoordinate na inny.

  W przypadku właściwości size w klasie LayoutCoordinates używany jest typ IntPxSize zamiast PxSize. Układy korzystają z rozmiarów w pikselach, więc wszystkie rozmiary układów powinny być liczbami całkowitymi, a nie wartościami zmiennoprzecinkowymi. (I9367b)

• Zmiany powodujące niezgodność w interfejsie API ambients. Szczegółowe informacje znajdziesz w dzienniku i Ambient<T> dokumentacji (I4c7ee, b/143769776).

• Dodano komponent materiału rusztowania. Narzędzia do rusztowań (I7731b)

• Zastąpiono funkcję DrawBorder modyfikatorem obramowania (Id335a).

Poprawki błędów

• FocusModifier został wycofany na rzecz Modifier.focus, Modifier.focusRequester i Modifier.focusObserver. Stany FocusState i FocusDetailedState zostały wycofane na rzecz stanu FocusState2 (I46919, b/160822875, b/160922136).
• Komponenty VerticalScroller i HoriziontalScroller zostały wycofane. Użyj komponentów ScrollableColumn i ScrollableRow, aby wbudować funkcje z zachowaniem i parametrami Column/Row, lub użyj modyfikatorów Modifier.verticalScroll i Modifier.horizontalScroll we własnym elemencie. Podobnie klasa ScrollerPosition została wycofana na rzecz klasy ScrollState' (I400ce, b/157225838, b/149460415, b/154105299).
• Interfejsy API Modifier.draggable i Modifier.scrollable zostały zmodyfikowane. Właściwość DragDirection została usunięta na rzecz właściwości Orientation. Wymaganie dotyczące stanu w przypadku elementów przewijanych zostało uproszczone. Klasa ScrollableState została zmieniona na ScrollableController (Iab63c, b/149460415).
• Nazwa została zmieniona z runOnIdleCompose na runOnIdle (I83607)
• Właściwości semantyczne z jedną wartością używają teraz stylu wywoływania. Na przykład „semantics { hidden = true }” jest teraz zapisywane jako „semantics { hidden() }”. (Ic1afd, b/145951226, b/145955412)
• Zmieniliśmy nazwy kilku interfejsów API do testowania, aby były bardziej intuicyjne. Wszystkie interfejsy API findXYZ zostały zmienione na onNodeXYZ. Wszystkie interfejsy API doXYZ zostały zmienione na performXYZ. (I7f164)
• Interfejs Transition API został zmieniony tak, aby zwracał wartość TransitionState zamiast przekazywać ją do elementów podrzędnych. Dzięki temu interfejs API jest bardziej spójny z interfejsami animate(). (I24e38)
• Dodano klasę jednostki IntBounds, która reprezentuje granice pikseli w układzie. Interfejs API PopupPositionProvider został zaktualizowany, aby z niego korzystać. (I0d8d0, b/159596546)
• Do narzędzi do wyszukiwania testów dodaliśmy nowy opcjonalny flag useUnmergedTree. (I2ce48)
• Usunięto nieaktualne interfejsy API do testowania rozmiaru. (Iba0a0)
• Usunięto klasę wbudowaną Shader, która opakowywała klasę oczekiwaną NativeShader. Zmieniono nazwę klasy NativeShader na Shader. Klasa wbudowana Shader nie wnosiła niczego wartościowego do interfejsu API i była klasą wbudowaną, więc używaj bezpośrednio klasy NativeShader. (I25e4d)
• Wyskakujące okienka, okna dialogowe i menu dziedziczą teraz kontekstowy MaterialTheme (Ia3665, b/156527485).
• Menu DropdownMenu w Material Design są teraz przewijane. (Ide699)
• Usunięto parametr kierunku układu z bloku miary funkcji Layout(). Kierunek układu jest jednak dostępny w wywołaniu zwrotnym za pomocą obiektu zakresu pomiaru (Ic7d9d).
• W interfejsach API najwyższego poziomu używaj AnimationSpec zamiast AnimationBuilder, aby wyjaśnić koncepcję statycznej specyfikacji animacji. -Ulepsz DSL przejścia, usuwając wymaganie lambdy do tworzenia specyfikacji animacji, takich jak tween czy spring. Zamiast tego przyjmują one bezpośrednio parametry konstruktora. – Zwiększenie ogólnej łatwości użycia klasy AnimationSpec przez udostępnienie konstruktorów zamiast polegania na konstruktorach. (Ica0b4)
• Przełącznik jest teraz wyłączony, gdy wartość enabled jest ustawiona na false (If4624, b/155941869, b/159331694)
• Aby uniknąć nieporozumień z Modifier.testTag, zmieniliśmy nazwę Modifier.tag na Modifier.layoutId. (I995f0)
• Pozycje liczb całkowitych linii wyrównania zwracane przez Placeable#get(AlignmentLine) nie są już wartościami null. Jeśli wyszukiwana linia wyrównania nie istnieje, zwracana jest wartość AlignmentLine.Unspecified. (I896c5, b/158134875)

• Zmieniliśmy klasę Radius na klasę wbudowaną. Usunięto metody tworzenia elementów towarzyszących na rzecz konstruktora funkcji z parametrem domyślnym, aby promień wzdłuż osi y był zgodny z obowiązkowym parametrem promienia wzdłuż osi x.

  Zaktualizowano funkcję DrawScope.drawRoundRect, aby używała jednego parametru Radius zamiast 2 osobnych wartości zmiennoprzecinkowych dla promienia wzdłuż osi X i Y (I46d1b).

• Aby zmniejszyć liczbę klas używanych do reprezentowania informacji o pozycjonowaniu, zamiast klasy PxPosition używaj klasy Offset. Dzięki temu można korzystać z zalet klasy wbudowanej, aby używać typu long do pakowania 2 wartości zmiennoprzecinkowych reprezentujących przesunięcia x i y w postaci liczb zmiennoprzecinkowych. (I3ad98)

• W ramach dużych zmian w kodzie zastąpiliśmy użycie klasy Px w różnych klasach Compose, aby w przypadku parametrów pikseli korzystać tylko z jednostek Dp i typów prostych. Usunięto w całości klasę Px (I3ff33)

• Komponent przełączany został wycofany. Zamiast tego użyj Modifier.toggleable (I35220, b/157642842).

• W ramach dużego refaktoryzacji zastąpiono użycie klasy Px w różnych klasach kompozycji, aby w przypadku parametrów pikseli używać tylko typów Dp i pierwotnych (I086f4).

• Zastąpiono użycie klasy Px w różnych klasach Compose w ramach dużego refaktoryzacji, aby w przypadku parametrów pikseli używać tylko typów Dp i pierwotnych (Id3434).

• W ramach dużego refaktoryzacji zastąpiono użycie klasy Px w różnych klasach kompozycji, aby w przypadku parametrów pikseli używać tylko typów Dp i pierwotnych (I97a5a).

• Naprawiono problem z nieuruchamianiem funkcji onClick w przypadku elementów DropdownMenuItems. (I3998b, b/157673259)

• Element MutuallyExclusiveSetItem został wycofany. Zamiast tego użyj Modifier.selectable. (I02b47, b/157642842)

• TestTag został wycofany. Zamiast tego użyj Modifier.testTag. (If5110, b/157173105)

• Kursor w polu TextField ma animację migania (Id10a7).

• Zastąpiono użycie klasy Px w różnych klasach kompozycji w ramach dużego refaktoryzowania, aby w przypadku parametrów pikseli używać tylko typów Dp i pierwotnych (I19d02).

• Komponent VerticalScroller udostępnia teraz kolumnę od razu po wyjęciu z pudełka. Komponent HorizontalScroller udostępnia teraz wiersz od razu po wyjęciu z pudełka. (Ieca5d, b/157020670)

• W ramach dużych zmian w kodzie zastąpiono użycie klasy Px w różnych klasach kompozycji, aby w przypadku parametrów pikseli używać tylko jednostek dp i typów pierwotnych (Iede0b).

• Wycofanie wycofania właściwości Modifier.semantics, aby umożliwić używanie jej w komponentach wysokiego poziomu. (I4cfdc)

• Zmieniono interfejs API modyfikatorów DrawLayer: outlineShape zmieniono na shape i ma on teraz domyślną wartość RectangleShape oraz nie może mieć wartości null; clipToOutline zmieniono na clip; clipToBounds usunięto, ponieważ jest to to samo co clip == true z RectangleShape (I7ef11, b/155075735).

• Zaktualizowane interfejsy API wyższego poziomu Compose, które zamiast Canvas udostępniają CanvasScope. Eliminuje to konieczność utrzymywania przez konsumentów własnych obiektów Paint. Użytkownicy, którzy nadal potrzebują dostępu do elementu Canvas, mogą użyć metody drawCanvas, która zapewnia wywołanie zwrotne do wydawania poleceń rysowania za pomocą bazowego elementu Canvas. (I80afd)

• Funkcja kompozycyjna AlignmentLineOffset została wycofana. Zamiast niej używaj modyfikatora relativePaddingFrom(). Usunięto funkcję kompozycyjną CenterAlignmentLine. (I60107)

• Zmieniono interfejs API WithConstraints trailing lambda. Zamiast 2 parametrów ma teraz zakres odbiorcy, który oprócz ograniczeń i kierunku układu udostępnia właściwości minWidth, maxWidth, minHeight i maxHeight w jednostkach dp (I91b9a, b/149979702).

• Dodano modyfikator układu defaultMinSizeConstraints, który ustawia ograniczenia rozmiaru na opakowany układ tylko wtedy, gdy przychodzące odpowiednie ograniczenia nie są określone (0 w przypadku ograniczeń minimalnych i nieskończoność w przypadku ograniczeń maksymalnych). (I311ea, b/150460257)

• Usunięto FocusManagerAmbient. Aby uzyskać fokus, użyj FocusModifier.requestFocus. (Ic4826)

• Utworzono interfejs CanvasScope API, który opakowuje obiekt Canvas, aby udostępniać bezstanowy, deklaratywny interfejs API do rysowania. Przekształcenia są zawarte w odpowiednim zakresie odbiornika, a informacje o rozmiarze są również ograniczone do odpowiednich granic wstawki. Nie wymaga to od użytkownika utrzymywania własnego obiektu stanu Paint do konfigurowania operacji rysowania.

  Dodaliśmy CanvasScopeSample, a także zaktualizowaliśmy aplikację demonstracyjną, aby zawierała demonstrację grafiki deklaratywnej (Ifd86d).

• Dodanie możliwości dostosowania koloru kursora w polu TextField (I6e33f)

• Wartość TextFieldValue używana z polem TextField może teraz przetrwać ponowne utworzenie aktywności, jeśli jest używana w ten sposób: var text by savedInstanceState(saver = TextFieldValue.Saver) { TextFieldValue() } (I5c3ce, b/155075724)

• Zmieniono nazwę LayoutModifier2 na LayoutModifier. (Id29f3)

• Usunięto wycofany interfejs LayoutModifier. (I2a9d6)

• Zastąpiono parametr focusIdentifier w komponencie CoreTextField/TextField parametrem FocusNode, aby zintegrować go z podsystemem fokusu. (I7ea48)

• Funkcje pomiarów wewnętrznych w kompozycjach i modyfikatorach kompozycji 2 mają teraz odbiornik IntrinsicMeasureScope, który udostępnia interfejs API zapytań o wartości wewnętrzne z niejawnym kierunkiem kompozycji. (Id9945)

• Dodano nowy modyfikator Modifier.zIndex(), który umożliwia kontrolowanie kolejności rysowania elementów podrzędnych w tym samym układzie nadrzędnym. Właściwość elevation w modyfikatorze DrawLayerModifier została zmieniona na shadowElevation i nie kontroluje już kolejności rysowania. Zmieniono kolejność parametrów funkcji DrawShadow: pierwszy to teraz elevation, a drugi to shape z domyślnym RectangleShape. (I20150, b/152417501)

• RectangleShape przeniesiono z androidx.ui.foundation.shape.* do androidx.ui.graphics.* (Ia74d5, b/154507984)

• Aktualizacja interfejsu TextField API – scalenie wywołań zwrotnych onFocus i onBlur w jedno wywołanie zwrotne onFocusChange(Boolean) z parametrem (I66cd3)

• Dodano parametry verticalGravity i horizontalGravity do elementów Row i Column. (I7dc5a)

• Zaktualizowano funkcje wrapContentWidth i wrapContentHeight, aby oczekiwały wyrównania w pionie lub poziomie, a nie dowolnego wyrównania. Modyfikator grawitacji został zaktualizowany, aby akceptować wyrównanie w pionie lub poziomie. Wiersz, Kolumna i Stos zostały zaktualizowane, aby obsługiwać niestandardowe ciągłe wyrównania. (Ib0728)

• Utworzono interfejs PixelMap API, który umożliwia wysyłanie zapytań o informacje o pikselach z obiektu ImageAsset. (I69ad6)

• Usuwa ProvideContentColor, zamiast tego używa bezpośrednio ContentColorAmbient z Providers (Iee942).

• Moduł ui-text-compose został zmieniony na ui-text. Moduł ui-text zawiera teraz komponenty CoreText i CoreTextField (Ib7d47).

• Moduł ui-text został zmieniony na ui-text-core (I57dec).

• Przeniesiono funkcje kompozycyjne CoreText i CoreTextField z pakietu ui-framework do pakietu ui-text-compose. Możesz uwzględnić ui-text-compose w swoim projekcie. (I32042)

• Ulepszenie interfejsu DrawModifier API:

  • Zmieniono zakres odbiorcy funkcji draw() na ContentDrawScope
  • Usunięto wszystkie parametry funkcji draw()
  • DrawScope ma taki sam interfejs jak poprzednia wersja CanvasScope.
  • Interfejs ContentDrawScope ma metodę drawContent() (Ibaced, b/152919067).

• runOnIdleCompose i runOnUiThread są teraz funkcjami globalnymi, a nie metodami w ComposeTestRule. (Icbe8f)

• [Mutable]State property delegate operators moved to extensions to support Kotlin 1.4 property delegate optimizations. Aby nadal korzystać z funkcji by state { ... } lub by mutableStateOf(...), wywołujący muszą dodać importy. (I5312c)

• Dodano positionInParent i boundsInParent dla LayoutCoordinates. (Icacdd, b/152735784)

• Komponent ColoredRect został wycofany. Zamiast tego użyj Box(Modifier.preferredSize(width, height).drawBackground(color)). (I499fa, b/152753731)

• Zmieniono nazwę LayoutResult na MeasureResult. (Id8c68)

• Dodano LayoutModifier2, nowy interfejs API do definiowania modyfikatorów układu; wycofano LayoutModifier (If32ac).

• Zastąpienie operatora „Modyfikator plus” funkcjami rozszerzenia fabrycznego (I225e4)

• Funkcja Draggable została przeniesiona do modyfikatora (Id9b16, b/151959544)

• Komponent ParentData został wycofany. Możesz utworzyć modyfikator, który implementuje interfejs ParentDataModifier, lub użyć modyfikatora LayoutTag, jeśli chcesz tylko oznaczyć elementy podrzędne układu, aby można było je rozpoznać w bloku pomiaru. (I51368, b/150953183)

• Wycofany komponent Center. Należy go zastąpić modyfikatorem LayoutSize.Fill + LayoutAlign.Center lub jednym z kompozycji Box lub Stack z odpowiednimi modyfikatorami (Idf5e0).

• Dodano interfejs VectorPainter API, który zastępuje dotychczasowy interfejs subcomposition API w przypadku grafiki wektorowej. Wynikiem subkompozycji jest obiekt VectorPainter zamiast DrawModifier. Wycofano poprzednie funkcje kompozycyjne DrawVector na rzecz VectorPainter.

  Zmiana nazwy interfejsu Image(Painter) API na PaintBox(Painter). Utworzono komponent Vector, który działa jak komponent Image, ale zamiast ImageAsset używa VectorAsset (I9af9a, b/149030271).

• Zmieniono nazwę LayoutFlexible na LayoutWeight. Zmieniliśmy nazwę parametru „tight” na „fill”. (If4738)

• Usunięto RepaintBoundary na rzecz DrawLayerModifier (I00aa4)

• Funkcja DrawVector została zmieniona ze zwykłej funkcji kompozycyjnej na funkcję zwracającą modyfikator drawVector(), który rysuje wektor jako tło układu. (I7b8e0)

• Funkcja kompozycyjna Opacity została zastąpiona modyfikatorem drawOpacity. (I5fb62)

• Zastąp funkcję kompozycyjną Clip modyfikatorem drawClip(). DrawClipToBounds to wygodny modyfikator, którego możesz użyć, gdy chcesz przyciąć tylko do granic warstwy w kształcie prostokąta. (If28eb)

• Zastąpiono funkcję kompozycyjną DrawShadow modyfikatorem drawShadow(). Cienie są teraz rysowane w ramach LayerModifier. (I0317a)

• Dodano LayerModifier, modyfikator, który umożliwia dodawanie elementu RenderNode do układu. Umożliwia ustawianie przycinania, krycia, obrotu, skalowania i cieni. Zastąpi on RepaintBoundary. (I7100d, b/150774014)

• Klasa androidx.compose.ViewComposer została przeniesiona do androidx.ui.node.UiComposer. Klasa androidx.compose.Emittable została usunięta. Było to zbędne w przypadku ComponentNode. androidx.compose.ViewAdapters zostało usunięte. Nie jest to już obsługiwany przypadek użycia. Funkcja Compose.composeInto została wycofana. Użyj w zamian zasady setContent lub setViewContent. Metoda Compose.disposeComposition została wycofana. Zamiast tego użyj metody dispose na obiekcie Composition zwróconym przez setContent. androidx.compose.Compose.subcomposeInto zostało przeniesione do androidx.ui.core.subcomposeInto ComponentNode#emitInsertAt zostało zmienione na ComponentNode#insertAt ComponentNode#emitRemoveAt zostało zmienione na ComponentNode#removeAt ComponentNode#emitMode zostało zmienione na ComponentNode#move (Idef00)

• Utworzono komponent CreatedImage, który obsługuje rozmiar i układ, a także rysuje na ekranie dany element ImageAsset. Ten komponent obsługuje też rysowanie dowolnej instancji Painter z uwzględnieniem jej rozmiaru wewnętrznego oraz obsługę danego stałego lub minimalnego rozmiaru (Ibcc8f).

• Wycofany komponent Wrap. Można go zastąpić modyfikatorem LayoutAlign lub funkcją kompozycyjną Stack (Ib237f).

• W funkcji WithConstraints dodano parametr LayoutDirection (I6d6f7)

• Umożliwiono propagowanie kierunku układu z węzła układu nadrzędnego do węzłów podrzędnych. Dodano modyfikator kierunku układu. (I3d955)

• Komponent Stack obsługuje kierunek od prawej do lewej (Ic9e00)

• Funkcja kompozycyjna DrawShape została usunięta. Zamiast tego użyj modyfikatora DrawBackground. (I7ceb2)

• Obsługa kierunku od prawej do lewej w modyfikatorze LayoutPadding (I9e8da)

• Dodano komponent AdapterList, czyli listę przewijaną, która tylko tworzy i układa widoczne elementy. Obecnie znane problemy obejmują to, że jest on tylko pionowy i nie obsługuje w pełni wszystkich przypadków zmian w jego elementach podrzędnych. (Ib351b)

• Zaktualizowano flagę ComposeFlags.COMPOSER_PARAM na true, co zmieni strategię generowania kodu w przypadku wtyczki do pisania. W dużym uproszczeniu powoduje to generowanie funkcji z adnotacją @Composable z dodatkowym parametrem syntetycznym, który jest przekazywany do kolejnych wywołań funkcji z adnotacją @Composable, aby środowisko wykonawcze mogło prawidłowo zarządzać wykonaniem. Jest to istotna zmiana binarna, która jednak powinna zachować zgodność na poziomie kodu źródłowego we wszystkich dozwolonych przypadkach użycia funkcji Compose. (I7971c)

• Dodano komponent Canvas. Ten komponent zajmuje określony rozmiar (podany przez użytkownika) i umożliwia rysowanie za pomocą CanvasScope (I0d622).

• Połączyliśmy interfejsy Density i DensityScope w jeden. Zamiast ambientDensity() możesz teraz używać DensityAmbient.current. Zamiast withDensity(density) używaj with(density) (I11cb1)

• Zmieniono LayoutCoordinates, aby providedAlignmentLines było zbiorem zamiast mapy, a LayoutCoordinates implementowało operatora get() zamiast pobierania wartości. Ułatwia to modyfikatorom modyfikowanie co najmniej 1 wartości zestawu bez tworzenia nowej kolekcji dla każdego modyfikatora. (I0245a)

• Elementy przewijane działają teraz tak jak w przypadku gestu szybkiego przesunięcia na urządzeniach z Androidem. (I922af, b/147493715)

• Ulepszenia interfejsu API ograniczeń (I0fd15)