在Android项目中配置Gradle使用阿里云镜像仓,可显著提升依赖下载速度。以下是详细配置步骤:
配置项目级build.gradle
打开项目根目录的build.gradle
文件,修改buildscript
和allprojects
部分:
buildscript {
repositories {
// 阿里云镜像仓
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
}
dependencies {
classpath 'com.android.tools.build:gradle:7.0.4' // 保持原版本
}
}
allprojects {
repositories {
// 阿里云镜像仓
maven { url 'https://maven.aliyun.com/repository/public' }
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
// 原有仓库可注释掉
// google()
// mavenCentral()
}
}
配置Gradle Wrapper(可选)
在gradle-wrapper.properties
中指定阿里云镜像源:
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-7.0.2-bin.zip
# 或阿里云镜像
# distributionUrl=https://maven.aliyun.com/repository/gradle-distributions/gradle-7.0.2-bin.zip
注意事项
-
镜像仓地址说明:
- 公共仓库:
https://maven.aliyun.com/repository/public
- Google专属:
https://maven.aliyun.com/repository/google
- Gradle插件:
https://maven.aliyun.com/repository/gradle-plugin
- Maven中央仓:
https://maven.aliyun.com/repository/central
- 公共仓库:
-
同步操作:
修改后点击Android Studio右上角的 Sync Project with Gradle Files 按钮 -
问题排查:
- 若同步失败,检查网络是否屏蔽阿里云域名
- 部分私有仓库仍需单独配置
- 可保留原始仓库作为备用:
maven { url 'https://maven.aliyun.com/...' } mavenCentral() // 备用
⚠️ 提示:阿里云镜像仓同步周期约为2小时,若遇极新依赖库请暂时切回官方源。
配置完成后,Gradle将从阿里云镜像优先下载依赖,有效解决国内开发者访问慢的问题。