Verwendung der Materialliste

Mit der Compose Bill of Materials (BOM) können Sie alle Versionen der Compose-Bibliothek verwalten, indem Sie nur die Version der BOM angeben. Die BOM selbst enthält Links zu den stabilen Versionen der verschiedenen Compose-Bibliotheken, die gut aufeinander abgestimmt sind. Wenn Sie die BOM in Ihrer Anwendung verwenden, müssen Sie den Abhängigkeiten der Compose-Bibliothek selbst keine Version hinzufügen. Wenn Sie die BOM-Version aktualisieren, werden alle von Ihnen verwendeten Bibliotheken automatisch auf die neuen Versionen aktualisiert.

Informationen dazu, welche Compose-Bibliotheksversionen einer bestimmten BOM-Version zugeordnet sind, finden Sie unter Zuordnung der BOM zu Bibliotheksversion.

Warum ist die Compiler-Bibliothek für das Schreiben nicht in der BOM enthalten?

Die Compiler-Erweiterung „Compose Kotlin“ (androidx.compose.compiler) ist nicht mit den Versionen der Compose-Bibliothek verknüpft. Stattdessen ist sie mit Versionen des Kotlin-Compiler-Plug-ins verknüpft und wird in einem anderen Rhythmus als der Rest von Compose veröffentlicht. Verwenden Sie daher eine Version, die mit Ihrer Kotlin-Version kompatibel ist. Die Kotlin-Version, die den einzelnen Versionen des Plug-ins zugeordnet ist, finden Sie unter Mit Kotlin-Kompatibilitätskarte erstellen.

Wie verwende ich eine andere Bibliotheksversion als in der BOM angegeben?

Behalten Sie im Abschnitt build.gradle-Abhängigkeiten den Import der BOM-Plattform bei. Geben Sie beim Import der Bibliotheksabhängigkeit die gewünschte Version an. So deklarieren Sie beispielsweise Abhängigkeiten, wenn Sie eine Alphaversion von Material 3 verwenden möchten, unabhängig davon, welche Version in der BOM angegeben ist:

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

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

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

Fügt die BOM automatisch alle Textbibliotheken zu meiner App hinzu?

Nein. Wenn Sie Compose-Bibliotheken in Ihrer App hinzufügen und verwenden möchten, müssen Sie jede Bibliothek in der Gradle-Datei Ihres Moduls (auf App-Ebene) als separate Abhängigkeitszeile deklarieren (in der Regel „app/build.gradle“).

Durch die Verwendung der BOM wird sichergestellt, dass die Versionen aller Erstellungsbibliotheken in Ihrer Anwendung kompatibel sind. Die BOM fügt diese Erstellungsbibliotheken jedoch nicht Ihrer Anwendung hinzu.

Künftig werden Compose-Bibliotheken unabhängig versioniert, d. h., die Versionsnummern werden in ihrem eigenen Tempo erhöht. Die neuesten stabilen Releases jeder Bibliothek werden getestet und funktionieren reibungslos zusammen. Es kann jedoch schwierig sein, die neuesten stabilen Versionen jeder Bibliothek zu finden, und die BOM hilft Ihnen, diese neuesten Versionen automatisch zu verwenden.

Muss ich die Stückliste verwenden?

Nein. Sie können jede Abhängigkeitsversion manuell hinzufügen. Wir empfehlen jedoch die Verwendung der BOM, da es so einfacher ist, alle aktuellen stabilen Versionen gleichzeitig zu verwenden.

Funktioniert die BOM mit Versionskatalogen?

Ja. Sie können die BOM selbst in den Versionskatalog aufnehmen und die anderen Versionen der Composer-Bibliothek auslassen:

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

Vergessen Sie nicht, die BOM in das build.gradle Ihres Moduls zu importieren:

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

    // import Compose dependencies as usual
}

Wie kann ich ein Problem melden oder Feedback zur Stückliste geben?

Probleme können Sie über unseren Issue Tracker melden.