Gradle：如何在subprojects块中使用集中声明的依赖？

问题原因 #

在subprojects块中配置依赖时，若子项目未先应用对应插件（如java），会导致testImplementation这类依赖配置项不存在；或是配置时机不对，导致libs扩展未被正确加载，最终依赖无法生效。

解决方案 #

1. 确认libs.version.toml配置正确性 #

确保根项目gradle/libs.versions.toml中的依赖定义格式正确：

[versions]
mockito = "4.11.0"

[libraries]
mockito-core = { module = "org.mockito:mockito-core", version.ref = "mockito" }
mockito-junit-jupiter = { module = "org.mockito:mockito-junit-jupiter", version.ref = "mockito" }

2. 在subprojects块中按需配置依赖 #

在根项目的build.gradle中，通过pluginManager.withPlugin确保仅在子项目应用对应插件后才配置依赖，避免因配置项不存在导致的失效问题：

subprojects {
    // 仅当子项目应用java插件时，添加Mockito测试依赖
    pluginManager.withPlugin('java') {
        dependencies {
            testImplementation libs.mockito.core
            testImplementation libs.mockito.junit.jupiter
        }
    }

    // 若子项目使用java-library插件，可按需补充配置
    pluginManager.withPlugin('java-library') {
        // 示例：添加API级别的依赖
        // api libs.some.library
    }
}

3. 验证配置生效 #

执行命令查看子项目的依赖树，确认Mockito依赖已被正确引入：

./gradlew 子项目名称:dependencies

在输出的testRuntimeClasspath节点下，检查是否包含Mockito相关依赖条目。

额外说明 #

• Gradle 8.0.1默认自动加载根项目gradle/libs.versions.toml中的版本目录，无需在settings.gradle中额外配置（若使用自定义路径则需补充对应配置）。
• 若部分子项目有特殊依赖需求，可在自身build.gradle中补充或覆盖依赖，Gradle会自动合并所有配置。

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