Gradle 安装

如果您只想运行现有的 Gradle 项目,那么如果构建使用 Gradle Wrapper,则无需安装 Gradle。这可以通过项目根目录中是否存在 gradlewgradlew.bat 文件来识别

.   (1)
├── gradle
│   └── wrapper (2)
├── gradlew         (3)
├── gradlew.bat     (3)
└── ⋮
1 项目根目录。
2 Gradle Wrapper.
3 用于执行 Gradle 构建的脚本。

如果您的项目中已存在 gradlewgradlew.bat 文件,您无需安装 Gradle。但您需要确保您的系统 满足 Gradle 的先决条件

如果您想更新项目的 Gradle 版本,可以按照 升级 Gradle 部分 中的步骤进行操作。请使用 Gradle Wrapper 升级 Gradle。

Android Studio 自带可用的 Gradle 安装,因此仅在该 IDE 中工作时,您无需单独安装 Gradle

如果您不符合上述条件并决定在您的机器上安装 Gradle,请首先在终端中运行 gradle -v 检查是否已安装 Gradle。如果该命令未返回任何内容,则表示未安装 Gradle,您可以按照以下说明进行操作。

您可以在 Linux、macOS 或 Windows 上安装 Gradle 构建工具。安装可以手动完成,也可以使用包管理器(如 SDKMAN!Homebrew)完成。

您可以在 发布页面 上找到所有 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

Gradle 支持 KotlinGroovy 作为主要的构建语言。Gradle 自带 Kotlin 和 Groovy 库,因此无需安装它们。Gradle 会忽略现有的安装。

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 安装

使用包管理器安装

SDKMAN! 是一种在大多数类 Unix 系统(macOS、Linux、Cygwin、Solaris 和 FreeBSD)上管理多个软件开发工具包并行版本的工具。Gradle 由 SDKMAN! 部署和维护!

❯ sdk install gradle

使用 Homebrew

❯ brew install gradle

使用 MacPorts

❯ sudo port install gradle

还有其他包管理器可用,但它们分发的 Gradle 版本不受 Gradle, Inc. 控制。

手动安装

步骤 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

您可以通过下载 SHA-256 文件(可从 发布页面 获取)并按照这些 验证说明 来验证 Gradle 发行版的完整性。