安装
当前 Gradle 版本是 8.13。您可以从 版本发布页面 下载二进制文件并查看所有 Gradle 版本的文档。
前提条件
Gradle 在所有主流操作系统上运行，仅需安装 Java JDK 8 或更高版本。要检查，请运行 java -version
$ java -version
java version "1.8.0_121"
额外资源
- Gradle 用户可以免费获得按需和直播 在线培训。
- 除了 文档 之外，自定进度的 教程 也是尝试使用各种语言的 Gradle 的好地方。
- Gradle 有一个可视化构建检查工具：Build Scan™。
- 最后，Gradle 新闻通讯 是保持
最新状态的好方法，每月精心制作。
使用包管理器安装
SDKMAN! 是一个用于在大多数基于 Unix 的系统上管理多个软件开发工具包并行版本的工具。
$ sdk install gradle 8.13
Homebrew 是 “macOS 缺失的软件包管理器”。
$ brew install gradle
其他包管理器也可用，但它们分发的 Gradle 版本不受 Gradle 公司控制。Linux 包管理器可能会分发 Gradle 的修改版本，与官方版本（可从 SDKMAN! 或以下获取）相比，该版本可能不兼容或不完整。
› 额外的有帮助的信息
手动安装
步骤 1. 下载 最新的 Gradle 发行版
当前 Gradle 版本是 8.13 版本，于 2025 年 2 月 25 日发布。发行版 zip 文件有两种类型
如果有疑问，请选择仅二进制版本，并在网上浏览 文档 和 源代码。
需要使用旧版本？请查看 版本发布页面。
步骤 2. 解压发行版
Linux 和 MacOS 用户
将发行版 zip 文件解压到您选择的目录中，例如：
$ mkdir /opt/gradle
$ unzip -d /opt/gradle gradle-8.13-bin.zip
$ ls /opt/gradle/gradle-8.13
LICENSE NOTICE bin getting-started.html init.d lib media
Microsoft Windows 用户
使用 文件资源管理器 创建一个新目录 C:\Gradle。
打开第二个 文件资源管理器 窗口，转到 Gradle 发行版下载的目录。双击 ZIP 压缩文件以展开内容。将内容文件夹 gradle-8.13 拖到您新创建的 C:\Gradle 文件夹中。
或者，您可以使用您选择的归档工具将 Gradle 发行版 ZIP 解压到 C:\Gradle 中。
步骤 3. 配置您的系统环境
Linux 和 MacOS 用户
配置您的 PATH 环境变量，以包含解压后的发行版的 bin 目录，例如：
$ export PATH=$PATH:/opt/gradle/gradle-8.13/bin
Microsoft Windows 用户
在 文件资源管理器 中，右键单击 “此电脑”（或 “计算机”）图标，然后单击 “属性” -> “高级系统设置” -> “环境变量”。
在 “系统变量” 下，选择 “Path”，然后单击 “编辑”。为 C:\Gradle\gradle-8.13\bin 添加一个条目。单击 “确定” 保存。
步骤 4. 验证您的安装
打开控制台（或 Windows 命令提示符）并运行 gradle -v 以运行 gradle 并显示版本，例如：
$ gradle -v
------------------------------------------------------------
Gradle 8.13
------------------------------------------------------------
› 额外的有帮助的信息
使用 Gradle Wrapper 升级
如果您现有的基于 Gradle 的构建使用 Gradle Wrapper，您可以通过运行 wrapper 任务并指定所需的 Gradle 版本来轻松升级
$ ./gradlew wrapper --gradle-version=8.13 --distribution-type=bin
请注意，使用 Gradle wrapper 不需要安装 Gradle。下次调用 gradlew 或 gradlew.bat 将下载并缓存指定版本的 Gradle。
$ ./gradlew tasks
Downloading https://services.gradle.org/distributions/gradle-8.13-bin.zip
...
› 额外的有帮助的信息
旧版本
您可以在 版本发布页面 上找到所有版本及其校验和。
命令行补全
命令行补全 脚本适用于 bash 和 zsh。这为 Gradle 任务和命令行选项提供补全功能。