Wersja Jetpack Compose z kwietnia 2026 r. jest już stabilna. Ta wersja zawiera 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

Wykonywanie korutyn w testach

Wprowadzamy ważną 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ł korutyny, a interfejsy API w wersji 2 używają StandardTestDispatcher. Oznacza to, że gdy współprogram zostanie uruchomiony w testach, będzie teraz umieszczany w kolejce i nie zostanie wykonany, dopóki nie zostanie przesunięty zegar wirtualny.

Dzięki temu lepiej symulujemy 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ółprogramów, 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. Możesz teraz dokładnie zobaczyć, co się dzieje w tle – np. granice docelowe, trajektorie animacji i liczbę znalezionych dopasowań. Dzięki temu łatwiej zauważysz, 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 pozwoli lepiej dopasować zachowanie myszy i touchpada do oczekiwań 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 te zdarzenia mają 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ęć dwoma 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ą zbędne marginesy dotykowe, wprowadzają bardziej intuicyjny gest rozpoczęcia przeciągania i upuszczania, umożliwiają zaznaczanie tekstu w polach tekstowych za pomocą dwukrotnego i trzykrotnego kliknięcia oraz dodają menu kontekstowe w stylu desktopowym w polach tekstowych.

Aby przetestować działanie touchpada, dostępne są nowe interfejsy API testowania z performTrackpadInput, która umożliwia sprawdzanie 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 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óra rozwiązuje domyślne ustawienia hosta.

Otoczki podglądu

Niestandardowe podglądy w Android Studio to nowa funkcja, która umożliwia dokładne określenie sposobu wyświetlania zawartoś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 i ł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: PreviewWrapper {
    @Composable
    override fun Wrap(content: @Composable (() -> Unit)) {
        JetsnackTheme {
            content()
        }
    }
}

@PreviewWrapperProvider(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, odziedziczą 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 Twoją opinię, gdy będziesz je testować w swoich aplikacjach. Pamiętaj, że @Experimental APIs są udostępniane do wczesnej oceny i przekazywania opinii. W przyszłych wersjach mogą ulec znacznym zmianom lub zostać usunięte.

Style (wersja eksperymentalna)

Wprowadzamy nowy eksperymentalny interfejs API podstawowy do stylizowania. Interfejs Style API to nowy paradygmat dostosowywania elementów wizualnych komponentów, który tradycyjnie był realizowany za pomocą modyfikatorów. Został 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 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 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 rozpiętości siatki, aby reagować na stany urządzenia, takie jak tryb tabletop czy 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 zwiększenie wydajności, zwłaszcza w przypadku losowych edycji.

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

Zacznij kodować już dziś!

W Jetpack Compose jest tak wiele nowych, ciekawych interfejsów API, a wiele kolejnych jest w drodze, że 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!