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 touchpada i inne funkcje. Mamy też kilka eksperymentalnych interfejsów API, które chcielibyśmy, abyście wypróbowali i przekazali nam swoje opinie.

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 coroutine w testach

Wprowadzamy dużą aktualizację sposobu, w jaki Compose obsługuje czas testu. Po okresie dobrowolnego przejścia 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ł coroutine, a interfejsy API w wersji 2 używają StandardTestDispatcher. Oznacza to, że gdy w testach uruchamiana jest coroutine, jest ona teraz umieszczana w kolejce i nie jest wykonywana, dopóki nie zostanie przesunięty zegar wirtualny.

Dzięki temu lepiej symulowane są warunki produkcyjne, co skutecznie eliminuje warunki wyścigu i sprawia, że zestaw testów jest znacznie bardziej niezawodny i mniej podatny na błędy.

Aby mieć pewność, że testy są zgodne ze standardowym zachowaniem coroutine 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 w tle – np. granice docelowe, trajektorie animacji i liczbę znalezionych dopasowań. Dzięki temu łatwiej jest wykryć, dlaczego przejście może nie działać zgodnie z oczekiwaniami. Aby korzystać z 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 touchpada

Ulepszyliśmy obsługę touchpadów w Compose, takich jak wbudowane touchpady w laptopach, touchpady dołączane do tabletów oraz touchpady zewnętrzne i wirtualne. Podstawowe zdarzenia touchpada będą teraz ogólnie traktowane jako zdarzenia PointerType.Mouse, co sprawi, że zachowanie myszy i touchpada będzie lepiej odpowiadać oczekiwaniom użytkowników. Wcześniej te zdarzenia touchpada 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ą touchpada 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ą touchpada nie będzie już powodować przewijania.

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

Te zmiany poprawiają działanie touchpadów w przypadku wbudowanych komponentów, usuwając zbędne marginesy dotykowe, wprowadzając bardziej intuicyjny gest rozpoczęcia 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 touchpada, dostępne są nowe interfejsy API testowania z performTrackpadInput, które umożliwiają sprawdzenie działania aplikacji podczas korzystania z touchpada. 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, touchpadów i rysików, oraz upewnij się, że obsługują one kółka myszy i gesty touchpada.

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 lepiej obsługuje Kotlin Multiplatform. Aby połączyć te wartości z drzewem kompozycji, autorzy bibliotek mogą użyć compositionLocalWithHostDefaultOf do utworzenia CompositionLocal, który rozwiązuje domyślne ustawienia 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 przejść do innego elementu 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 opublikowanych 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 wprowadzamy te interfejsy API jako @Experimental. Czekamy na Twoje opinie, 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 do stylizowania. Interfejs Style API to nowy paradygmat dostosowywania wizualnych elementów komponentów, który tradycyjnie był realizowany za pomocą modyfikatorów. Został on zaprojektowany tak, aby umożliwiać głębsze i łatwiejsze dostosowywanie przez udostępnianie standardowego zestawu właściwości, które można stylizować, z prostym stylizowaniem opartym na stanie i animowanymi przejściami. 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 mediaQuery API 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 ponowne komponowanie 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 aplikacje. 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 zakresów siatki, aby reagować na stany urządzenia, takie jak tryb tabletop czy zmiany orientacji, dzięki czemu interfejs będzie wyglądać świetnie na różnych urządzeniach.

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, ciekawym 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 Twoje opinie i prośby o funkcje (zwłaszcza w przypadku funkcji @Experimental, które są jeszcze w fazie testów) – zgłaszaj je tutaj. Miłego komponowania!