摇篮安装

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

.   (1)
├── gradle
│   └── wrapper (2)
├── gradlew         (3)
├── gradlew.bat     (3)
└── ⋮
1 项目根目录。
2 Gradle 包装器
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 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

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)

  • 完整(全部)包含文档和来源

我们建议下载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安装

使用包管理器安装

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

❯ sdk install gradle

使用自制程序

❯ brew install gradle

使用MacPorts

❯ sudo port install gradle

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

手动安装

第 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) 图标,然后单击PropertiesAdvanced System SettingsEnvironmental 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 发行版的完整性。