Gradle 安装
如果您只想运行现有的 Gradle 项目，并且该构建使用了 Gradle Wrapper，那么您就不需要安装 Gradle。这可以通过项目根目录中是否存在 gradlew 或 gradlew.bat 文件来识别。
. (1) ├── gradle │ └── wrapper (2) ├── gradlew (3) ├── gradlew.bat (3) └── ⋮
| 1 | 项目根目录。 |
| 2 | Gradle Wrapper. |
| 3 | 用于执行 Gradle 构建的脚本。 |
如果 gradlew 或 gradlew.bat 文件已存在于您的项目中，您不需要安装 Gradle。但您需要确保您的系统满足 Gradle 的先决条件。
如果您想更新项目的 Gradle 版本，可以按照升级 Gradle 部分的步骤操作。请使用Gradle Wrapper 来升级 Gradle。
Android Studio 自带了可用的 Gradle 安装，因此当您只在该 IDE 中工作时，无需单独安装 Gradle。
如果您不符合上述条件并决定在您的机器上安装 Gradle，请首先通过在终端中运行 gradle -v 来检查 Gradle 是否已安装。如果命令没有返回任何内容，则表示 Gradle 未安装，您可以按照以下说明进行操作。
您可以在发布页面找到所有 Gradle 版本及其校验和。
先决条件
Gradle 可以在所有主流操作系统上运行。它需要 Java Development Kit (JDK) 17 或更高版本才能运行。您可以查看兼容性矩阵以获取更多信息。
要检查，请运行 java -version
❯ java -version openjdk version "17.0.6" 2023-01-17 OpenJDK Runtime Environment Temurin-17.0.6+10 (build 17.0.6+10) OpenJDK 64-Bit Server VM Temurin-17.0.6+10 (build 17.0.6+10, 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\jdk17.0_6
❯ echo $JAVA_HOME /Library/Java/JavaVirtualMachines/jdk-17.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)
-
完整版 (all)，包含文档和源码
我们建议下载 bin 文件；它是一个较小的文件，下载速度快（最新文档可在网上获取）。
步骤 2 - 解压分发版
将分发 zip 文件解压到您选择的目录，例如：
❯ mkdir /opt/gradle ❯ unzip -d /opt/gradle gradle-9.0.0-bin.zip ❯ ls /opt/gradle/gradle-9.0.0 LICENSE NOTICE bin README init.d lib media
步骤 3 - 配置您的系统环境
要安装 Gradle，解压后的文件路径需要添加到您的 Path 中。配置您的 PATH 环境变量以包含解压后的分发版的 bin 目录，例如：
❯ export PATH=$PATH:/opt/gradle/gradle-9.0.0/bin
另外，您也可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。然后，您可以将 $GRADLE_HOME/bin 添加到您的 PATH 中，而不是将特定版本的 Gradle 添加到您的 PATH 中。当升级到不同版本的 Gradle 时，只需更改 GRADLE_HOME 环境变量即可。
export GRADLE_HOME=/opt/gradle/gradle-9.0.0
export PATH=${GRADLE_HOME}/bin:${PATH}
macOS 安装
手动安装
步骤 1 - 下载最新的 Gradle 发布版
分发 ZIP 文件有两种形式
-
仅二进制 (bin)
-
完整版 (all)，包含文档和源码
我们建议下载 bin 文件；它是一个较小的文件，下载速度快（最新文档可在网上获取）。
步骤 2 - 解压分发版
将分发 zip 文件解压到您选择的目录，例如：
❯ mkdir /usr/local/gradle ❯ unzip gradle-9.0.0-bin.zip -d /usr/local/gradle ❯ ls /usr/local/gradle/gradle-9.0.0 LICENSE NOTICE README bin init.d lib
步骤 3 - 配置您的系统环境
要安装 Gradle，解压后的文件路径需要添加到您的 Path 中。配置您的 PATH 环境变量以包含解压后的分发版的 bin 目录，例如：
❯ export PATH=$PATH:/usr/local/gradle/gradle-9.0.0/bin
另外，您也可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。然后，您可以将 $GRADLE_HOME/bin 添加到您的 PATH 中，而不是将特定版本的 Gradle 添加到您的 PATH 中。当升级到不同版本的 Gradle 时，只需更改 GRADLE_HOME 环境变量即可。
建议编辑主目录中的 .bash_profile 文件，以添加 GRADLE_HOME 变量。
export GRADLE_HOME=/usr/local/gradle/gradle-9.0.0 export PATH=$GRADLE_HOME/bin:$PATH
Windows 安装
手动安装
步骤 1 - 下载最新的 Gradle 发布版
分发 ZIP 文件有两种形式
-
仅二进制 (bin)
-
完整版 (all)，包含文档和源码
我们建议下载 bin 文件。
步骤 2 - 解压分发版
使用 文件资源管理器 创建一个新目录 C:\Gradle。
打开第二个 文件资源管理器 窗口，进入 Gradle 分发版下载的目录。双击 ZIP 压缩包以显示内容。将内容文件夹 gradle-9.0.0 拖到您新创建的 C:\Gradle 文件夹中。
或者，您可以使用您选择的压缩工具将 Gradle 分发 ZIP 文件解压到 C:\Gradle 中。
步骤 3 - 配置您的系统环境
要安装 Gradle，解压后的文件路径需要添加到您的 Path 中。
在文件资源管理器中右键单击此电脑（或计算机）图标，然后单击属性 → 高级系统设置 → 环境变量。
在系统变量下选择Path，然后点击编辑。添加一个条目 C:\Gradle\gradle-9.0.0\bin。点击确定保存。
或者，您可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。与其将特定版本的 Gradle 添加到您的 Path 中，不如将 %GRADLE_HOME%\bin 添加到您的 Path 中。当升级到不同版本的 Gradle 时，只需更改 GRADLE_HOME 环境变量。
验证安装
打开控制台（或 Windows 命令提示符）并运行 gradle -v 以运行 gradle 并显示版本，例如：
❯ gradle -v ------------------------------------------------------------ Gradle 9.0.0 ------------------------------------------------------------ Build time: 2025-05-13 06:56:13 UTC Revision: 3c890746756262d3778e12eaa5155d661d7cbdf2 Kotlin: 2.1.21 Groovy: 4.0.27 Ant: Apache Ant(TM) version 1.10.15 compiled on August 25 2024 Launcher JVM: 22.0.1 (Oracle Corporation 22.0.1+8-16) Daemon JVM: Compatible with Java 17, any vendor, nativeImageCapable=false (from gradle/gradle-daemon-jvm.properties) OS: Mac OS X 15.5 aarch64