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 会使用在你的 PATH 中找到的 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.14-bin.zip
❯ ls /opt/gradle/gradle-8.14
LICENSE  NOTICE  bin  README  init.d  lib  media

步骤 3 - 配置系统环境

要安装 Gradle,解压文件的路径需要添加到你的 Path 中。配置你的 PATH 环境变量以包含解压分发版的 bin 目录,例如

❯ export PATH=$PATH:/opt/gradle/gradle-8.14/bin

或者,你也可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。与其将特定版本的 Gradle 添加到 PATH 中,不如将 $GRADLE_HOME/bin 添加到你的 PATH 中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME 环境变量即可。

export GRADLE_HOME=/opt/gradle/gradle-8.14
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.14-bin.zip -d /usr/local/gradle
❯ ls /usr/local/gradle/gradle-8.14
LICENSE	NOTICE	README	bin	init.d	lib

步骤 3 - 配置系统环境

要安装 Gradle,解压文件的路径需要添加到你的 Path 中。配置你的 PATH 环境变量以包含解压分发版的 bin 目录,例如

❯ export PATH=$PATH:/usr/local/gradle/gradle-8.14/bin

或者,你也可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。与其将特定版本的 Gradle 添加到 PATH 中,不如将 $GRADLE_HOME/bin 添加到你的 PATH 中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME 环境变量即可。

最好编辑你的主目录下的 .bash_profile 文件来添加 GRADLE_HOME 变量

export GRADLE_HOME=/usr/local/gradle/gradle-8.14
export PATH=$GRADLE_HOME/bin:$PATH

Windows 安装

手动安装

步骤 1 - 下载最新的 Gradle 分发版

分发版 ZIP 文件有两种类型

  • 仅二进制 (bin)

  • 完整版 (all),包含文档和源码

我们推荐下载 bin 文件。

步骤 2 - 解压分发版

使用文件资源管理器创建一个新目录 C:\Gradle

打开第二个文件资源管理器窗口,前往下载 Gradle 分发版的目录。双击 ZIP 存档以显示内容。将内容文件夹 gradle-8.14 拖到新创建的 C:\Gradle 文件夹中。

或者,你可以使用你选择的解压缩工具将 Gradle 分发版 ZIP 解压到 C:\Gradle 中。

步骤 3 - 配置系统环境

要安装 Gradle,解压文件的路径需要添加到你的 Path 中。

文件资源管理器中,右键单击 此电脑(或 计算机)图标,然后单击 属性高级系统设置环境变量

系统变量 下选择 Path,然后单击 编辑。添加 C:\Gradle\gradle-8.14\bin 的条目。单击 确定 保存。

或者,你可以添加环境变量 GRADLE_HOME 并将其指向解压后的分发版。与其将特定版本的 Gradle 添加到 Path 中,不如将 %GRADLE_HOME%\bin 添加到你的 Path 中。当升级到不同版本的 Gradle 时,只需更改 GRADLE_HOME 环境变量即可。

验证安装

打开控制台(或 Windows 命令提示符)并运行 gradle -v 来运行 gradle 并显示版本,例如。

❯ gradle -v

------------------------------------------------------------
Gradle 8.14
------------------------------------------------------------

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 分发版的完整性。