摇篮安装
如果您只想运行现有的 Gradle 项目,并且构建使用Gradle Wrapper ,则无需安装 Gradle 。这可以通过项目根目录中是否存在gradlew
或文件来识别:gradlew.bat
. (1) ├── gradle │ └── wrapper (2) ├── gradlew (3) ├── gradlew.bat (3) └── ⋮
1 | 项目根目录。 |
2 | Gradle 包装器。 |
3 | 用于执行 Gradle 构建的脚本。 |
如果gradlew
或gradlew.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
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安装
手动安装
第 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
) 图标,然后单击Properties
→ Advanced System Settings
→ Environmental 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 -v
gradle 并显示版本,例如:
❯ 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 发行版的完整性。