本文旨在解决 Gradle 项目中子项目依赖传递性仓库的问题。当一个子项目依赖于另一个子项目，而被依赖的子项目使用了特定的 Maven 仓库时，本文将介绍如何在 Gradle 中配置，使得依赖子项目能够自动访问所需的仓库，避免重复配置，简化构建脚本。
在多模块的 Gradle 项目中，一个常见的需求是让子项目能够访问其他子项目所依赖的仓库。例如，core 模块依赖于 api 模块，而 api 模块依赖于 spongepowered 仓库中的库。如果 core 模块在编译时无法找到 spongepowered 仓库，就会出现编译错误。虽然可以在 core 模块中重复配置 spongepowered 仓库，但这会增加配置的冗余，不利于维护。
解决这个问题，最佳实践是在根目录的 settings.gradle 文件中声明所有子项目共享的仓库。这样，所有子项目都可以访问这些仓库，而无需单独配置。
配置 settings.gradle 文件
在项目的根目录下，找到 settings.gradle 文件（如果不存在，则创建它）。在该文件中，添加 dependencyResolutionManagement 块，并在其中配置 repositories：
dependencyResolutionManagement {
repositories {
mavenCentral() // 默认的 Maven 中央仓库
maven { url 'https://repo.spongepowered.org/repository/maven-public/' } // Spongepowered 仓库
}
}在这个配置中，mavenCentral() 添加了 Maven 中央仓库，而 maven { url 'https://repo.spongepowered.org/repository/maven-public/' } 添加了 Spongepowered 仓库。 这样配置后，所有子项目，包括 api 和 core，都可以访问这两个仓库。
示例项目结构
假设项目结构如下：
my-project/ ├── api/ │ └── build.gradle ├── core/ │ └── build.gradle └── settings.gradle
api/build.gradle:
plugins {
id 'java-library'
}
repositories {
mavenCentral() // 可选：如果 settings.gradle 中没有配置 mavenCentral
}
dependencies {
api('org.spongepowered:spongeapi:8.0.0')
}core/build.gradle:
plugins {
id 'java'
}
dependencies {
implementation(project(':api'))
}settings.gradle:
dependencyResolutionManagement {
repositories {
mavenCentral()
maven { url 'https://repo.spongepowered.org/repository/maven-public/' }
}
}注意事项
- 确保 settings.gradle 文件位于项目的根目录下。
- dependencyResolutionManagement 块是 Gradle 较新版本推荐的配置方式。如果使用旧版本 Gradle，可能需要使用不同的配置方式，例如直接在 build.gradle 中配置 allprojects { repositories { ... } }。
- 如果子项目需要访问私有仓库，可以在 settings.gradle 中配置相应的认证信息。
总结
通过在 settings.gradle 文件中集中管理仓库配置，可以避免在每个子项目中重复配置，提高构建脚本的可维护性。 这种方式也确保了所有子项目都能够访问所需的仓库，从而简化了依赖管理。 这种方法尤其适用于大型多模块项目，能够显著降低配置复杂度和维护成本。
