Compose Compiler-Gradle-Plug-in einrichten

Verwenden Sie für Gradle das Compose Compiler Gradle-Plug-in, um Compose einzurichten und zu konfigurieren.

Mit Gradle-Versionskatalogen einrichten

So richten Sie das Compose Compiler Gradle-Plug-in ein:

  1. Entfernen Sie in der Datei libs.versions.toml alle Verweise auf den Compose-Compiler.

  2. Fügen Sie in den Abschnitten versions und plugins die neue Abhängigkeit hinzu:

    [versions]
kotlin = "2.3.21"

[plugins]
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }

// Add this line
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

  3. Fügen Sie in der build.gradle.kts-Datei des Projekts im Stammverzeichnis dem Abschnitt plugins Folgendes hinzu:

    plugins {
// Existing plugins
alias(libs.plugins.compose.compiler) apply false
}

  4. Wenden Sie das Plug-in in jedem Modul an, das Compose verwendet:

    plugins {
// Existing plugins
alias(libs.plugins.compose.compiler)
}

Das Projekt sollte jetzt erstellt und kompiliert werden, wenn die Standardeinrichtung verwendet wurde. Wenn benutzerdefinierte Optionen für den Compose-Compiler konfiguriert wurden, folgen Sie der Anleitung im nächsten Abschnitt.

Compose-Compiler ohne Gradle-Versionskataloge einrichten

Fügen Sie das Plug-in den build.gradle.kts-Dateien hinzu, die mit Modulen verknüpft sind, in denen Compose verwendet wird:

plugins {
    id("org.jetbrains.kotlin.plugin.compose") version "2.3.21" // this version matches your Kotlin version
}

Fügen Sie den Klassenpfad der build.gradle.kts-Datei Ihres Projekts auf oberster Ebene hinzu:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin.plugin.compose:org.jetbrains.kotlin.plugin.compose.gradle.plugin:2.3.21")
    }
}

Konfigurationsoptionen mit dem Compose Compiler Gradle-Plug-in

Wenn Sie den Compose-Compiler mit dem Gradle-Plug-in konfigurieren möchten, fügen Sie den Block composeCompiler der build.gradle.kts-Datei des Moduls auf oberster Ebene hinzu:

android { … }

composeCompiler {
    reportsDestination = layout.buildDirectory.dir("compose_compiler")
    stabilityConfigurationFile = rootProject.layout.projectDirectory.file("stability_config.conf")
}

Eine vollständige Liste der verfügbaren Optionen finden Sie in der Dokumentation.

Compose-Abhängigkeiten einrichten

Verwenden Sie immer die neueste Compose-BOM-Version: 2026.08.00.

Setzen Sie das Flag compose in BuildFeatures von Android auf true, um die Compose-Funktionalität in Android Studio zu aktivieren.

Fügen Sie der build.gradle-Datei Ihrer App die folgende Definition hinzu:

Groovy

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

Fügen Sie die Compose-BOM und die Teilmenge der Compose-Bibliotheksabhängigkeiten hinzu:

Groovy

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2026.08.00')
    implementation composeBom
    androidTestImplementation composeBom

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or skip Material Design and build directly on top of foundational components
    implementation 'androidx.compose.foundation:foundation'
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation 'androidx.compose.ui:ui'

    // Android Studio Preview support
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'

    // UI Tests
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
    debugImplementation 'androidx.compose.ui:ui-test-manifest'

    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.13.0'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0'
    // Optional - Integration with LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'
    // Optional - Integration with RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'

}

Kotlin

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2026.08.00")
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or skip Material Design and build directly on top of foundational components
    implementation("androidx.compose.foundation:foundation")
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation("androidx.compose.ui:ui")

    // Android Studio Preview support
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // UI Tests
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.13.0")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0")
    // Optional - Integration with LiveData
    implementation("androidx.compose.runtime:runtime-livedata")
    // Optional - Integration with RxJava
    implementation("androidx.compose.runtime:runtime-rxjava2")

}

compileSdk und Kompatibilität mit dem Android-Gradle-Plug-in

Bei Compose-Bibliotheksreleases werden kontinuierlich die neuesten compileSdk-Versionen übernommen, um Zugriff auf die neuesten Android-Funktionen zu ermöglichen. Für neuere compileSdk-Versionen sind neuere Versionen des Android-Gradle-Plug-ins erforderlich. Wenn Sie also neue Compose-Releases verwenden möchten, müssen Sie auch neue Versionen des Android-Gradle-Plug-ins verwenden. Wir empfehlen, compileSdk Ihres Projekts mit den neuesten veröffentlichten Versionen auf dem neuesten Stand zu halten. compileSdk ist unabhängig von targetSdk.

Ab Compose 1.12.0 müssen Projekte beispielsweise compileSdk 37 und das Android-Gradle-Plug-in (AGP) 9 verwenden.

Informationen dazu, welche AGP-Version für verschiedene API-Ebenen unterstützt wird, finden Sie in der Dokumentation zur Unterstützung von API-Ebenen durch das Android-Gradle-Plug-in.