Android项目自定义Gradle转Gradle KTS：文件不识别及配置疑问

关键配置步骤 #

要让Android Studio识别并正常使用根目录的自定义.gradle.kts文件，无需依赖buildSrc，只需完成以下操作：

1. 完成Groovy到Kotlin DSL的语法转换 #

将原.gradle文件的Groovy语法改为Kotlin DSL规范，比如：

• 插件应用：plugins { id("jacoco") }（替代Groovy的apply plugin: 'jacoco'）
• 任务定义、属性访问等均需遵循Kotlin语法要求，比如遍历Android风味的写法要调整为Kotlin风格。

2. 在主/模块构建脚本中正确引入 #

在项目根目录的build.gradle.kts或模块级build.gradle.kts中，通过apply(from)引入自定义脚本：

// 根目录build.gradle.kts中引入根目录的jacoco.gradle.kts
apply(from = "jacoco.gradle.kts")

// 模块build.gradle.kts中引入根目录的脚本，需用相对路径
apply(from = "../jacoco.gradle.kts")

3. 访问版本目录（Catalog Libraries） #

只要项目已在settings.gradle.kts中配置了版本目录，自定义脚本可直接通过libs对象引用Catalog中的依赖或版本，无需额外代码：

dependencies {
    jacocoAgent(libs.jacoco.agent)
}

确保settings.gradle.kts中的版本目录配置正常：

dependencyResolutionManagement {
    versionCatalogs {
        create("libs") {
            from(files("gradle/libs.versions.toml"))
        }
    }
}

4. 获取Android特定任务/属性 #

要在自定义脚本中访问Android风味、构建变体等内容，需确保脚本在Android插件应用后引入，直接通过android扩展对象操作即可：

android {
    productFlavors.all { flavor ->
        // 获取风味名称
        val flavorName = name
        // 为该风味创建自定义Jacoco任务
        tasks.register<JacocoReport>("jacoco${flavorName.replaceFirstChar(Char::uppercase)}Report") {
            // 任务配置逻辑
        }
    }
}

常见问题排查 #

• Android Studio不识别脚本：先通过命令行执行./gradlew tasks验证构建是否正常（命令行无报错则语法没问题），再执行File -> Sync Project with Gradle Files强制同步。
• 无法访问Catalog：检查settings.gradle.kts中是否正确配置了dependencyResolutionManagement，确保版本目录文件路径无误。
• 无法访问Android扩展：确认自定义脚本的引入顺序在Android插件应用之后，比如模块脚本中先写plugins { id("com.android.application") }，再引入自定义脚本。

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