Obecnie wersja Jetpack Compose z kwietnia 2026 r. jest stabilna. Ta wersja zawiera moduły podstawowe Compose w wersji 1.11 (pełne mapowanie listy materiałów), narzędzia do debugowania wspólnych elementów, zdarzenia touchpada i inne funkcje. Mamy też kilka eksperymentalnych interfejsów API, które chcielibyśmy, abyś wypróbował(-a) i przekazał(-a) nam swoją opinię.

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

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

Zmiany w Compose 1.11.0

Wykonywanie współprogramów w testach

Wprowadzamy ważną aktualizację sposobu, w jaki Compose obsługuje czas testu. Po okresie przystąpienia do programu 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 zmiana domyślnego dyspozytora 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 w testach uruchomisz współprogram, zostanie on umieszczony w kolejce i nie będzie wykonywany, dopóki nie zostanie przesunięty zegar wirtualny.

Dzięki temu lepiej odzwierciedlisz warunki produkcyjne, skutecznie wyeliminujesz sytuacje wyścigu i sprawisz, że zestaw testów będzie znacznie bardziej niezawodny i mniej podatny na błędy.

Aby mieć pewność, że testy są zgodne ze standardowym działaniem współprogramów, i uniknąć problemów ze zgodnością w przyszłości, zdecydowanie zalecamy przeniesienie zestawu testów. Zapoznaj się z naszym kompleksowym przewodnikiem po migracji, w którym znajdziesz mapowania interfejsów API i częste rozwiązania problemów.

Ulepszenia dotyczące udostępnionych elementów i narzędzia do animacji

Dodaliśmy też przydatne narzędzia do wizualnego debugowania udostępnionych elementów i Modifier.animatedBounds. Teraz możesz dokładnie zobaczyć, co się dzieje w tle – 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, wystarczy otoczyć element SharedTransitionLayout kompozycją LookaheadAnimationVisualDebugging. 

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

Zdarzenia związane z trackpadem

Ulepszyliśmy obsługę funkcji Pisanie na trackpadach, takich jak wbudowane trackpady laptopów, trackpady dołączane do tabletów czy zewnętrzne/wirtualne trackpady. 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 na trackpadzie były interpretowane jako fałszywe dotknięcia ekranu przez palce PointerType.Touch, co powodowało zamieszanie u użytkowników. Na przykład kliknięcie i przeciągnięcie na trackpadzie spowoduje przewinięcie, a nie zaznaczenie. W najnowszej wersji Compose zmieniliśmy typ wskaźnika, więc klikanie i przeciąganie za pomocą trackpada nie będzie już powodować przewijania.

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

Zmiany te poprawiają działanie trackpadów w komponentach wbudowanych. Usunęliśmy zbędne opóźnienie dotyku, wprowadziliśmy bardziej intuicyjny gest przeciągania i upuszczania, dwukrotne i trzykrotne kliknięcie w polach tekstowych oraz menu kontekstowe w polach tekstowych w stylu komputerów stacjonarnych.

Aby przetestować działanie trackpada, udostępniliśmy nowe interfejsy API do 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 na różnych typach urządzeń wejściowych, w tym na ekranach dotykowych, myszach, trackpadach i rysikach, oraz upewnij się, że obsługują kółka przewijania myszy i gesty na trackpadzie.

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

Wprowadziliśmy HostDefaultProvider, LocalHostDefaultProvider, HostDefaultKey i ViewTreeHostDefaultKey, aby dostarczać usługi na poziomie hosta bezpośrednio przez compose-runtime. Eliminuje to konieczność korzystania z compose-ui w przypadku wyszukiwania w bibliotekach, 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.

Podgląd kodów towarzyszących

Niestandardowe podglądy w Android Studio to nowa funkcja, która pozwala dokładnie określić sposób wyświetlania treści podglądu w 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 z adnotacjami @Composable i @Preview lub @MultiPreview, co zapewnia ogólne, łatwe w użyciu rozwiązanie, które działa w przypadku funkcji w wersji zapoznawczej i znacznie ogranicza powtarzający się kod.

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

