您可以在Linux,macOS或Windows上安装Gradle构建工具. 本文档涵盖使用软件包管理器(如SDKMAN)进行安装! 或Homebrew,以及手动安装.

建议使用Gradle包装器升级Gradle.

您可以在" 发行版"页面上找到所有发行版及其校验和.

Prerequisites

Gradle可在所有主要操作系统上运行,并且仅需要Java开发套件版本8或更高版本即可运行. 要检查,请运行java -version . 您应该会看到以下内容:

❯ java -version
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附带了自己的Groovy库,因此不需要安装Groovy. Gradle将忽略任何现有的Groovy安装.

Gradle使用在路径中找到的任何JDK. 另外,您可以将JAVA_HOME环境变量设置为指向所需JDK的安装目录.

Installing with a package manager

SDKMAN! 是用于在大多数类Unix系统(macOS,Linux,Cygwin,Solaris和FreeBSD)上管理多个软件开发套件的并行版本的工具. 我们部署并维护可从SDKMAN!获得的版本.

❯ sdk install gradle

Homebrew是" macOS缺少的软件包管理器".

❯ brew install gradle

可以使用其他软件包管理器,但是它们分发的Gradle版本不受Gradle,Inc.的控制.Linux软件包管理器可能会分发与正式版本(从SDKMAN!或更低版本提供)相比不兼容或不完整的Gradle修改版. ).

Installing manually

Step 1. Download the latest Gradle distribution

分发ZIP文件有两种形式:

  • 仅二进制(bin)

  • 完整(全部)包含文件和资料

需要使用旧版本吗? 请参阅发布页面 .

Step 2. Unpack the distribution

Linux & MacOS users

在您选择的目录中解压缩分发zip文件,例如:

❯ mkdir /opt/gradle
❯ unzip -d /opt/gradle gradle-6.0.1-bin.zip
❯ ls /opt/gradle/gradle-6.0.1
LICENSE  NOTICE  bin  getting-started.html  init.d  lib  media

Microsoft Windows users

使用File Explorer创建一个新目录C:\Gradle .

打开第二个" 文件资源管理器"窗口,然后转到下载Gradle发行版的目录. 双击ZIP存档以显示内容. 将内容文件夹gradle-6.0.1新创建的C:\Gradle文件夹中.

另外,您可以使用所选的存档器工具将Gradle发行版ZIP压缩为C:\Gradle .

Step 3. Configure your system environment

要运行Gradle,从Gradle网站到解压缩文件的路径必须在终端的路径上. 对于每个操作系统,执行此操作的步骤都不同.

Linux & MacOS users

配置PATH环境变量,使其包含解压缩发行版的bin目录,例如:

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

或者,您也可以添加环境变量GRADLE_HOME并将其指向解压缩的发行版. 可以将$GRADLE_HOME /bin添加到PATH ,而不是将特定版本的Gradle添加到PATH . 升级到其他版本的Gradle时,只需更改GRADLE_HOME环境变量即可.

Microsoft Windows users

在" 文件资源管理器"中,右键单击" This PC (或Computer )"图标,然后单击" Properties →" Advanced System Settings →" Environmental Variables .

在" System Variables选择" Path ,然后单击" Edit . 为C:\Gradle\gradle-6.0.1\bin添加一个条目. 单击确定保存.

或者,您也可以添加环境变量GRADLE_HOME并将其指向解压缩的发行版. 您可以将%GRADLE_HOME% /bin添加到您的Path ,而不是将特定版本的Gradle添加到您的Path . 升级到其他版本的Gradle时,只需更改GRADLE_HOME环境变量即可.

Verifying installation

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

❯ gradle -v

------------------------------------------------------------
Gradle 6.0.1
------------------------------------------------------------

(environment specific information)

如果遇到任何麻烦,请参阅" 排除安装故障 " 部分 .

您可以通过下载SHA-256文件(可从发行版中获得 )并按照以下验证指示信息来验证Gradle分发的完整性.

Next steps

现在您已经安装了Gradle,请使用以下资源进行入门: