Używanie listy materiałów

Lista materiałów do Compose (BOM) umożliwia zarządzanie wszystkimi wersjami biblioteki Compose przez określenie tylko wersji BOM. Sam plik BOM zawiera linki do stabilnych wersji różnych bibliotek Compose, które są ze sobą dobrze zintegrowane. Korzystając z pliku BOM w aplikacji, nie musisz dodawać żadnej wersji do zależności biblioteki Compose. Gdy zaktualizujesz wersję pliku BOM, wszystkie używane przez Ciebie biblioteki zostaną automatycznie zaktualizowane do nowych wersji.

dependencies {
    // Specify the Compose BOM with a version definition
    val composeBom = platform("androidx.compose:compose-bom:2024.10.01")
    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")
}

dependencies {
    // Specify the Compose BOM with a version definition
    Dependency composeBom = platform('androidx.compose:compose-bom:2024.10.01')
    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ę pliku BOM, zapoznaj się z mapowaniem pliku BOM na wersję biblioteki.

Dlaczego biblioteka Compose Compiler nie jest uwzględniona w pliku BOM?

Rozszerzenie kompilatora Kotlina do Compose (androidx.compose.compiler) nie jest powiązane z wersjami biblioteki Compose. Jest ona zamiast tego powiązana z wersjami wtyczki kompilatora Kotlin i publikowana w odrębnych odstępach czasowych od reszty Compose.

Od wersji Kotlin 2.0 kompilator aplikacji Compose jest zarządzany razem z kompilatorem Kotlin i używa tej samej wersji co kompilator Kotlin. Szczegółowe informacje o konfiguracji znajdziesz w wtyczce Compose Compiler Gradle.

Przed wersją Kotlin 2.0 musisz użyć wersji zgodnej z Twoją wersją Kotlina. Wersję Kotlina odpowiadającą każdej wersji wtyczki znajdziesz na stronie Mapa zgodności Compose z Kotlinem, a informacje o jej konfiguracji znajdziesz na stronie Kompilator Compose.

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

W sekcji build.gradle zależności zachowaj import 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 pliku BOM, musisz zadeklarować zależności w ten sposób:

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

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

    // ..
}

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

    // Override the BOM version when needed
    implementation 'androidx.compose.animation:animation:1.8.0-alpha05'

    // ..
}

Czy plik BOM automatycznie dodaje do mojej aplikacji wszystkie biblioteki Compose?

Nie. Aby dodać do aplikacji biblioteki Compose i z nich korzystać, musisz zadeklarować każdą z nich jako osobną linię zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle).

Korzystanie z BOM zapewnia zgodność wersji bibliotek Compose w aplikacji, ale BOM nie dodaje tych bibliotek do aplikacji.

Dlaczego plik BOM jest zalecanym sposobem zarządzania wersjami biblioteki w Compose?

W przyszłości wersje bibliotek Compose będą tworzone niezależnie, co oznacza, że numery wersji będą zwiększane we własnym tempie. Najnowsze stabilne wersje każdej biblioteki są testowane razem. Znajdowanie najnowszych stabilnych wersji każdej biblioteki może być jednak trudne, a plik BOM pomaga automatycznie używać tych najnowszych wersji.

Czy muszę używać pliku BOM?

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

Czy plik BOM działa z katalogami wersji?

Tak. W katalogu wersji możesz uwzględnić sam plik BOM, pomijając inne wersje biblioteki:

[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ć listy materiałowej do build.gradle w module:

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

    // import Compose dependencies as usual
}

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 listy materiałów do tworzenia. Każda lista materiałów jest aktualnym snapshotem najnowszych dostępnych wersji bibliotek Compose.

• Stabilna – zawiera najnowsze stabilne wersje każdej biblioteki.
• Beta – zawiera najnowsze wersje beta, wersje kandydata (RC) i stabilne każdej biblioteki.
• Alpha – zawiera najnowsze wersje alfa, beta, RC lub stabilne każdej biblioteki.

Wersje alfa i beta pliku BOM są określane przez dodanie -alpha i -beta do nazwy artefaktu BOM. Wersja stabilna nie ma przyrostka.

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

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

Jak zgłosić problem lub przesłać opinię na temat listy materiałów?

Problemy możesz zgłaszać w naszym narzędziu do zgłaszania problemów.