Korzystanie z listy materiałów

Tworzenie listy materiałów (BOM) pozwala zarządzać wszystkimi wersjami biblioteki Compose przez określenie tylko wersji BOM. Sama BOM zawiera linki do stabilnych wersji różnych bibliotek Compose, dzięki czemu dobrze ze sobą współpracują. Korzystając z BOM w aplikacji, nie musisz dodawać żadnej wersji do zależności biblioteki tworzenia. Gdy zaktualizujesz wersję BOM, wszystkie używane biblioteki zostaną automatycznie zaktualizowane do nowych wersji.

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

Dlaczego w BOM nie ma biblioteki kompilatora tworzenia?

Rozszerzenie kompilatora Compose Kotlin (androidx.compose.buildr) nie jest połączone z wersjami biblioteki Compose. Zamiast tego jest on powiązany z wersjami wtyczki kompilatora Kotlin i publikowana w innym cyklu niż reszta sekcji Compose, więc upewnij się, że używasz wersji zgodnej z Twoją wersją Kotlin. Wersję Kotlin zmapowaną na poszczególne wersje wtyczki znajdziesz w artykule na temat mapy zgodności Kotlin.

Jak używać innej wersji biblioteki niż ta określona w BOM?

W sekcji zależności build.gradle zachowaj importowanie platformy BOM. W importowaniu zależności biblioteki określ odpowiednią wersję. Na przykład tutaj dowiesz się, jak zadeklarować zależności, jeśli chcesz używać wersji alfa Material 3 niezależnie od tego, która wersja jest wskazana w BOM:

dependencies {
    // Import the Compose BOM
    implementation platform('androidx.compose:compose-bom:2024.04.01')

    // Import Material Design 3 library
    implementation 'androidx.compose.material3:material3:1.1.2'

    // Import other Compose libraries without version numbers
    // ..
    implementation 'androidx.compose.foundation:foundation'
}

Czy BOM automatycznie dodaje wszystkie biblioteki tworzenia do mojej aplikacji?

Nie. Aby dodać biblioteki Compose i z nich korzystać w swojej aplikacji, 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 zapewnia zgodność wersji wszystkich bibliotek Compose w aplikacji, ale ta funkcja nie dodaje tych bibliotek do aplikacji.

Od tego momentu wersje bibliotek tworzenia będą miały różne wersje, co oznacza, że numery wersji będą stopniowo poddawane przyrostowi we własnym tempie. Najnowsze stabilne wersje każdej biblioteki są testowane. Gwarantujemy prawidłowe współdziałanie. Jednak znalezienie najnowszych stabilnych wersji każdej biblioteki może być trudne, a BOM pozwala automatycznie korzystać z tych najnowszych wersji.

Czy muszę korzystać z BOM?

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

Czy BOM działa z katalogami wersji?

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

[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 do build.gradle modułu:

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

    // import Compose dependencies as usual
}

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

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