Materialliste verwenden

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

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

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

Welche Versionen der Compose-Bibliothek einer bestimmten BOM-Version zugeordnet sind, erfahren Sie in der BOM-Version zur Bibliotheksversion.

Warum ist die Compose Compiler-Bibliothek nicht in der BOM enthalten?

Die Compose Kotlin-Compilererweiterung (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 separaten Rhythmus von den anderen Compose-Komponenten veröffentlicht.

Ab Kotlin 2.0 wird der Compose-App-Compiler zusammen mit dem Kotlin-Compiler verwaltet und verwendet dieselbe Version wie der Kotlin-Compiler. Weitere Informationen zur Konfiguration finden Sie unter Compose Compiler Gradle-Plug-in.

In Versionen unter Kotlin 2.0 finden Sie in der Compose-Kotlin-Kom101patibilitätsübersicht eine Compilerversion, die mit Ihrer Kotlin-Version kompatibel ist. Unter Compose Compiler finden Sie eine Anleitung zur Konfiguration.

Wie verwende ich eine andere Bibliotheksversion als die in der BOM angegebene?

Behalten Sie im Abschnitt build.gradle die Importanweisung für die BOM-Plattform bei. Geben Sie beim Import der Bibliotheksabhängigkeit die überschreibende Version an. So deklarieren Sie beispielsweise Abhängigkeiten, wenn Sie eine neuere Version der Animationsbibliothek verwenden möchten, unabhängig davon, welche Version in der BOM angegeben ist:

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

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

    // ..
}

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

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

    // ..
}

Werden durch die BOM automatisch alle Compose-Bibliotheken zu meiner App hinzugefügt?

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

Mit der BOM können Sie überprüfen, ob die Versionen der Compose-Bibliotheken in Ihrer App kompatibel sind. Die BOM fügt diese Compose-Bibliotheken jedoch nicht tatsächlich zu Ihrer App hinzu.

Warum ist die BOM die empfohlene Methode zum Verwalten von Compose-Bibliotheksversionen?

Künftig werden Compose-Bibliotheken unabhängig voneinander versioniert. Das bedeutet, dass die Versionsnummern in unterschiedlichem Tempo erhöht werden. Die neuesten stabilen Releases der einzelnen Bibliotheken werden zusammen getestet. Es kann jedoch schwierig sein, die neuesten stabilen Versionen der einzelnen Bibliotheken zu finden. Mit der BOM können Sie diese neuesten Versionen automatisch verwenden.

Muss ich die BOM verwenden?

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

Funktioniert die BOM mit Versionskatalogen?

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

[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 der build.gradle-Datei Ihres Moduls zu importieren:

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
}

Was ist, wenn ich Alpha- oder Betaversionen von Compose-Bibliotheken ausprobieren möchte?

Es gibt drei verfügbare Compose-BOMs. Jede BOM ist ein Snapshot der neuesten verfügbaren Versionen von Compose-Bibliotheken zu einem bestimmten Zeitpunkt.

• Stabil: Enthält die neuesten stabilen Versionen der einzelnen Bibliotheken.
• Beta: Enthält die neuesten Beta-, Releasekandidaten- (RC-) oder stabilen Versionen der einzelnen Bibliotheken.
• Alpha: Enthält die neuesten Alpha-, Beta-, RC- oder stabilen Versionen der einzelnen Bibliotheken.

Die Alpha- und Betaversionen der BOM werden durch Hinzufügen von -alpha und -beta zum BOM-Artefaktnamen angegeben. Die stabile Version hat kein Suffix.

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

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

Wie melde ich ein Problem oder gebe Feedback zur BOM?

Sie können Probleme in unserem Issue Tracker melden.