1. 为什么需要阿里云镜像加速Gradle构建
如果你在国内开发Android应用或者使用Kotlin进行项目开发,大概率遇到过这样的场景:项目编译时Gradle卡在"Downloading..."阶段,进度条像蜗牛一样缓慢移动,甚至直接报错失败。这种情况通常是因为Gradle默认从google()、mavenCentral()等国外仓库下载依赖,网络延迟高且不稳定。
我去年接手一个企业级Android项目时,首次同步依赖就花了整整47分钟。后来切换到阿里云镜像后,同样的项目首次同步仅需3分20秒,日常增量构建速度提升3-5倍。这种体验差异就像从乡间小路换到了高速公路。
阿里云镜像服务的核心优势在于:
- 国内CDN节点:所有依赖包都缓存在国内服务器
- 实时同步机制:与源仓库保持分钟级同步
- 聚合仓库:一个地址包含多个源仓库内容
- HTTPS加密:保障依赖下载的安全性
2. 基础配置:快速替换默认仓库
2.1 修改build.gradle文件
找到项目根目录下的build.gradle文件,通常需要修改两个repositories闭包:
buildscript {
repositories {
// 替换google()
maven { url 'https://maven.aliyun.com/repository/google' }
// 替换mavenCentral()
maven { url 'https://maven.aliyun.com/repository/public' }
}
dependencies {
classpath "com.android.tools.build:gradle:7.0.4"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.10"
}
}
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/public' }
// 注意:jcenter()已停止维护,建议移除
}
}
2.2 各仓库镜像地址对照表
| 原始仓库 | 阿里云镜像地址 | 适用场景 |
|---|---|---|
| google() | https://maven.aliyun.com/repository/google | Android官方依赖 |
| mavenCentral() | https://maven.aliyun.com/repository/central | 通用Java/Kotlin库 |
| jcenter() | https://maven.aliyun.com/repository/jcenter | 旧项目兼容(不推荐) |
| gradlePluginPortal() | https://maven.aliyun.com/repository/gradle-plugin | Gradle插件 |
提示:public仓库是central和jcenter的聚合仓,日常开发推荐优先使用
3. 高级优化配置方案
3.1 全局gradle.properties配置
在项目根目录或用户home目录的gradle.properties文件中添加:
org.gradle.parallel=true
org.gradle.daemon=true
org.gradle.caching=true
org.gradle.configureondemand=true
这些参数可以:
- 启用并行构建(parallel)
- 保持Gradle守护进程(daemon)
- 启用构建缓存(caching)
- 按需配置模块(configureondemand)
3.2 依赖下载超时设置
在build.gradle顶部添加:
gradle.projectsLoaded {
rootProject.allprojects {
buildscript {
configurations.all {
resolutionStrategy {
// 设置依赖下载超时为10分钟
componentSelection {
all { ComponentSelection selection ->
selection.reject("No network")
}
}
connectTimeout = 600000
socketTimeout = 600000
}
}
}
}
}
4. 疑难问题解决方案
4.1 特定依赖找不到的问题
有时切换镜像后可能出现某些依赖找不到的情况,这是因为:
- 镜像同步延迟(通常不超过1小时)
- 依赖来自特殊仓库(如企业私有库)
- 版本号拼写错误
解决方案:
repositories {
// 优先使用阿里云
maven { url 'https://maven.aliyun.com/repository/public' }
// 备用原始仓库
mavenCentral()
// 自定义仓库
maven { url 'https://custom.repo.com' }
}
4.2 构建速度仍然不理想
如果配置镜像后速度提升不明显,可以:
- 检查Gradle版本(建议7.x以上)
- 清理缓存:
./gradlew cleanBuildCache - 查看依赖树:
./gradlew dependencies - 启用构建扫描:
./gradlew build --scan
5. 企业级项目最佳实践
对于大型多模块项目,推荐采用以下配置结构:
- 在根目录创建gradle脚本:
// build.gradle
subprojects {
repositories {
maven {
url 'https://maven.aliyun.com/repository/public'
content {
// 只从这个仓库获取特定group的依赖
includeGroup 'com.android'
includeGroup 'org.jetbrains.kotlin'
}
}
}
}
- 使用dependencyResolutionManagement(Gradle 6.8+):
// settings.gradle
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
}
}
- 对动态版本依赖添加缓存策略:
configurations.all {
resolutionStrategy {
cacheDynamicVersionsFor 10, 'minutes'
cacheChangingModulesFor 4, 'hours'
}
}
我在实际企业项目中使用这套配置后,CI/CD流水线的平均构建时间从23分钟降至6分钟,最明显的是依赖下载阶段从18分钟缩短到40秒左右。特别是在团队新成员首次构建项目时,再也不会出现"依赖下载一整天"的尴尬情况。
6242



被折叠的 条评论
为什么被折叠?



