Gradle-Plug-in "Compose Compiler"

Wenn Sie Gradle verwenden, können Sie das Compose Compiler Gradle-Plug-in verwenden, um das Einrichten und Konfigurieren von Compose zu vereinfachen.

Mit Gradle-Versionskatalogen einrichten

In der folgenden Anleitung erfahren Sie, wie Sie das Compose Compiler-Gradle-Plugin einrichten:

1. Entfernen Sie in der Datei libs.versions.toml alle Verweise auf den Compose-Compiler.
2. Fügen Sie im Abschnitt „plugins“ die folgende neue Abhängigkeit hinzu:

[versions]
kotlin = "2.0.0"

[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" }

1. Fügen Sie in der Datei build.gradle.kts im Stammverzeichnis Ihres Projekts Folgendes in den Abschnitt „plugins“ ein:

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

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

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

Wenn Sie die Standardeinrichtung verwenden, sollte Ihre App jetzt erstellt und kompiliert werden. Wenn Sie benutzerdefinierte Optionen für den Compose-Compiler konfiguriert haben, lesen Sie den folgenden Abschnitt.

Einrichtung ohne Gradle-Versionskataloge

Wenn Sie das Compose Compiler Gradle-Plug-in ohne Versionskataloge einrichten möchten, fügen Sie das folgende Plug-in den build.gradle.kts-Dateien hinzu, die Modulen zugeordnet sind, in denen Sie Compose verwenden:

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

Möglicherweise müssen Sie diesen Klassenpfad auch der Datei build.gradle.kts Ihres Projekts der obersten Ebene hinzufügen:

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

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.