Gradle KTS函数移至独立文件时遇未解析引用问题求助

核心原因 #

独立的.gradle.kts脚本默认没有Android Gradle插件（AGP）、Kotlin插件或Jacoco插件的类路径依赖，因此无法识别这些插件提供的API（比如BaseExtension、AppPlugin等）；而模块的build.gradle.kts因为已经应用了对应插件，类路径中包含这些依赖，所以能正常编译。

推荐方案：使用预编译脚本插件（Kotlin DSL官方推荐） #

预编译脚本插件会自动处理类路径依赖，是共享Gradle配置的标准方式，步骤如下：

1. 创建buildSrc目录结构 #

在项目根目录下创建buildSrc/src/main/kotlin目录（如果不存在），这个目录下的代码会被Gradle自动编译并加入项目的构建类路径。

2. 迁移基础配置代码 #

将gradle/gradle-base-config.gradle.kts中的代码移到buildSrc/src/main/kotlin下的文件（比如BaseConfig.kt），修改为扩展方法形式：

import com.android.build.gradle.BaseExtension
import com.android.build.gradle.api.AndroidBasePlugin
import org.gradle.api.Project
import org.jetbrains.kotlin.gradle.tasks.KotlinJvmCompile
import java.util.*

// 给Project扩展方法，方便模块直接调用
fun Project.applyBaseAndroidConfig() {
    // 等待Android插件加载完成后执行配置
    plugins.withType<AndroidBasePlugin> {
        val androidExt = extensions.getByType<BaseExtension>()
        androidExt.run {
            compileSdkVersion(33)
            defaultConfig {
                minSdk = 23
                targetSdk = 33
            }
            compileOptions {
                sourceCompatibility = JavaVersion.VERSION_11
                targetCompatibility = JavaVersion.VERSION_11
            }
        }
    }
    // 统一配置Kotlin编译目标
    tasks.withType<KotlinJvmCompile> {
        kotlinOptions.jvmTarget = "11"
    }
}

3. 配置buildSrc的依赖 #

在buildSrc目录下创建build.gradle.kts，添加AGP和Kotlin插件的依赖：

plugins {
    `kotlin-dsl`
}

repositories {
    google()
    mavenCentral()
}

dependencies {
    // 替换为你项目中使用的AGP版本
    implementation("com.android.tools.build:gradle:7.4.2")
    // 替换为你项目中使用的Kotlin版本
    implementation("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.20")
}

java {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

4. 在模块中应用配置 #

在app/build.gradle.kts中直接调用扩展方法即可：

plugins {
    id("com.android.application")
    kotlin("android")
}

// 调用我们定义的基础配置方法
applyBaseAndroidConfig()

Jacoco配置的解决方案 #

同样用预编译脚本插件处理：

1. 在buildSrc/src/main/kotlin下创建JacocoConfig.kt：

import org.gradle.api.Project
import org.gradle.testing.jacoco.plugins.JacocoPlugin
import org.gradle.testing.jacoco.tasks.JacocoReport

fun Project.applyJacocoConfig() {
    plugins.apply(JacocoPlugin::class.java)
    tasks.withType<JacocoReport> {
        // 这里写入你的Jacoco配置逻辑，示例：
        reports {
            xml.required.set(true)
            html.required.set(true)
        }
    }
}

2. 在buildSrc/build.gradle.kts的dependencies中添加Jacoco依赖（版本对应你的Gradle版本）：

implementation("org.gradle:gradle-jacoco:7.5")

3. 在模块中调用：

applyJacocoConfig()

临时方案（不推荐）：手动导入类路径 #

如果坚持使用apply(from)，可以在独立脚本开头添加buildscript块导入依赖，但容易导致版本冲突：

// 在gradle-base-config.gradle.kts开头添加
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath("com.android.tools.build:gradle:7.4.2")
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.20")
    }
}

Jacoco同理：

// 在jacoco.gradle.kts开头添加
buildscript {
    dependencies {
        classpath("org.gradle:gradle-jacoco:7.5")
    }
}

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