Co nowego w wersji Jetpack Compose z kwietnia 2026 r.

Wersja Jetpack Compose z kwietnia 2026 r. jest już stabilna. Zawiera ona wersję 1.11 podstawowych modułów Compose (pełne mapowanie BOM), narzędzia do debugowania elementów współdzielonych, zdarzenia trackpada i inne funkcje. Mamy też kilka eksperymentalnych interfejsów API, które chcielibyśmy, abyś wypróbował(a) i przekazał(a) nam opinię.

Aby korzystać z dzisiejszej wersji, zaktualizuj wersję Compose BOM do:

implementation(platform("androidx.compose:compose-bom:2026.04.01"))

Zmiany w Compose 1.11.0

Wykonanie korutyny w testach

Wprowadzamy dużą aktualizację sposobu, w jaki Compose obsługuje czas testu. Po okresie rezygnacji ogłoszonym w Compose 1.10 interfejsy API testowania w wersji 2 są teraz domyślne, a interfejsy API w wersji 1 zostały wycofane. Kluczową zmianą jest przejście na domyślny dyspozytor testów. Interfejsy API w wersji 1 korzystały z UnconfinedTestDispatcher, który natychmiast wykonywał korutyny, a interfejsy API w wersji 2 używają StandardTestDispatcher. Oznacza to, że gdy współprogram zostanie uruchomiony w testach, zostanie on umieszczony w kolejce i nie będzie wykonywany, dopóki nie zostanie przesunięty zegar wirtualny.

Dzięki temu lepiej naśladujemy warunki produkcyjne, skutecznie eliminujemy warunki wyścigu i sprawiamy, że pakiet testów jest znacznie bardziej niezawodny i mniej podatny na błędy.

Aby mieć pewność, że testy są zgodne ze standardowym zachowaniem współprogramu i uniknąć przyszłych problemów ze zgodnością, zdecydowanie zalecamy migrację zestawu testów. Mapowania interfejsów API i typowe poprawki znajdziesz w naszym obszernym przewodniku migracji.

Ulepszenia elementów współdzielonych i narzędzia do animacji

Dodaliśmy też przydatne narzędzia do debugowania wizualnego elementów współdzielonych i Modifier.animatedBounds. Teraz możesz dokładnie zobaczyć, co się dzieje pod maską – np. granice docelowe, trajektorie animacji i liczbę znalezionych dopasowań – co znacznie ułatwia wykrycie, dlaczego przejście może nie działać zgodnie z oczekiwaniami. Aby użyć nowych narzędzi, po prostu otocz element SharedTransitionLayout elementem kompozycyjnym LookaheadAnimationVisualDebugging. 

LookaheadAnimationVisualDebugging(
    overlayColor = Color(0x4AE91E63),
    isEnabled = true,
    multipleMatchesColor = Color.Green,
    isShowKeylabelEnabled = false,
    unmatchedElementColor = Color.Red,
) {
    SharedTransitionLayout {
        CompositionLocalProvider(
            LocalSharedTransitionScope provides this,
        ) {
            // your content
        }
    }
}

Zdarzenia trackpada

Przebudowaliśmy obsługę trackpadów w Compose, takich jak wbudowane trackpady laptopów, trackpady dołączane do tabletów oraz trackpady zewnętrzne i wirtualne. Podstawowe zdarzenia trackpada będą teraz ogólnie traktowane jako zdarzenia PointerType.Mouse, co spowoduje, że zachowanie myszy i trackpada będzie lepiej odpowiadać oczekiwaniom użytkowników. Wcześniej te zdarzenia trackpada były interpretowane jako fałszywe palce dotykowe PointerType.Touch, co prowadziło do mylących wrażeń użytkownika. Na przykład kliknięcie i przeciągnięcie za pomocą trackpada powodowało przewijanie zamiast zaznaczania. Dzięki zmianie typu wskaźnika, który mają te zdarzenia w najnowszej wersji Compose, kliknięcie i przeciągnięcie za pomocą trackpada nie będzie już powodować przewijania.

Dodaliśmy też obsługę bardziej skomplikowanych gestów trackpada rozpoznawanych przez platformę od interfejsu API 34, w tym przesunięć dwoma palcami i uszczypnięć. Te gesty są automatycznie rozpoznawane przez komponenty takie jak Modifier.scrollable i Modifier.transformable, co zapewnia lepsze działanie z trackpadami.

Te zmiany poprawiają działanie trackpadów w przypadku wbudowanych komponentów, usuwając zbędne marginesy dotykowe, wprowadzając bardziej intuicyjny gest przeciągania i upuszczania, wybieranie przez dwukrotne i trzykrotne kliknięcie w polach tekstowych oraz menu kontekstowe w polach tekstowych w stylu komputerowym.

Aby przetestować działanie trackpada, dostępne są nowe interfejsy API testowania z performTrackpadInput, które umożliwiają sprawdzenie działania aplikacji podczas korzystania z trackpada. Jeśli masz niestandardowe detektory gestów, sprawdź ich działanie w przypadku różnych typów danych wejściowych, w tym ekranów dotykowych, myszy, trackpadów i rysików, oraz upewnij się, że obsługują one kółka myszy i gesty trackpada.

Domyślne ustawienia hosta kompozycji (środowisko wykonawcze Compose)

Wprowadziliśmy HostDefaultProvider, LocalHostDefaultProvider, HostDefaultKey i ViewTreeHostDefaultKey, aby udostępniać usługi na poziomie hosta bezpośrednio za pomocą środowiska wykonawczego Compose. Dzięki temu biblioteki nie muszą już polegać na compose-ui w przypadku wyszukiwania, co zapewnia lepszą obsługę Kotlin Multiplatform. Aby połączyć te wartości z drzewem kompozycji, autorzy bibliotek mogą użyć compositionLocalWithHostDefaultOf do utworzenia CompositionLocal, który rozwiązuje wartości domyślne z hosta.

Otoczki podglądu

Niestandardowe podglądy w Android Studio to nowa funkcja, która pozwala dokładnie określić, jak mają być wyświetlane treści podglądu Compose.

Implementując interfejs PreviewWrapperProvider i stosując nową adnotację @PreviewWrapper, możesz łatwo wstrzykiwać niestandardową logikę, np. stosować określony Theme. Adnotację można zastosować do funkcji oznaczonej adnotacjami @Composable i @Preview lub @MultiPreview, co zapewnia ogólne, łatwe w użyciu rozwiązanie, które działa w przypadku funkcji podglądu i znacznie zmniejsza ilość powtarzającego się kodu.

class ThemeWrapper: PreviewWrapperProvider {
    @Composable
    override fun Wrap(content: @Composable (() -> Unit)) {
        JetsnackTheme {
            content()
        }
    }
}


@PreviewWrapper(ThemeWrapper::class)
@Preview
@Composable
private fun ButtonPreview() {
    // JetsnackTheme in effect
    Button(onClick = {}) {
        Text(text = "Demo")
    }
}

Wycofania i usunięcia

• Zgodnie z zapowiedzią w poście na blogu o Compose 1.10 wycofujemy Modifier.onFirstVisible(). Jej nazwa często prowadziła do nieporozumień, zwłaszcza w przypadku układów leniwych, gdzie była wywoływana wielokrotnie podczas przewijania. Zalecamy migrację do Modifier.onVisibilityChanged(), która umożliwia dokładniejsze ręczne śledzenie stanów widoczności dostosowanych do konkretnych wymagań.
• Flaga ComposeFoundationFlags.isTextFieldDpadNavigationEnabled została usunięta, ponieważ nawigacja za pomocą pada kierunkowego w przypadku TextFields jest teraz domyślnie zawsze włączona. Nowe zachowanie zapewnia, że zdarzenia pada kierunkowego z gamepada lub pilota telewizora najpierw przesuwają kursor w danym kierunku. Fokus może przenieść się na inny element tylko wtedy, gdy kursor dotrze do końca tekstu.

Nadchodzące interfejsy API

W nadchodzącej wersji Compose 1.12.0 compileSdk zostanie zaktualizowany do compileSdk 37, a AGP 9 oraz wszystkie aplikacje i biblioteki, które zależą od Compose, będą dziedziczyć to wymaganie. Zalecamy korzystanie z najnowszych wersji, ponieważ Compose ma na celu szybkie wdrażanie nowych compileSdks, aby zapewnić dostęp do najnowszych funkcji Androida. Więcej informacji o tym, która wersja AGP jest obsługiwana w przypadku różnych poziomów interfejsu API, znajdziesz w dokumentacji. 

