Gradle 在国内访问官方仓库(如 Maven Central 或 JCenter)时,可能会受到网络限制影响,速度较慢甚至无法连接。为解决此问题,可以配置国内镜像源,提高构建效率
推荐的国内镜像源
以下是常用的国内 Gradle 仓库镜像:
阿里云 Maven 仓库:
地址:https://maven.aliyun.com/repository/public
华为云 Maven 仓库:
地址:https://repo.huaweicloud.com/repository/maven/
腾讯云 Maven 仓库:
地址:https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
清华大学开源镜像站:
地址:https://mirrors.tuna.tsinghua.edu.cn/maven/
中国科学技术大学开源镜像站:
地址:https://mirrors.ustc.edu.cn/maven/
配置方法
1. 修改 build.gradle
文件
在每个项目的 build.gradle
文件中,添加自定义的仓库配置:
repositories {
maven {
url "https://maven.aliyun.com/repository/public"
}
mavenCentral() // 保留原始 Maven 中央库作为备选
}
2. 修改全局配置
如果希望全局生效,可以修改 Gradle 的全局配置文件(适用于所有项目):
定位配置文件:
Windows: C:\Users\<你的用户名>\.gradle\init.d\init.gradle
macOS/Linux: ~/.gradle/init.d/init.gradle
如果 init.d
目录不存在,可以手动创建。
添加镜像配置: 在 init.gradle
文件中写入以下内容:
allprojects {
repositories {
maven { url 'https://maven.aliyun.com/repository/public' }
mavenCentral() // 原始中央库
google() // Android 项目需要保留 Google 仓库
}
}
3. 使用 Gradle 属性文件
在 ~/.gradle/gradle.properties
文件中,添加以下内容以优化下载行为:
org.gradle.daemon=true
org.gradle.parallel=true
org.gradle.configureondemand=true
这将加速构建,但需确保使用国内镜像来下载依赖。
验证配置是否生效
清除缓存:
gradle clean build --refresh-dependencies
检查构建日志,确认下载的依赖来自配置的镜像地址(如 aliyun.com
)。
通过上述方法,Gradle 国内镜像配置完成。如果构建仍然缓慢,可检查网络代理、DNS 配置是否正常或切换其他镜像源。
发布者:myrgd,转载请注明出处:https://www.object-c.cn/4656