搁胱 发表于 2025-10-5 19:26:55

Gradle读取仓库配置文件的优先级

Gradle 在读取仓库配置文件(如 settings.gradle 或 build.gradle 中定义的 repositories)时,遵循一定的优先级规则。以下是 Gradle 读取仓库配置文件的优先级顺序:
1. 项目级配置文件


[*]settings.gradle:

[*]这是 Gradle 项目的入口文件,定义了项目的模块结构和仓库配置。
[*]优先级最高,Gradle 会首先读取此文件中的仓库配置。

[*]build.gradle:

[*]项目根目录下的 build.gradle 文件中的 repositories 块。
[*]优先级次之,Gradle 会在此文件中查找仓库配置。

2. 子模块配置文件


[*]如果项目是多模块的,每个子模块的 build.gradle 文件中的 repositories 块也会被读取。
[*]子模块的配置会覆盖父模块的配置(如果存在冲突)。
3. Gradle 用户全局配置


[*]init.gradle:

[*]位于 ~/.gradle/init.gradle(或 %USERPROFILE%\\.gradle\\init.gradle)。
[*]此文件中的仓库配置会被应用到所有 Gradle 项目。
[*]优先级低于项目级配置。

[*]gradle.properties:

[*]位于 ~/.gradle/gradle.properties(或 %USERPROFILE%\\.gradle\\gradle.properties)。
[*]可以定义全局的仓库镜像或代理设置。

4. Gradle 默认配置


[*]如果没有显式配置仓库,Gradle 会使用默认的 mavenCentral() 作为仓库。
[*]默认配置的优先级最低。
5. 依赖解析顺序


[*]当 Gradle 解析依赖时,会按照以下顺序检查仓库:
[*]本地缓存(~/.gradle/caches)。
[*]本地 Maven 仓库(~/.m2/repository)。
[*]项目配置的远程仓库(按 repositories 块中的顺序)。
[*]全局配置的远程仓库(如 init.gradle 中定义的)。

示例配置

以下是一个典型的 settings.gradle 和 build.gradle 配置示例:
settings.gradle

pluginManagement {
    repositories {
      gradlePluginPortal() // Gradle 插件仓库
      google() // Google 仓库
      mavenCentral() // Maven 中央仓库
    }
}build.gradle

repositories {
    mavenLocal() // 本地仓库
    mavenCentral() // Maven 中央仓库
    google() // Google 仓库
    maven { url 'https://jitpack.io' } // 自定义仓库
}总结

Gradle 读取仓库配置文件的优先级为:

[*]settings.gradle → 2. 项目级 build.gradle → 3. 子模块 build.gradle → 4. 全局配置(init.gradle 或 gradle.properties)→ 5. 默认配置。
如果需要调试仓库配置,可以使用以下命令查看依赖解析详情:
gradlew dependencies --scan
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
页: [1]
查看完整版本: Gradle读取仓库配置文件的优先级