W Compose 1.11.0 te interfejsy API są wprowadzane jako @Experimental. Czekamy na Twoją opinię, gdy będziesz je testować w swoich aplikacjach. Pamiętaj, że @Experimental APIs są udostępniane do wczesnej oceny i opinii i mogą ulec znacznym zmianom lub zostać usunięte w przyszłych wersjach.

Style (wersja eksperymentalna)

Wprowadzamy nowy eksperymentalny interfejs API podstawowy do stylizacji. Interfejs Style API to nowy paradygmat dostosowywania wizualnych elementów komponentów, który tradycyjnie był realizowany za pomocą modyfikatorów. Został zaprojektowany tak, aby umożliwiać głębsze i łatwiejsze dostosowywanie dzięki udostępnianiu zestawu standardów właściwości, które można stylizować za pomocą prostych stylów opartych na stanie i animowanych przejść. Dzięki temu nowemu interfejsowi API widzimy już obiecujące korzyści w zakresie wydajności. Planujemy wdrożyć style w komponentach Material, gdy interfejs Style API będzie stabilny.

Podstawowy przykład zastępowania tła stylu stanu naciśnięcia:

@Composable
fun LoginButton(modifier: Modifier = Modifier) {
    Button(
        onClick = {
            // Login logic
        },
        modifier = modifier,
        style = {
            background(
                Brush.linearGradient(
                    listOf(lightPurple, lightBlue)
                )
            )
            width(75.dp)
            height(50.dp)
            textAlign(TextAlign.Center)
            externalPadding(16.dp)

            pressed {
                background(
                    Brush.linearGradient(
                        listOf(Color.Magenta, Color.Red)
                    )
                )
            }
        }
    ){
        Text(
            text = "Login",
        )
    }
}

Zapoznaj się z dokumentacją i zgłoś błędy tutaj.

MediaQuery (wersja eksperymentalna)

Nowy interfejs API mediaQuery zapewnia deklaratywny i wydajny sposób dostosowywania interfejsu do jego środowiska. Abstrahuje on złożone pobieranie informacji do prostych warunków w UiMediaScope, dzięki czemu ponowna kompozycja następuje tylko wtedy, gdy jest to konieczne.

Dzięki obsłudze szerokiego zakresu sygnałów środowiskowych – od możliwości urządzenia, takich jak typy klawiatur i precyzja wskaźnika, po stany kontekstowe, takie jak rozmiar okna i pozycja – możesz tworzyć wysoce responsywne treści. Wydajność jest wbudowana w derivedMediaQuery, aby obsługiwać aktualizacje o wysokiej częstotliwości, a możliwość zastępowania zakresów sprawia, że testowanie i podglądy są bezproblemowe w różnych konfiguracjach sprzętowych. Wcześniej, aby uzyskać dostęp do niektórych właściwości urządzenia – np. czy urządzenie jest w trybie tabletop – trzeba było napisać dużo kodu boilerplate: 

@Composable
fun isTabletopPosture(
    context: Context = LocalContext.current
): Boolean {
    val windowLayoutInfo by
        WindowInfoTracker
            .getOrCreate(context)
            .windowLayoutInfo(context)
            .collectAsStateWithLifecycle(null)

    return windowLayoutInfo.displayFeatures.any { displayFeature ->
        displayFeature is FoldingFeature &&
            displayFeature.state == FoldingFeature.State.HALF_OPENED &&
            displayFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
    }
}

@Composable
fun VideoPlayer() {
    if(isTabletopPosture()) {
        TabletopLayout()
    } else {
        FlatLayout()
    }
}

Teraz dzięki UIMediaQuery możesz dodać składnię mediaQuery, aby wysyłać zapytania o właściwości urządzenia, np. czy urządzenie jest w trybie tabletop:

@OptIn(ExperimentalMediaQueryApi::class)
@Composable
fun VideoPlayer() {
    if (mediaQuery { windowPosture == UiMediaScope.Posture.Tabletop }) {
        TabletopLayout()
    } else {
        FlatLayout()
    }
}

