Gradle 9.0中是否有设置buildConfigField的新方式？替代方案如何传参到Kotlin？

针对Gradle 9.0移除buildConfigField后，需要将命令行参数传入Kotlin代码以控制运行时行为的需求，以下是几种实用的替代方案：

1. 生成编译时资源文件 #

通过Gradle读取命令行参数，生成资源文件（Android用XML资源，JVM用properties文件），再在Kotlin中读取这些资源。

Android示例 #

Gradle配置：

android {
    applicationVariants.all { variant ->
        // 读取命令行参数，默认值兜底
        val customFeatureFlag = project.findProperty("enableCustomFeature") ?: "false"
        variant.mergeResources.doLast {
            val resValuesDir = file("${variant.mergeResources.outputDir}/values")
            resValuesDir.mkdirs()
            val configFile = File(resValuesDir, "gradle_configs.xml")
            configFile.write("""
                <?xml version="1.0" encoding="utf-8"?>
                <resources>
                    <string name="enable_custom_feature">$customFeatureFlag</string>
                </resources>
            """.trimIndent())
        }
    }
}

Kotlin代码读取：

val isCustomFeatureEnabled = resources.getString(R.string.enable_custom_feature).toBoolean()

JVM示例 #

Gradle配置：

task generateConfigProperties {
    val outputDir = file("${project.buildDir}/resources/main")
    outputs.dir(outputDir)
    doLast {
        outputDir.mkdirs()
        val apiUrl = project.findProperty("apiUrl") ?: "https://default-api.com"
        val propsFile = File(outputDir, "gradle_config.properties")
        propsFile.write("""
            api.url=$apiUrl
        """.trimIndent())
    }
}

tasks.named("processResources").configure {
    dependsOn(generateConfigProperties)
}

Kotlin代码读取：

val props = Properties().apply {
    load(Thread.currentThread().contextClassLoader.getResourceAsStream("gradle_config.properties"))
}
val apiUrl = props.getProperty("api.url")

2. 通过Kotlin编译器参数传递系统属性 #

将命令行参数注入到Kotlin编译的系统属性中，运行时直接读取。

Gradle配置（Android/JVM通用）：

val debugLogEnabled = project.findProperty("enableDebugLog") ?: "false"
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
    kotlinOptions.freeCompilerArgs += "-DenableDebugLog=$debugLogEnabled"
}

Kotlin代码读取：

val isDebugLogEnabled = System.getProperty("enableDebugLog").toBoolean()

3. 直接生成Kotlin配置类 #

用Gradle动态生成包含命令行参数的Kotlin对象类，编译时自动纳入源码集。

Gradle配置（Android/JVM通用）：

task generateAppConfig {
    val outputDir = file("${project.buildDir}/generated/source/config/main")
    outputs.dir(outputDir)
    doLast {
        outputDir.mkdirs()
        // 读取多个命令行参数
        val appEnv = project.findProperty("appEnvironment") ?: "production"
        val enableBeta = project.findProperty("enableBetaFeatures") ?: "false"
        
        val configFile = File(outputDir, "com/yourpackage/AppConfig.kt")
        configFile.write("""
            package com.yourpackage

            object AppConfig {
                const val APP_ENVIRONMENT = "$appEnv"
                const val ENABLE_BETA_FEATURES = $enableBeta
            }
        """.trimIndent())
    }
}

// 让编译任务依赖生成任务
tasks.named("compileKotlin").configure {
    dependsOn(generateAppConfig)
}

// Android项目需添加源码集
android {
    sourceSets {
        main {
            kotlin.srcDir(generateAppConfig.outputs.files)
        }
    }
}

Kotlin代码直接引用：

val currentEnv = AppConfig.APP_ENVIRONMENT
val isBetaEnabled = AppConfig.ENABLE_BETA_FEATURES

4. 跨平台项目用expect/actual机制 #

如果是Kotlin Multiplatform项目，可通过expect声明配置接口，Gradle根据命令行参数生成对应平台的actual实现。

公共模块的expect声明 #

expect object AppConfig {
    val appEnvironment: String
    val enableAnalytics: Boolean
}

Gradle生成JVM平台的actual实现 #

task generateJvmConfig {
    val outputDir = file("${project.buildDir}/generated/source/config/jvmMain")
    outputs.dir(outputDir)
    doLast {
        outputDir.mkdirs()
        val env = project.findProperty("appEnv") ?: "prod"
        val enableAnalytics = project.findProperty("enableAnalytics") ?: "true"
        
        val actualFile = File(outputDir, "com/yourpackage/AppConfigActual.kt")
        actualFile.write("""
            package com.yourpackage

            actual object AppConfig {
                actual val appEnvironment = "$env"
                actual val enableAnalytics = $enableAnalytics.toBoolean()
            }
        """.trimIndent())
    }
}

sourceSets.jvmMain.kotlin.srcDir(generateJvmConfig.outputs.files)
tasks.named("compileKotlinJvm").configure {
    dependsOn(generateJvmConfig)
}

内容的提问来源于stack exchange，提问作者Bungles