Gradle-Plug-in "Compose Compiler"

Gradle-Nutzer können das Compose Compiler Gradle-Plug-in verwenden, um die Einrichtung und Konfiguration von Compose zu vereinfachen.

Mit Gradle-Versionskatalogen einrichten

In der folgenden Anleitung wird beschrieben, wie Sie das Compose Compiler Gradle-Plug-in einrichten:

  1. Entfernen Sie in der libs.versions.toml-Datei alle Verweise auf den Compose-Compiler.
  2. Fügen Sie im Abschnitt „Plug-ins“ 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 Stammdatei build.gradle.kts Ihres Projekts im Abschnitt „plugins“ Folgendes hinzu:
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 den build.gradle.kts-Dateien, die mit den von Ihnen verwendeten Compose-Modulen verknüpft sind, das folgende Plug-in hinzu:

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

Konfigurationsoptionen mit dem Compose Compiler Gradle-Plug-in

Wenn Sie den Compose-Compiler mit dem Gradle-Plug-in konfigurieren möchten, fügen Sie der build.gradle.kts-Datei des Moduls auf oberster Ebene den Block composeCompiler 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.