Zapoznaj się z dokumentacją i zgłoś błędy tutaj.

Grid (wersja eksperymentalna)

Grid to nowy, zaawansowany interfejs API do tworzenia złożonych układów dwuwymiarowych w Jetpack Compose. Chociaż Row i Column świetnie sprawdzają się w przypadku projektów liniowych, Grid zapewnia kontrolę strukturalną potrzebną do tworzenia architektury na poziomie ekranu i złożonych komponentów bez obciążenia związanego z przewijaną listą. Grid umożliwia definiowanie układu za pomocą ścieżek, odstępów i komórek, oferując znane opcje rozmiaru, takie jak Dp, procenty, rozmiary treści wewnętrznej i elastyczne jednostki „Fr”.

@OptIn(ExperimentalGridApi::class)
@Composable
fun GridExample() {
    Grid(
        config = {
            repeat(4) { column(0.25f) }
            repeat(2) { row(0.5f) }
            gap(16.dp)
        }
    ) {
        Card1(modifier = Modifier.gridItem(rowSpan = 2)
        Card2(modifier = Modifier.gridItem(colmnSpan = 3)
        Card3(modifier = Modifier.gridItem(columnSpan = 2)
        Card4()
    }
}

Możesz umieszczać elementy automatycznie lub jawnie rozciągać je na wiele wierszy i kolumn, aby uzyskać precyzję. Co najważniejsze, jest on wysoce adaptacyjny – możesz dynamicznie zmieniać konfigurację ścieżek i rozpiętości siatki, aby reagować na stany urządzenia, takie jak tryb tabletop lub zmiany orientacji, dzięki czemu interfejs będzie wyglądać świetnie w różnych formatach.

Zapoznaj się z dokumentacją i zgłoś błędy tutaj. 

FlexBox (wersja eksperymentalna)

FlexBox to kontener układu zaprojektowany z myślą o wysokiej wydajności i adaptacyjnych interfejsach. Zarządza on rozmiarem elementów i rozmieszczeniem przestrzeni na podstawie dostępnych wymiarów kontenera.Obsługuje złożone zadania, takie jak zawijanie (wrap) i wyrównywanie elementów w wielu osiach (justifyContent, alignItems, alignContent). Umożliwia powiększanie (grow) lub zmniejszanie (shrink) elementów, aby wypełnić kontener. 

@OptIn(ExperimentalFlexBoxApi::class)
fun FlexBoxWrapping(){
    FlexBox(
        config = {
            wrap(FlexWrap.Wrap)
            gap(8.dp)
        }
    ) {
        RedRoundedBox()
        BlueRoundedBox()
        GreenRoundedBox(modifier = Modifier.width(350.dp).flex { grow(1.0f) })
        OrangeRoundedBox(modifier = Modifier.width(200.dp).flex { grow(0.7f) })
        PinkRoundedBox(modifier = Modifier.width(200.dp).flex { grow(0.3f) })
    }
}

Zapoznaj się z dokumentacją i zgłoś błędy tutaj.

Nowa implementacja SlotTable (wersja eksperymentalna)

Wprowadziliśmy nową implementację SlotTable, która jest domyślnie wyłączona w tej wersji. SlotTable to wewnętrzna struktura danych, której środowisko wykonawcze Compose używa do śledzenia stanu hierarchii kompozycji, śledzenia unieważnień i ponownych kompozycji, przechowywania zapamiętanych wartości oraz śledzenia wszystkich metadanych kompozycji w czasie działania. Ta nowa implementacja ma na celu poprawę wydajności, zwłaszcza w przypadku losowych edycji.

Aby wypróbować nowy SlotTable, włącz ComposeRuntimeFlags.isLinkBufferComposerEnabled. 

Zacznij kodować już dziś!

Dzięki tak wielu nowym, interesującym interfejsom API w Jetpack Compose i wielu kolejnym, które są w przygotowaniu, migracja do Jetpack Compose nigdy nie była tak korzystna.Jak zawsze, cenimy Twoją opinię i prośby o funkcje (zwłaszcza w przypadku @Experimental funkcji, które są jeszcze w fazie testów) – zgłaszaj je tutaj. Miłego tworzenia!