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