Materialliste verwenden

Mit der Compose-Materialliste (Bill of Materials, BOM) können Sie alle Versionen Ihrer 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, 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 die neuen Versionen aktualisiert.

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

Informationen dazu, welche Compose-Bibliotheksversionen einer bestimmten BoM-Version zugeordnet sind, finden Sie unter Zuordnung von BoM- zu Bibliotheksversionen.

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

Die Compose Kotlin-Compiler-Erweiterung (androidx.compose.compiler) ist nicht mit den Compose-Bibliotheksversionen 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.

Seit Kotlin 2.0 wird der Compose-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 vor Kotlin 2.0 finden Sie in der Kompatibilitätsübersicht für Compose und Kotlin eine Compiler-Version, die mit Ihrer Kotlin-Version kompatibel ist. Informationen zur Konfiguration finden Sie unter Compose Compiler.

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

Behalten Sie im Abschnitt mit den build.gradle-Abhängigkeiten den Import der 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.09.00")
    implementation(composeBom)

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

    // ..
}

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

    // Override the BOM version when needed
    implementation 'androidx.compose.animation:animation:1.13.0-alpha03'

    // ..
}

Fügt die BOM meiner App automatisch alle Compose-Bibliotheken hinzu?

Nein. Wenn Sie Compose-Bibliotheken in 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, in der Regel „app/build.gradle“) deklarieren.

Mit der BOM können Sie prüfen, ob die Versionen der Compose-Bibliotheken in Ihrer App kompatibel sind. Die Compose-Bibliotheken werden jedoch nicht tatsächlich Ihrer App hinzugefügt.

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

In Zukunft werden Compose-Bibliotheken unabhängig voneinander versioniert. Das bedeutet, dass die Versionsnummern in ihrem eigenen Tempo erhöht werden. Die neuesten stabilen Releases jeder Bibliothek werden zusammen getestet. Es kann jedoch schwierig sein, die neuesten stabilen Versionen der einzelnen Bibliotheken zu finden. Die BOM hilft Ihnen, diese neuesten Versionen automatisch zu verwenden.

Muss ich die BOM verwenden?

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

Funktioniert die BOM mit Versionskatalogen?

Ja. Sie können die BOM selbst in den Versionskatalog aufnehmen und die anderen Compose-Bibliotheksversionen 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 die 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 sind drei Compose-BOMs verfügbar. 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-, Releasekandidat- (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 des BOM werden durch Hinzufügen von -alpha und -beta zum Namen des BOM-Artefakts 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.09.00")
    //            or platform("androidx.compose:compose-bom-beta:2026.09.00")
    implementation(composeBom)
    // ..
}

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

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

Sie können Probleme in unserem Issue Tracker melden.