# 写给 JVM 平台开发者的镜像站配置指南

# gradle 下载加速

Gradle (opens new window) 是一个基于 Apache Ant 和 Apache Maven 概念的项目自动化建构工具。

下载 gradle 时,分为 2 种类型:

  • gradle v8.0 为例
  1. gradle-8.0-all.zip,包含运行时(runtime)、样板代码、文档;建议选择 all 版本
  2. gradle-8.0-bin.zip,只包含有运行时(runtime)

# 修改下载 gradle 的地址

修改项目下的 gradle/wrapper 文件夹下的 gradle-wrapper.properties 文件;

distributionSha256Sum=cb87f222c5585bd46838ad4db78463a5c5f3d336e5e2b98dc7c0c586527351c2
distributionUrl=https\://repo.huaweicloud.com/gradle/gradle-7.5-bin.zip
1
2

修改 distributionUrl 为镜像站的地址;

另外,强烈建议配置 SHA256 校验,以保证传输数据的完整性;如果 SHA256 不匹配,则编译时会报错;

警告

Android Studio 中配置可能导致 IDE 报错,可以使用手动校验的方式进行校验;

SHA256 的检验值,请访问:Gradle | Releases (opens new window) 检查;

# 中国大陆镜像站

# 华为云镜像站

Index of gradle (huaweicloud.com) (opens new window)

华为云镜像站这边,gradle以独立仓库形式提供服务;

地址为:https://repo.huaweicloud.com/gradle/

# 阿里云镜像站

阿里云镜像站并未对 gradle 开辟新的仓库,以独立的镜像仓库提供给用户。

但提供的 MacPorts镜像 (opens new window),其中含有完整的 gradle zip 包;

地址为:https://mirrors.aliyun.com/macports/distfiles/gradle/

# 腾讯云镜像站

提示

不推荐 腾讯云镜像站,2023-02-20发现没有 v8 版本;看起来更新不及时;优先选择其他镜像站

地址为:https://mirrors.cloud.tencent.com/gradle/


# 源站真的慢?

源站下载地址为:Gradle | Releases (opens new window);源站使用了 Cloudflare (opens new window) 的服务,在中国大陆访问,速度较慢;

gradle-download-page

但是当点击上面超链接下载时,中国大陆的用户,下载使用的域名为:downloads.gradle-dn.com,该域名指向中国大陆的一个 IP,且拥有备案;

经过测试,该域名下载速度极快,千兆宽带下,可以跑到 30MB/S 秒,基本上可以在 5 秒内完成下载。

完整的配置如下:

distributionSha256Sum=f30b29580fe11719087d698da23f3b0f0d04031d8995f7dd8275a31f7674dc01
distributionUrl=https\://downloads.gradle-dn.com/distributions/gradle-8.0-all.zip
1
2

如果使用其他版本,那么修改下 URL 的版本号即可;


# maven 下载加速

华为云镜像站地址为:Index of apache-local/maven/maven-3 (huaweicloud.com) (opens new window)

这里只有 maven3 了,因为 maven2 的结束了支持,后续不再更新维护。


# maven 仓库镜像站配置

# 镜像站

以下排名不分先后,请根据自己的网络情况、速度情况,择优选择;

# 腾讯云镜像站

项目地址为:maven (tencent.com) (opens new window)

配置样例:

repositories {
    maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }
}
1
2
3

提示

腾讯云的 maven 支持 https 协议;建议使用 https 协议

# 阿里云镜像站点

项目的地址为:仓库服务 (aliyun.com) (opens new window)

配置样例:

repositories {
    maven { url 'https://maven.aliyun.com/repository/central' }
    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' }
    maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
}
1
2
3
4
5
6
7

友情提醒

阿里云云效提醒:

自2022.12.12起,受 Maven 中央仓库网络限制,阿里云云效 Maven 中央代理仓库可能会出现部分新增依赖查找不到的情况,但不影响已有依赖,请知悉

# 华为云镜像站

项目的地址为:Maven镜像 - 华为云 (huaweicloud.com) (opens new window)

配置样例:

repositories {
    maven { url 'https://repo.huaweicloud.com/repository/maven/' }
}
1
2
3

华为云聚合了多个上游站点;配置起来只需要写一行仓库地址,较为方便;

# 163网易镜像站

项目地址为:Maven镜像使用帮助 (163.com) (opens new window)

配置样例:

repositories {
    maven { url 'https://mirrors.163.com/maven/repository/maven-public/' }
}
1
2
3

163 镜像站支持 https;建议用户使用 https 协议进行传输;

注意

没有收录 Android 项目的一部分依赖包;

此外,163 镜像站支持镜像的搜索(powerd by nexus),地址为:Search - Nexus Repository Manager (163.com) (opens new window)


# 实战配置

参见:Android 开发中的代理设定