配置 Gradle 镜像加速(依赖下载层)
即使配置了代理,国内访问 services.gradle.org
可能仍较慢。建议将 Gradle 仓库替换为国内镜像(如阿里云、腾讯云):
1. 修改 gradle-wrapper.properties
在项目根目录的 gradle/wrapper/gradle-wrapper.properties
文件中,修改 distributionUrl
为国内镜像地址:
# 原地址(注释或删除)
# distributionUrl=https://services.gradle.org/distributions/gradle-8.13-bin.zip
# 腾讯云镜像
distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.13-bin.zip
# 阿里云镜像
# distributionUrl=https://mirrors.aliyun.com/gradle/gradle-8.13-bin.zip
2. 配置项目级仓库镜像
在 settings.gradle
或 build.gradle
中替换仓库地址:
// settings.gradle (新版本 Android Studio)
pluginManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
gradlePluginPortal()
}
}
// build.gradle (旧版本)
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
google()
mavenCentral()
}
}
验证配置
-
同步项目:点击 Android Studio 右上角的
Sync Now
,观察依赖下载速度是否提升。 -
手动触发下载:
- 执行
File > Invalidate Caches / Restart
清理缓存。 - 在终端运行
./gradlew build --refresh-dependencies
强制刷新依赖。
- 执行
常见问题解决
1. 代理配置无效
- 检查代理地址和端口:确保与网络环境一致(如公司代理可能需要用户名/密码)。
- 关闭 VPN 或防火墙:部分安全软件可能拦截代理流量。
2. Gradle 下载失败
-
手动下载 Gradle:
- 从镜像地址下载
gradle-8.13-bin.zip
。 - 放置到路径:
~/.gradle/wrapper/dists/gradle-8.13-bin/<随机目录>/
。 - 重新同步项目,Gradle 会自动解压使用 。
- 从镜像地址下载
-
检查网络策略:某些代理可能限制访问
maven.aliyun.com
,需联系网络管理员调整规则。
五、推荐镜像地址
服务商 | Gradle 镜像地址 | Maven 仓库地址 |
---|---|---|
腾讯云 | https://mirrors.cloud.tencent.com/gradle | https://mirrors.cloud.tencent.com/maven |
阿里云 | https://mirrors.aliyun.com/gradle | https://mirrors.aliyun.com/maven |
华为云 | https://repo.huaweicloud.com/repository/gradle | https://repo.huaweicloud.com/repository/maven |
总结
通过 代理设置 解决网络访问限制,再通过 Gradle 镜像加速 提升依赖下载速度,可有效解决国内开发环境下的网络问题。若仍遇问题,建议优先检查镜像地址的可用性,并尝试切换不同服务商的镜像。