• Jak ogłosiliśmy w poście na blogu o Compose 1.10, wycofujemy Modifier.onFirstVisible(). Jego nazwa często prowadziła do nieporozumień, zwłaszcza w przypadku leniwego układu, w którym wywoływał się wielokrotnie podczas przewijania. Zalecamy przejście na Modifier.onVisibilityChanged(), które umożliwia bardziej precyzyjne ręczne śledzenie stanów widoczności dostosowane do Twoich konkretnych wymagań.
• Flaga ComposeFoundationFlags.isTextFieldDpadNavigationEnabled została usunięta, ponieważ nawigacja za pomocą pada kierunkowego w przypadku TextFields jest teraz zawsze domyślnie włączona. Nowe działanie zapewnia, że zdarzenia z pada kierunkowego na gamepadzie lub pilocie do telewizora najpierw przesuwają kursor w danym kierunku. Fokus może zostać przeniesiony na inny element tylko wtedy, gdy kursor dotrze do końca tekstu.

Nadchodzące interfejsy API

W nadchodzącej wersji Compose 1.12.0 minimalny poziom API zostanie podniesiony z compileSdk do compileSdk 37. Wymaganie to będzie dziedziczone przez AGP 9 oraz wszystkie aplikacje i biblioteki, które są zależne od Compose. Zalecamy korzystanie z najnowszych wersji, ponieważ Compose szybko wprowadza nowe 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 wprowadziliśmy 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 przekazywania opinii. W przyszłych wersjach mogą ulec znacznym zmianom lub zostać usunięte.

Style (eksperymentalne)

Wprowadzamy nowy eksperymentalny podstawowy interfejs API do stylizowania. Interfejs Style API to nowy paradygmat dostosowywania elementów wizualnych komponentów, które tradycyjnie odbywało się za pomocą modyfikatorów. Został on zaprojektowany tak, aby umożliwić głębsze i łatwiejsze dostosowywanie dzięki udostępnianiu standardowego zestawu właściwości, które można stylizować za pomocą prostego stylu opartego na stanie i animowanych przejść. Dzięki temu nowemu interfejsowi API widzimy już obiecujące korzyści w zakresie skuteczności. Planujemy wprowadzić 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 (eksperymentalne)

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

Dzięki obsłudze szerokiej gamy sygnałów środowiskowych – od możliwości urządzenia, takich jak typy klawiatury 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ąd 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 stołowym, trzeba było napisać wiele schematycznych zadań: 

@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 jest ono w trybie stołowym:

@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.

Siatka (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ą w przypadku architektury na poziomie ekranu i złożonych komponentów bez obciążenia związanego z listą przewijaną. Grid umożliwia definiowanie układu za pomocą ścieżek, przerw i komórek, oferując znane opcje rozmiaru, takie jak Dp, wartości procentowe, rozmiary treści wewnętrznych 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 precyzyjnie rozciągać je na wiele wierszy i kolumn. Co najważniejsze, jest ona bardzo elastyczna – możesz dynamicznie zmieniać konfigurację ścieżek i zakresów siatki, aby dostosowywać ją do stanu urządzenia, np. trybu stołowego lub zmian orientacji. Dzięki temu interfejs będzie świetnie wyglądać na różnych urządzeniach.

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

FlexBox (eksperymentalny)

FlexBox to kontener układu zaprojektowany z myślą o wysokiej wydajności i adaptacyjnych interfejsach. Zarządza 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 wzdłuż wielu osi (justifyContent, alignItems, alignContent). Umożliwia powiększanie (grow) lub zmniejszanie (shrink) elementów w celu wypełnienia kontenera. 

@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 (eksperymentalna)

Wprowadziliśmy nową implementację SlotTable, która w tej wersji jest domyślnie wyłączona. 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 zmian.

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

Zacznij kodować już dziś!

W Jetpack Compose jest wiele nowych, ciekawych interfejsów API, a wkrótce pojawią się kolejne. To najlepszy moment, aby przejść na Jetpack Compose. Jak zawsze cenimy Twoje opinie i propozycje dotyczące funkcji (zwłaszcza tych, które są jeszcze w fazie rozwoju) – możesz je przesyłać tutaj.@Experimental Miłego tworzenia!