Compose Compiler Gradle 外掛程式

如果您使用 Gradle，可以透過 Compose 編譯器 Gradle 外掛程式，更輕鬆地設定及配置 Compose。

透過 Gradle 版本目錄進行設定

下列操作說明大致說明如何設定 Compose 編譯器 Gradle 外掛程式：

  1. 在 libs.versions.toml 檔案中，移除對 Compose 編譯器的所有參照
  2. 在外掛程式部分中，新增下列依附元件
[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. 在專案根層級的 build.gradle.kts 檔案中，將下列內容新增至外掛程式區段：
plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler) apply false
}
  1. 在每個使用 Compose 的模組中套用外掛程式：
plugins {
   // Existing plugins
   alias(libs.plugins.compose.compiler)
}

如果您使用預設設定，應用程式現在應該會建構及編譯。如果您已在 Compose 編譯器上設定自訂選項，請參閱下一節。

不使用 Gradle 版本目錄進行設定

如要在沒有版本目錄的情況下設定 Compose 編譯器 Gradle 外掛程式，請將下列外掛程式新增至與您使用 Compose 的模組相關聯的 build.gradle.kts 檔案：

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

您可能也需要在頂層專案 build.gradle.kts 檔案中新增這個類別路徑：

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

Compose 編譯器 Gradle 外掛程式的設定選項

如要使用 Gradle 外掛程式設定 Compose 編譯器，請在頂層的模組 build.gradle.kts 檔案中新增 composeCompiler 區塊。

android { … }

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

如需完整清單，請參閱說明文件。