第3章 安装 gradle

目录

3.1 先决条件3.2 下载3.3 解压3.4 环境变量3.5 运行和测试您的安装3.6 JVM选项3.7 安装（以上为手动安装方式，比较麻烦，可以使用 sdk，homebrew，Macports， scoop 等来安装 gradle）

3.1 先决条件

Gradle需要安装Java JDK或JRE，7或更高版本（以检查，使用java -version）。Gradle拥有自己的Groovy库，因此Groovy不需要安装。任何现有的Groovy安装都被Gradle忽略。Gradle使用您在路径中找到的任何JDK。或者，您可以将JAVA_HOME环境变量设置为指向所需JDK的安装目录。3.2 下载
您可以从Gradle网站下载一个Gradle发行版。
3.3 解压
Gradle发行版包装为ZIP，完整的分发包含：

• Gradle二进制可运行程序。
• 用户指南（HTML和PDF）。
• DSL参考指南。
• API文档（Javadoc）。
• 广泛的示例，包括用户指南中引用的示例，以及一些完整和更复杂的构建，您可以将其用作自己的构建的起点。
• 二进制源。这仅供参考。如果您要构建Gradle，则需要从源代码库下载源分发或从源库中检出源。有关详细信息，请参阅Gradle网站。

3.4 环境变量
对于运行Gradle，首先添加环境变量GRADLE_HOME。这应该指向Gradle网站上的解压缩文件。接下来，将GRADLE_HOME / bin添加到PATH环境变量中。通常，这足以运行Gradle。3.5 运行和测试您的安装
您通过gradle命令运行Gradle。要检查Gradle是否正确安装，只需输入gradle -v。输出显示了Gradle版本以及本地环境配置（Groovy，JVM版本，操作系统等）。显示的Gradle版本应该与您下载的分发版本相匹配。

gradle -v 命令输出：

$ gradle -v

------------------------------------------------------------
Gradle 4.0.2
------------------------------------------------------------

Build time:   2017-07-26 15:04:56 UTC
Revision:     108c593aa7b43852f39045337ee84ee1d87c87fd

Groovy:       2.4.11
Ant:          Apache Ant(TM) version 1.9.6 compiled on June 29 2015
JVM:          1.8.0_121 (Oracle Corporation 25.121-b13)
OS:           Mac OS X 10.12.3 x86_64

3.6 JVM选项
运行Gradle的JVM选项可以通过环境变量进行设置。您可以使用GRADLE_OPTS或JAVA_OPTS或两者。JAVA_OPTS是惯例，由许多Java应用程序共享的环境变量。典型的用例是将JAVA_OPTS中的HTTP代理和GRADLE_OPTS中的内存选项进行设置。这些变量也可以设置在毕业或毕业生脚本的开头。请注意，目前无法在命令行中为Gradle设置JVM选项。
3.7 安装（以上为手动安装方式，比较麻烦，可以使用 sdk，homebrew，Macports， scoop 等来安装 gradle）

这一部分是我自己添加的，主要内容为macOS 下安装 gradle，其实只要可以安装sdk的系统，使用sdk来安装，那么安装方式基本是一样的。

Gradle在所有主要操作系统上运行，只需要安装Java JDK或JRE版本7或更高版本。
要检查，运行java -version：

$ java -version
java version "1.8.0_121"
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)

可以使用 sdk，homebrew，Macports， scoop 等来安装 gradle。

使用 sdk 安装

SDKMAN 软件开发工具包管理器是用来在类Unix 系统中管理多个版本的开发环境的工具。提供命令行接口来安装、切换、删除、列出候选版本。

$ sdk install gradle

安装指定版本：

$ sdk install gradle 4.0.2

但是安装完成后执行“gradle”命令遇到错误：

$ gradle

FAILURE: Build failed with an exception.

* What went wrong:
Could not create service of type ScriptPluginFactory using BuildScopeServices.createScriptPluginFactory().
> Could not create service of type CrossBuildFileHashCache using BuildSessionScopeServices.createCrossBuildFileHashCache().

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

我这个错误是由于权限原因导致的，可以参考：

gradle Could not create service of type CrossBuildFileHashCache using BuildSessionScopeServices.crea

使用 homebrew 安装：

$ brew update && brew install gradle

使用 Macports 安装

$ sudo port selfupdate
$ sudo port