Używanie listy materiałów

Funkcja tworzenia listy materiałowej (BOM) umożliwia zarządzanie wszystkimi wersjami biblioteki Compose przez określenie tylko wersji listy materiałowej. Sam BOM zawiera linki do stabilnych wersji różnych bibliotek Compose, które działają ze sobą w sposób zapewniający ich prawidłowe współdziałanie. Jeśli używasz BOM-u w aplikacji, nie musisz dodawać żadnej wersji do zależności biblioteki Compose. Gdy zaktualizujesz wersję BOM, wszystkie używane biblioteki zostaną automatycznie zaktualizowane do nowych wersji.

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom:2026.08.00")
    implementation(composeBom)
    testImplementation(composeBom)
    androidTestImplementation(composeBom)

    // Specify Compose library dependencies without a version definition
    implementation("androidx.compose.foundation:foundation")
    // ..
    testImplementation("androidx.compose.ui:ui-test-junit4")
    // ..
    androidTestImplementation("androidx.compose.ui:ui-test")
}

Dynamiczny

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform('androidx.compose:compose-bom:2026.08.00')
    implementation composeBom
    testImplementation composeBom
    androidTestImplementation composeBom

    // Specify Compose library dependencies without a version definition
    implementation 'androidx.compose.foundation:foundation'
    // ..
    testImplementation 'androidx.compose.ui:ui-test-junit4'
    // ..
    androidTestImplementation 'androidx.compose.ui:ui-test'
}

Aby dowiedzieć się, które wersje biblioteki Compose są mapowane na konkretną wersję BOM, zapoznaj się z mapowaniem BOM na wersję biblioteki.

Dlaczego biblioteka kompilatora Compose nie jest uwzględniona w BOM?

Rozszerzenie kompilatora Kotlin Compose (androidx.compose.compiler) nie jest połączone z wersjami biblioteki Compose. Jest ona powiązana z wersjami wtyczki kompilatora Kotlin i publikowana w innym tempie niż pozostałe komponenty Compose.

Od wersji Kotlin 2.0 kompilator Compose jest zarządzany razem z kompilatorem Kotlina i używa tej samej wersji co kompilator Kotlina. Szczegóły konfiguracji znajdziesz w sekcji Wtyczka Gradle kompilatora Compose.

W przypadku wersji starszych niż Kotlin 2.0 zapoznaj się z mapą zgodności Compose z Kotlinem, aby znaleźć wersję kompilatora zgodną z Twoją wersją Kotlina. Wskazówki dotyczące konfiguracji znajdziesz w artykule Kompilator Compose.

Jak używać innej wersji biblioteki niż ta wskazana w BOM?

W sekcji build.gradle dependencies zachowaj importowanie platformy BOM. Podczas importowania zależności biblioteki określ wersję zastępującą. Jeśli na przykład chcesz używać nowszej wersji biblioteki animacji, niezależnie od wersji wskazanej w BOM, możesz zadeklarować zależności w ten sposób:

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom:2026.08.00")
    implementation(composeBom)

    // Override the BOM version when needed
    implementation("androidx.compose.animation:animation:1.12.0-beta01")

    // ..
}

Dynamiczny

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform("androidx.compose:compose-bom:2026.08.00")
    implementation composeBom

    // Override the BOM version when needed
    implementation 'androidx.compose.animation:animation:1.12.0-beta01'

    // ..
}

Czy BOM automatycznie dodaje do mojej aplikacji wszystkie biblioteki Compose?

Nie. Aby dodać biblioteki Compose do aplikacji i ich używać, musisz zadeklarować każdą bibliotekę jako osobny wiersz zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle).

Korzystanie z BOM pomaga sprawdzić, czy wersje bibliotek Jetpack Compose w aplikacji są zgodne, ale BOM nie dodaje tych bibliotek do aplikacji.

Od tej pory biblioteki Compose będą wersjonowane niezależnie, co oznacza, że numery wersji będą zwiększane w różnym tempie. Najnowsze stabilne wersje każdej biblioteki są testowane razem. Znalezienie najnowszych stabilnych wersji każdej biblioteki może być jednak trudne, a BOM pomaga automatycznie korzystać z tych najnowszych wersji.

Czy muszę używać BOM?

Nie. Nadal możesz ręcznie dodać każdą wersję zależności. Zalecamy jednak korzystanie z BOM, ponieważ ułatwia to jednoczesne używanie wszystkich najnowszych stabilnych wersji.

Czy BOM działa z katalogami wersji?

Tak. Możesz uwzględnić samą BOM w katalogu wersji i pominąć inne wersje biblioteki Compose:

[libraries]
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "androidxComposeBom" }
androidx-compose-foundation = { group = "androidx.compose.foundation", name = "foundation" }

Nie zapomnij zaimportować BOM w build.gradle modułu:

Kotlin

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // import Compose dependencies as usual
}

Dynamiczny

dependencies {
    Dependency composeBom = platform(libs.androidx.compose.bom)
    implementation composeBom
    androidTestImplementation(composeBom)

    // import Compose dependencies as usual
}

Co zrobić, jeśli chcę wypróbować wersje alfa lub beta bibliotek Compose?

Dostępne są 3 zestawienia materiałowe. Każdy BOM to migawka w czasie najnowszych dostępnych wersji bibliotek Compose.

  • Stabilna – zawiera najnowsze stabilne wersje każdej biblioteki.
  • Beta – zawiera najnowsze wersje beta, wersje kandydujące do publikacji (RC) lub wersje stabilne każdej biblioteki.
  • Alfa – zawiera najnowsze wersje alfa, beta, RC lub stabilne każdej biblioteki.

Wersje alfa i beta BOM są określane przez dodanie do nazwy artefaktu BOM znaków -alpha i -beta. Wersja stabilna nie ma sufiksu.

Kotlin

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom-alpha:2026.08.00")
    //            or platform("androidx.compose:compose-bom-beta:2026.08.00")
    implementation(composeBom)
    // ..
}

Dynamiczny

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform('androidx.compose:compose-bom-alpha:2026.08.00')
    //                   or platform('androidx.compose:compose-bom-beta:2026.08.00')
    implementation composeBom
    // ..
}

Jak zgłosić problem lub przesłać opinię na temat BOM?

Problemy możesz zgłaszać w naszym narzędziu do rejestrowania błędów.