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) 版本 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)
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)
-
完整文件 (all),包含文档和源代码
我们建议下载 bin 文件;它是一个较小的文件,下载速度很快(并且最新的文档可在线获取)。
步骤 2 - 解压发行版
在您选择的目录中解压发行版 zip 文件,例如
❯ mkdir /opt/gradle ❯ unzip -d /opt/gradle gradle-8.13-bin.zip ❯ ls /opt/gradle/gradle-8.13 LICENSE NOTICE bin README init.d lib media
步骤 3 - 配置您的系统环境
要安装 Gradle,解压文件的路径需要位于您的 Path 中。配置您的 PATH
环境变量,使其包含解压发行版的 bin
目录,例如
❯ export PATH=$PATH:/opt/gradle/gradle-8.13/bin
或者,您也可以添加环境变量 GRADLE_HOME
并将其指向解压后的发行版。您可以将 $GRADLE_HOME/bin
添加到您的 PATH
中,而不是将特定版本的 Gradle 添加到您的 PATH
中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME
环境变量即可。
export GRADLE_HOME=/opt/gradle/gradle-8.13 export PATH=${GRADLE_HOME}/bin:${PATH}
macOS 安装
手动安装
步骤 1 - 下载 最新的 Gradle 发行版
发行版 ZIP 文件有两种类型
-
仅二进制文件 (bin)
-
完整文件 (all),包含文档和源代码
我们建议下载 bin 文件;它是一个较小的文件,下载速度很快(并且最新的文档可在线获取)。
步骤 2 - 解压发行版
在您选择的目录中解压发行版 zip 文件,例如
❯ mkdir /usr/local/gradle ❯ unzip gradle-8.13-bin.zip -d /usr/local/gradle ❯ ls /usr/local/gradle/gradle-8.13 LICENSE NOTICE README bin init.d lib
步骤 3 - 配置您的系统环境
要安装 Gradle,解压文件的路径需要位于您的 Path 中。配置您的 PATH
环境变量,使其包含解压发行版的 bin
目录,例如
❯ export PATH=$PATH:/usr/local/gradle/gradle-8.13/bin
或者,您也可以添加环境变量 GRADLE_HOME
并将其指向解压后的发行版。您可以将 $GRADLE_HOME/bin
添加到您的 PATH
中,而不是将特定版本的 Gradle 添加到您的 PATH
中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME
环境变量即可。
在您的主目录中编辑 .bash_profile
以添加 GRADLE_HOME
变量是一个好主意
export GRADLE_HOME=/usr/local/gradle/gradle-8.13 export PATH=$GRADLE_HOME/bin:$PATH
Windows 安装
手动安装
步骤 1 - 下载 最新的 Gradle 发行版
发行版 ZIP 文件有两种类型
-
仅二进制文件 (bin)
-
完整文件 (all),包含文档和源代码
我们建议下载 bin 文件。
步骤 2 - 解压发行版
使用文件资源管理器创建一个新目录 C:\Gradle
。
打开第二个文件资源管理器窗口,转到 Gradle 发行版下载的目录。双击 ZIP 存档以展开内容。将内容文件夹 gradle-8.13
拖到您新建的 C:\Gradle
文件夹中。
或者,您可以使用您选择的归档工具将 Gradle 发行版 ZIP 解压到 C:\Gradle
。
步骤 3 - 配置您的系统环境
要安装 Gradle,解压文件的路径需要位于您的 Path 中。
在文件资源管理器中,右键单击 此电脑
(或 计算机
)图标,然后单击 属性
→ 高级系统设置
→ 环境变量
。
在 系统变量
下,选择 Path
,然后单击 编辑
。为 C:\Gradle\gradle-8.13\bin
添加一个条目。单击 确定
保存。
或者,您可以添加环境变量 GRADLE_HOME
并将其指向解压后的发行版。您可以将 %GRADLE_HOME%\bin
添加到您的 Path
中,而不是将特定版本的 Gradle 添加到您的 Path
中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME
环境变量即可。
验证安装
打开控制台(或 Windows 命令提示符)并运行 gradle -v
以运行 gradle 并显示版本,例如
❯ gradle -v ------------------------------------------------------------ Gradle 8.13 ------------------------------------------------------------ Build time: 2024-06-17 18:10:00 UTC Revision: 6028379bb5a8512d0b2c1be6403543b79825ef08 Kotlin: 1.9.23 Groovy: 3.0.21 Ant: Apache Ant(TM) version 1.10.13 compiled on January 4 2023 Launcher JVM: 11.0.23 (Eclipse Adoptium 11.0.23+9) Daemon JVM: /Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home (no JDK specified, using current Java home) OS: Mac OS X 14.5 aarch64