前言
由于网络环境越来越复杂,Gradle 的下载时不时的下载异常,这个通常是网络原因。特别是在 Gradle 把下载资源转到 Github 后,下载经常失败或者使用魔法才勉强保持网络通畅。但使用梯子速度上可能也无法保证,这时如果我们能从国内镜像网站下载那么速度将会大大加快,所以才有了 gradlex 这个命令行工具。
使用参考
可以看到在网络速度还可以的情况下,下载对应的版本基本可以做到 10s
内
./gradlex install -v 6.8.3
use proxy: https://mirrors.cloud.tencent.com/gradle/
2024/09/16 14:05:30 https://services.gradle.org/distributions/gradle-6.8.3-all.zip download from
https://mirrors.cloud.tencent.com/gradle/gradle-6.8.3-all.zip => save to /root/.gradle/e7wfe5smmycy2022k905cd7ux.zip
2024/09/16 14:05:33 Downloaded 100% 150631445/150631445
2024/09/16 14:05:33 unzip to /root/.gradle/wrapper/dists/gradle-6.8.3-all/6czipnbiesy2sl92ioo8dht91
2024/09/16 14:05:36 remove file: /root/.gradle/e7wfe5smmycy2022k905cd7ux.zip
2024/09/16 14:05:36 finish
简介
Gradlex 是一个用于 Gradle 下载的工具,可以通过镜像配置加速 Gradle 下载。
下载安装
如果你想在任何路径下都能使用 gradlex 命令,你需要将 gradlex 添加到 PATH 中,否则你只能在 gradlex 文件所在位置打开命令行窗口。
配置
国内常用镜像地址列表:
- 腾讯云 mirrors.cloud.tencent.com/gradle/
- 阿里云 mirrors.aliyun.com/macports/di…
- 华为云 mirrors.huaweicloud.com/gradle/
设置镜像地址环境变量
你需要设置镜像环境变量 GRADLE_DIST_PROXY
,否则 Gradle 包会从官方或原地址下载,而不是镜像地址也就没有加速效果。为了方便使用,建议在 系统环境变量 中设置环境变量,下方的命令行设置仅对当前窗口有效。
- Windows 环境
CMD 中
set GRADLE_DIST_PROXY="https://mirrors.cloud.tencent.com/gradle/"
PowerShell 中
$env:GRADLE_DIST_PROXY="https://mirrors.cloud.tencent.com/gradle/"
- *nix 环境
export GRADLE_DIST_PROXY="https://mirrors.cloud.tencent.com/gradle/"
- 验证环境变量
gradlex env
使用
安装指定版本 Gradle
gradlex install -v 6.8.3
安装指定类型 Gradle
默认下载 all ,你也可以通过 -t
/ --type
指定版本类型,支持 bin
和 all
两种类型。
gradlex i -v 8.2 -t bin
从指定地址安装 Gradle
只要你设置了环境变量 GRADLE_DIST_PROXY
,工具就会解析对应的版本信息,并从指定镜像地址下载对应 Gradle 安装包。项目依赖的 gradle 版本通常在 gradle/wrapper/gradle-wrapper.properties
文件中指定,如果对应版本无法下载,使用 distributionUrl
属性的链接就可以下载对应版本
gradlex i https://services.gradle.org/distributions/gradle-8.7-rc-3-bin.zip
查看 Gradle 版本列表
gradlex list
查看当前已安装的 Gradle 版本
gradlex local