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

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 im Stammverzeichnis des Projekts in der Datei build.gradle.kts Folgendes in den Abschnitt plugins ein.

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

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

    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 dem nächsten Abschnitt.

Compose-Compiler ohne Gradle-Versionskataloge einrichten

Fügen Sie das Plug-in den build.gradle.kts-Dateien hinzu, die Modulen zugeordnet 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 Datei build.gradle.kts auf oberster Projektebene 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 Datei build.gradle.kts 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 aktuelle Compose-BoM-Version: 2026.06.00.

Setzen Sie das Flag compose in der Android-Datei BuildFeatures auf true, um Compose-Funktionen in Android Studio zu aktivieren.

Fügen Sie der Datei build.gradle 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.06.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.06.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 Android-Gradle-Plug-in-Kompatibilität

In den Releases der Compose-Bibliothek werden fortlaufend die neuesten compileSdk-Versionen verwendet, 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 in Ihren Projekten verwenden. Wir empfehlen, die compileSdk Ihres Projekts mit den neuesten veröffentlichten Versionen auf dem aktuellen Stand zu halten. compileSdk hat nichts mit targetSdk zu tun.

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

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