Gradlex 下载工具加速 Gradle 下载

567 阅读2分钟

前言

由于网络环境越来越复杂,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 下载。

下载安装

下载地址:github.com/Jacknic/gra…

如果你想在任何路径下都能使用 gradlex 命令,你需要将 gradlex 添加到 PATH 中,否则你只能在 gradlex 文件所在位置打开命令行窗口。

配置

国内常用镜像地址列表:

  1. 腾讯云 mirrors.cloud.tencent.com/gradle/
  2. 阿里云 mirrors.aliyun.com/macports/di…
  3. 华为云 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 指定版本类型,支持 binall 两种类型。

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