在build.gradle.kts中引用gradle.properties变量遇未解析问题求助

问题复现 #

在根目录gradle.properties中定义了全局版本变量：

# Global versions
GLOBAL_LOGBACKVERSION   =   1.5.7

在根目录build.gradle.kts中直接引用该变量时，出现错误：

未解析的引用: GLOBAL_LOGBACKVERSION
失败: 构建因异常而终止。

• 位置：构建文件 '/.../my_project/build.gradle.kts' 第47行
• 问题：脚本编译错误，第47行引用变量时出现未解析引用

解决方案 #

Kotlin Gradle DSL（.kts）是强类型脚本，不会像Groovy版build.gradle那样自动将gradle.properties中的变量注入到脚本上下文，必须通过project对象访问这些属性，有两种简洁的实现方式：

方式一：直接通过project.property()获取 #

修改依赖引用代码为：

dependencies {
    implementation("ch.qos.logback:logback-classic:${project.property("GLOBAL_LOGBACKVERSION")}")
}

注意：project.property()返回的是Any类型，需要用字符串模板包裹以确保类型正确。

方式二：提前声明变量（推荐） #

在build.gradle.kts的顶部（或依赖块之前）声明变量，通过by project委托获取属性值：

// 声明全局版本变量
val GLOBAL_LOGBACKVERSION: String by project

dependencies {
    implementation("ch.qos.logback:logback-classic:$GLOBAL_LOGBACKVERSION")
}

这种方式代码更简洁，且符合Kotlin的类型安全特性。

额外注意事项 #

• 尽量规范gradle.properties中的变量定义，去掉等号两侧的空格，写成GLOBAL_LOGBACKVERSION=1.5.7，避免潜在的解析问题；
• 如果变量是数值类型（如版本号为纯数字），可以将变量声明为String或Int，但版本号通常建议用String，避免处理多段版本号时的类型问题。

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