Compose Compiler Gradle 外掛程式

針對 Gradle 使用者，您可以使用 Compose Compiler Gradle 外掛程式進行設定 輕鬆設定 Compose

注意： Compose Compiler Gradle 外掛程式僅適用於 Kotlin 2.0 以上版本。適用對象 遷移操作說明，請參閱「Jetpack Compose 編譯器移至 Kotlin」 存放區」。如需遷移範例，請參閱 Compose 範例 PR。

使用 Gradle 版本目錄設定

以下說明如何設定 Compose Compiler 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 Compiler Gradle 外掛程式，請將 以下外掛程式可套用至 build.gradle.kts 與您所用模組相關聯的檔案 撰寫：

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

Compose Compiler Gradle 外掛程式的設定選項

如要使用 Gradle 外掛程式設定 Compose 編譯器，請將 模組 build.gradle.kts 檔案頂端的 composeCompiler 區塊 第二，自訂角色只能 套用至專案或機構

android { … }

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

如需可用選項的完整清單，請參閱說明文件。