摇篮安装
如果您只想运行现有的 Gradle 项目，并且构建使用Gradle Wrapper ，则无需安装 Gradle 。这可以通过项目根目录中是否存在gradlew或文件来识别：gradlew.bat
. (1) ├── gradle │ └── wrapper (2) ├── gradlew (3) ├── gradlew.bat (3) └── ⋮
| 1 | 项目根目录。 |
| 2 | Gradle 包装器。 |
| 3 | 用于执行 Gradle 构建的脚本。 |
如果gradlew或gradlew.bat文件已存在于您的项目中，则无需安装 Gradle。但您需要确保您的系统满足 Gradle 的先决条件。
如果您想更新项目的 Gradle 版本，可以按照升级 Gradle 部分中的步骤进行操作。请使用Gradle Wrapper升级 Gradle。
Android Studio 附带了 Gradle 的有效安装，因此当您仅在该 IDE 中工作时，无需单独安装 Gradle。
如果您不满足上述条件并决定在计算机上安装 Gradle，请首先通过gradle -v在终端中运行来检查 Gradle 是否已安装。如果该命令没有返回任何内容，则 Gradle 尚未安装，您可以按照以下说明进行操作。
您可以在 Linux、macOS 或 Windows 上安装 Gradle Build Tool。安装可以手动完成，也可以使用像SDKMAN 这样的包管理器完成！或自制。
您可以在版本页面上找到所有 Gradle 版本及其校验和。
先决条件
Gradle 可以在所有主要操作系统上运行。它需要Java 开发工具包(JDK) 版本 8 或更高版本才能运行。您可以检查兼容性矩阵以获取更多信息。
要检查，请运行java -version：
❯ java -version openjdk version "11.0.18" 2023-01-17 OpenJDK Runtime Environment Homebrew (build 11.0.18+0) OpenJDK 64-Bit Server VM Homebrew (build 11.0.18+0, mixed mode)
❯ java version "1.8.0_151" Java(TM) SE Runtime Environment (build 1.8.0_151-b12) Java HotSpot(TM) 64-Bit Server VM (build 25.151-b12, mixed mode)
Gradle 使用它在您的路径中找到的 JDK、IDE 使用的 JDK 或项目指定的 JDK。在此示例中，$PATH 指向 JDK17：
❯ echo $PATH /opt/homebrew/opt/openjdk@17/bin
您还可以将JAVA_HOME环境变量设置为指向特定的JDK安装目录。当安装了多个 JDK 时，这尤其有用：
❯ echo %JAVA_HOME% C:\Program Files\Java\jdk1.7.0_80
❯ echo $JAVA_HOME /Library/Java/JavaVirtualMachines/jdk-16.jdk/Contents/Home
Linux安装
使用包管理器安装
SDKMAN！是一个用于管理大多数类 Unix 系统（macOS、Linux、Cygwin、Solaris 和 FreeBSD）上多个软件开发套件的并行版本的工具。 Gradle由SDKMAN部署和维护！：
❯ sdk install gradle
其他包管理器也可用，但它们分发的 Gradle 版本不受 Gradle, Inc. 控制。Linux 包管理器可能会分发与官方版本不兼容或不完整的 Gradle 修改版本。
手动安装
第 1 步 -下载最新的 Gradle 发行版
分发 ZIP 文件有两种形式：
-
仅二进制 (bin)
-
完整（全部）包含文档和来源
我们建议下载bin文件；它是一个较小的文件，可以快速下载（并且可以在线获取最新的文档）。
第 2 步 - 解压发行版
将分发 zip 文件解压缩到您选择的目录中，例如：
❯ mkdir /opt/gradle ❯ unzip -d /opt/gradle gradle-8.7-bin.zip ❯ ls /opt/gradle/gradle-8.7 LICENSE NOTICE bin README init.d lib media
第 3 步 - 配置您的系统环境
要安装 Gradle，解压文件的路径需要位于您的 Path 中。配置PATH环境变量以包含bin解压发行版的目录，例如：
❯ export PATH=$PATH:/opt/gradle/gradle-8.7/bin
或者，您也可以添加环境变量GRADLE_HOME并将其指向解压缩的发行版。PATH您可以将特定版本的 Gradle 添加$GRADLE_HOME/bin到您的PATH.升级到不同版本的 Gradle 时，只需更改GRADLE_HOME环境变量即可。
export GRADLE_HOME=/opt/gradle/gradle-8.7
export PATH=${GRADLE_HOME}/bin:${PATH}
macOS安装
手动安装
第 1 步 -下载最新的 Gradle 发行版
分发 ZIP 文件有两种形式：
-
仅二进制 (bin)
-
完整（全部）包含文档和来源
我们建议下载bin文件；它是一个较小的文件，可以快速下载（并且可以在线获取最新的文档）。
第 2 步 - 解压发行版
将分发 zip 文件解压缩到您选择的目录中，例如：
❯ mkdir /usr/local/gradle ❯ unzip gradle-8.7-bin.zip -d /usr/local/gradle ❯ ls /usr/local/gradle/gradle-8.7 LICENSE NOTICE README bin init.d lib
第 3 步 - 配置您的系统环境
要安装 Gradle，解压文件的路径需要位于您的 Path 中。配置PATH环境变量以包含bin解压发行版的目录，例如：
❯ export PATH=$PATH:/usr/local/gradle/gradle-8.7/bin
或者，您也可以添加环境变量GRADLE_HOME并将其指向解压缩的发行版。PATH您可以将特定版本的 Gradle 添加$GRADLE_HOME/bin到您的PATH.升级到不同版本的 Gradle 时，只需更改GRADLE_HOME环境变量即可。
最好.bash_profile在主目录中编辑以添加GRADLE_HOME变量：
export GRADLE_HOME=/usr/local/gradle/gradle-8.7 export PATH=$GRADLE_HOME/bin:$PATH
Windows安装
手动安装
第 1 步 -下载最新的 Gradle 发行版
分发 ZIP 文件有两种形式：
-
仅二进制 (bin)
-
完整（全部）包含文档和来源
我们建议下载 bin 文件。
第 2 步 - 解压发行版
C:\Gradle使用文件资源管理器创建一个新目录。
打开第二个文件资源管理器窗口并转到下载 Gradle 发行版的目录。双击 ZIP 存档以公开内容。将内容文件夹拖到gradle-8.7新创建的C:\Gradle文件夹中。
C:\Gradle或者，您可以使用您选择的归档工具将 Gradle 发行版 ZIP 解压。
第 3 步 - 配置您的系统环境
要安装 Gradle，解压文件的路径需要位于您的 Path 中。
在文件资源管理器中，右键单击This PC(或Computer) 图标，然后单击Properties→ Advanced System Settings→ Environmental Variables。
在System Variables选择下Path，然后单击Edit。添加一个条目C:\Gradle\gradle-8.7\bin.单击OK保存。
或者，您可以添加环境变量GRADLE_HOME并将其指向解压缩的发行版。Path您可以将特定版本的 Gradle 添加%GRADLE_HOME%\bin到您的Path.升级到不同版本的Gradle时，只需更改GRADLE_HOME环境变量即可。
验证安装
打开控制台（或 Windows 命令提示符）并运行gradle -vgradle 并显示版本，例如：
❯ gradle -v ------------------------------------------------------------ Gradle 8.7 ------------------------------------------------------------ Build time: 2023-03-03 16:41:37 UTC Revision: 7d6581558e226a580d91d399f7dfb9e3095c2b1d Kotlin: 1.8.10 Groovy: 3.0.13 Ant: Apache Ant(TM) version 1.10.11 compiled on July 10 2021 JVM: 17.0.6 (Homebrew 17.0.6+0) OS: Mac OS X 13.2.1 aarch64
您可以通过下载 SHA-256 文件（可从发布页面获取）并遵循这些验证说明来验证 Gradle 发行版的完整性。