《gradle 用户指南》中文版 第3章 安装 gradle

第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 install gradle

使用 scoop 安装

Scoop是由Homebrew启发的Windows命令行安装程序。

$ scoop install gradle

原文：https://docs.gradle.org/current/userguide/installation.html

上一页  |  目录  |  下一页