1. 为什么需要替换Gradle默认仓库如果你在国内做Android开发大概率遇到过Gradle构建时卡在Downloading...的情况。我刚开始接触Android开发时每次同步项目都要等上十几分钟甚至经常因为网络问题直接失败。后来才发现这是因为Gradle默认使用的mavenCentral()、jcenter()和google()仓库服务器都在国外。这里有个常见的误区很多人以为只要开了代理就能解决问题。但实际开发中团队协作、CI/CD环境、不同网络环境下依赖代理并不现实。我在五个不同的项目组工作过没有一个团队会统一配置代理工具。更不用说有些企业内网根本不允许使用代理。阿里云提供的镜像仓库完美解决了这个问题。它定时同步国外主流仓库的内容在国内访问速度能提升5-10倍。我做过实测从google()仓库下载com.android.tools.build:gradle:7.0.0平均需要3分钟同样的依赖从阿里云镜像下载仅需20秒2. 阿里云镜像仓库配置详解2.1 基础配置方式在项目的build.gradle文件中我们需要修改两个关键部分buildscript { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/jcenter } maven { url https://maven.aliyun.com/repository/public } } dependencies { classpath com.android.tools.build:gradle:7.0.0 } } allprojects { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/jcenter } maven { url https://maven.aliyun.com/repository/public } } }注意几个关键点现在推荐使用https协议而非http阿里云已经将仓库地址标准化为统一格式public仓库包含了Maven Central的内容2.2 多模块项目配置技巧对于包含多个子模块的项目我推荐在根项目的build.gradle中使用subprojects闭包subprojects { repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } if (project.name.contains(special-module)) { maven { url https://custom.registry.example.com } } } }这种配置方式可以避免在每个子模块中重复声明同时保留了为特定模块添加特殊仓库的灵活性。3. 高级优化方案3.1 仓库访问优先级设置Gradle会按照声明的顺序检查仓库我们可以利用这个特性优化构建速度repositories { // 1. 首先检查本地缓存 mavenLocal() // 2. 然后检查阿里云镜像 maven { url https://maven.aliyun.com/repository/public content { includeGroupByRegex com\\.android.* includeGroup org.jetbrains.kotlin } } // 3. 最后回退到原始仓库 google() mavenCentral() }这种配置可以确保已下载的依赖直接从本地获取Android和Kotlin相关依赖优先从阿里云获取其他依赖回退到原始仓库3.2 仓库镜像全局配置如果你管理多个项目可以在USER_HOME/.gradle/init.gradle中添加全局配置allprojects { repositories { all { repo - if (repo instanceof MavenArtifactRepository) { def url repo.url.toString() if (url.contains(repo1.maven.org/maven2)) { repo.url https://maven.aliyun.com/repository/public } else if (url.contains(jcenter.bintray.com)) { repo.url https://maven.aliyun.com/repository/jcenter } else if (url.contains(dl.google.com)) { repo.url https://maven.aliyun.com/repository/google } } } } }这个技巧我在团队协作环境中特别推荐它能确保所有开发者自动使用镜像仓库无需手动修改每个项目。4. 常见问题排查4.1 依赖找不到的解决方案有时候即使配置了镜像还是会出现依赖找不到的情况。这通常是因为镜像同步延迟阿里云镜像不是实时同步的新发布的库可能有几小时延迟特殊仓库需求有些公司私有库需要额外配置解决方法repositories { // 先检查阿里云 maven { url https://maven.aliyun.com/repository/public } // 如果找不到回退到原始仓库 mavenCentral { content { excludeGroupByRegex com\\.android.* } } // 特殊仓库 maven { url https://jitpack.io } }4.2 构建速度优化实测我用一个中型项目约150个依赖做了对比测试配置方式冷构建时间增量构建时间默认仓库8m23s1m12s仅阿里云2m45s45s混合策略1m58s38s混合策略指的是结合本地缓存、阿里云镜像和原始仓库的配置方式。从数据可以看出合理的仓库配置能显著提升构建效率。