如何在Gradle子项目间实现依赖Scope的继承？

问题场景 #

现有Gradle多项目结构：
settings.gradle.kts 配置：

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

include("main-module")
include("specific-test-module")

main-module/build.gradle.kts 配置：

plugins {
    id("java")
}

dependencies {
    implementation("org.slf4j:slf4j-api:2.0.9")
}

需求是让specific-test-module的testImplementation配置继承main-module的implementation依赖，但直接跨项目使用extendsFrom时失效：

// 在specific-test-module中无效的写法
configurations.create("someScope") {
    extendsFrom(project(":main-module").configurations.implementation.get())
}

本地子项目内创建配置继承可正常工作，但跨项目时因配置时机过早，目标项目的依赖尚未完成配置，导致继承关系不生效。

解决方案 #

方法1：使用afterEvaluate延迟配置 #

在specific-test-module/build.gradle.kts中，通过afterEvaluate确保main-module完成配置后再建立继承关系：

plugins {
    id("java")
}

afterEvaluate {
    configurations.testImplementation.get().extendsFrom(project(":main-module").configurations.implementation.get())
}

方法2：使用named延迟获取目标配置 #

利用configurations.named()的延迟特性，确保目标配置初始化完成后再引用：

plugins {
    id("java")
}

configurations.testImplementation {
    extendsFrom(project(":main-module").configurations.named("implementation").get())
}

方法3：创建专用共享配置（推荐） #

在main-module中定义一个专门供其他项目测试使用的配置，避免直接依赖implementation（implementation是可消费配置，可能引发潜在问题）：

main-module/build.gradle.kts 修改：

plugins {
    id("java")
}

configurations {
    // 创建仅用于解析的共享测试配置
    create("testShared") {
        extendsFrom(implementation.get())
        isCanBeResolved = true
        isCanBeConsumed = false
    }
}

dependencies {
    implementation("org.slf4j:slf4j-api:2.0.9")
}

specific-test-module/build.gradle.kts 配置：

plugins {
    id("java")
}

dependencies {
    testImplementation(project(":main-module").configurations.named("testShared").get())
}

原理说明 #

Gradle的配置阶段默认并行执行，跨项目直接获取配置时，目标项目的配置可能尚未完成初始化，导致继承关系无法正确建立。上述方法通过延迟执行配置逻辑或使用延迟获取API，确保在目标配置就绪后再建立依赖继承关系。

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