Compose 编译器选项 DSL

Compose 编译器 Gradle plugin 提供了一个 DSL, 用于配置各种编译器选项. 对于适用了 Compose 编译器 Gradle plugin 的模块, 可以在build.gradle.kts 文件的 composeCompiler {} 代码块中, 使用这个 DSL 来配置编译器.

你可以指定 2 种类型的选项:

• 一般编译器设置, 可以在任何项目中根据需要禁用或启用.

• 功能特性 flag, 启用或禁用新的功能特性和实验性功能特性, 这些功能特性将来会成为默认功能的一部分.

你可以在 Compose 编译器 Gradle plugin 的 API 参考文档中, 找到 可用的一般设置列表 和 支持的功能特性 flag 列表.

下面是一个配置示例:

composeCompiler {
    includeSourceInformation = true

    featureFlags = setOf(
        ComposeFeatureFlag.StrongSkipping.disabled(),
        ComposeFeatureFlag.OptimizeNonSkippingGroups
    )
}

warning

Gradle plugin 对一些 Compose 编译器选项提供了默认值, 在 Kotlin 2.0 以前的版本只能手动指定. 如果你使用 freeCompilerArgs 设置了这些选项, 例如, Gradle 会报告重复选项的错误.

featureFlags = setOf(ComposeFeatureFlag.OptimizeNonSkippingGroups)

featureFlags = setOf(ComposeFeatureFlag.StrongSkipping.disabled())

-P plugin:androidx.compose.compiler.plugins.kotlin:featureFlag=<flag name>