Gradle Groovy转Kotlin DSL后项目build.gradle.kts无法识别libs

根项目的build.gradle.kts属于独立的构建脚本上下文，Gradle默认不会为其自动生成版本目录（libs.versions.toml）的类型安全访问器（即libs关键字）；而子模块（如:app）会自动继承依赖解析配置，因此能正常识别libs。

1. 确认gradle/libs.versions.toml文件存在且配置正确 #

确保项目根目录下的gradle文件夹中存在libs.versions.toml，且文件内包含你用到的插件和依赖版本定义。示例配置如下：

[versions]
androidGradlePlugin = "8.5.0"
kotlin = "1.9.24"
ksp = "1.9.24-1.0.20"
composeBom = "2024.06.00"

[plugins]
android-application = { id = "com.android.application", version.ref = "androidGradlePlugin" }
android-library = { id = "com.android.library", version.ref = "androidGradlePlugin" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

[libraries]
androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version = "1.12.0" }
androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version = "2.7.0" }
# 其他你用到的依赖按此格式补充

2. 修改根项目build.gradle.kts，手动获取libs目录访问权 #

在根项目构建脚本中显式获取VersionCatalogsExtension，从而访问libs关键字。修改后的代码如下：

// 先获取版本目录的访问实例
val libs = the<VersionCatalogsExtension>().named("libs")

plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.android.library) apply false
    alias(libs.plugins.kotlin.android) apply false
    alias(libs.plugins.ksp) apply false
    alias(libs.plugins.kotlin.compose) apply false
}

3. 验证Gradle版本兼容性 #

确保项目使用的Gradle版本≥7.4（建议使用8.x版本，与Android Gradle Plugin版本匹配）。你可以在gradle/wrapper/gradle-wrapper.properties中查看和修改Gradle版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

完成以上步骤后，重新同步Gradle，根项目脚本中的libs关键字应该就能被正常识别了。

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