笔记来源于以下文章
http://liuwangshu.cn/application/gradle/2-primer.html
这一篇文章我们接着来学习Gradle入门需要掌握的知识，包括配置环境、实现Hello World、Gradle的任务、Gradle日志和Gradle命令行，掌握这些能够更好的理解Gradle。
1. 配置Gradle环境
安装Gradle前要确保系统已经配置好JDK的环境，要求JDK的版本在1.7或更高。
Gradle的安装有两种形式：
- 通过包管理安装，比如Window平台的Chocolatey、Scoop，Mac平台的MacPortsl、Homebrew等等。
- 手动安装。
关于包管理器安装可以查看官方文档 ，这里主要介绍手动安装，在https://gradle.org/releases/ 中下载你想要Gradle版本的binary-only。
1.1 Windows平台安装
和配置Java环境类似，在系统变量中添加GRADLE_HOME：
然后再将%GRADLE_HOME%\bin添加到path系统变量中就可以了，运行gradle -v命令来进行验证。
1.2 Mac平台安装
步骤如下：
- 打开终端运行open -e .bash_profile，打开.bash_profile文件来配置环境变量。
- 在.bash_profile文件中将gradle路径添加到path环境变量中，比如我的就是：
export PATH=$PATH:~/develop/gradle-4.10.1/bin
保存.bash_profile文件，在终端中运行source ~/.bash_profile，更新.bash_profile文件。
在终端上运行gradle -v命令，查看是否配置成功。
2. 实现Hello World
配置完Gradle环境后，按照惯例要实现Gradle的Hello World，这里以Windows平台为例。
build.gradle为Gradle默认的构建脚本文件，运行Gradle 命令时，会从当前目录下寻找 build.gradle 文件来执行构建。
我们先新建一个目录，比如D:\Gradle\gradle_demo，在这个目录中新建一个 build.gradle 文件，输入以下内容：
task hello {
doLast {
println 'Hello world!'
}
}
然后在该文件所在目录下运行gradle -q hello构建脚本， 就会打印出“Hello world!”。
项目构建比较复杂，为了使用各种开发语言的开发者都能够快速的构建项目，专家们开发出了Gradle这个基于Groovy的DSL，DSL(Domain Specifc Language)意为领域特定语言，只用于某个特定的领域。我们只要按照Groovy的DSL语法来写，就可以轻松构建项目。
task（任务）和action(动作)是Gradle的重要元素。上面的代码中，task代表一个独立的原子性操作，比如复制一个文件，编译一次Java代码，这里我们简单的定义一个名为hello的任务。doLast 代表task执行的最后一个action，通俗来讲就是task执行完毕后会回调doLast中的代码，在上面这个例子中就会打印 ‘Hello world!’
上面的例子还可以写的更简洁一些，操作符<< 是doLast方法的快捷版本，它们做了相同的事情，如下所示。
task hello << {
println 'Hello world!'
}
3. Gradle的任务
为了更好的讲解后面的Gradle 命令行，这里简单的介绍下Gradle的任务，包括创建任务、任务依赖、 动态定义任务和任务的分组和描述。
3.1 创建任务
除了第2节实现Hello World的例子采用的创建任务方式，还有其他的3种创建任务方式。
- 直接用任务名称创建。
def Task hello=task(hello)
hello.doLast{
println "hello world"
}
- 任务名称+任务配置创建。
def Task hello=task(hello,group:BasePlugin.BUILD_GROUP)
hello.doLast{
println("hello world")
}
其中group为任务配置项，它代表了分组，关于分组会在3.4小节描述
- TaskContainer的create方法创建
tasks.create(name:"hello")<<{
//<<是doLast的快捷写法
println "hello world"
}
或者这样
tasks.create("demo4").doLast{
println "this is demo4"
}
此前创建任务的方式最终都会调用tasks的create方法，其中tasks类型为TaskContainer。
3.2 任务依赖
任务依赖会决定任务运行的先后顺序，被依赖的任务会在定义依赖的任务之前执行。创建任务间的依赖关系如下所示。
task hello << {
println "Hello World"
}
task go(dependsOn: hello) << {
println "go for it"
}
在hello任务的基础上增加了一个名为go的任务，通过dependsOn来指定依赖的任务为hello，因此go任务运行在hello之后。
在当前文件夹打开DOS，键入gradle -q go执行脚本，结果如下：
Hello World
go for it
3.3 动态定义任务
动态定义任务指的是在运行时来定义任务的名称，如下所示
3.times {number ->
task task$number << {
println "task $number"
}
}
关于tasks可以查询api
http://docs.groovy-lang.org/latest/html/groovy-jdk/java/lang/Number.html#times(groovy.lang.Closure)
这里用到了Groovy语法，times是Groovy在java.lang.Number拓展的方法，是一个定时器，3.times中循环创建了三个新任务，隐式变量number的值为0,1,2，任务的名称由task加上number的值组成，达到了动态定义任务的目的。
运行gradle -q task1构建脚本，打印结果如下
task 1
3.4 任务的分组和描述
Gradle有任务组的概念，可以为任务配置分组和描述，以便于更好的管理任务，拥有良好的可读性。改造3.2小节的例子，为hello任务添加分组和描述。
task hello {
group = 'build'
description = 'hello world'
doLast {
println "任务分组: ${group}"
println "任务描述: ${description}"
}
}
task go(dependsOn: hello) << {
println "go for it"
}
也可以采用3.1小节中其他的创建任务方式来为任务添加分组和描述，如下所示。
def Task hello=task(hello)
hello.description ='hello world'
hello.group=BasePlugin.BUILD_GROUP
hello.doLast{
println "任务分组: ${group}"
println "任务描述: ${description}"
}
task go(dependsOn: hello) << {
println "go for it"
}
执行结果如下：
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle -q go1
任务分组: build
任务描述: Hello World
go for it
4. Gradle日志级别
和Android一样，Gradle也定义了日志级别。
| 级别 | 用于 |
|---|---|
| ERROR | 错误消息 |
| QUITE | 重要的信息消息 |
| WARNING | 警告消息 |
| LIFECYCLE | 进度消息信息 |
| INFO | 信息性消息 |
| DEBUG | 调试消息 |
前面我们通过gradle -q +任务名称来运行一个指定的task，这个q是命令行开关选项，通过开关选项可以控制输出的日志级别。
| 开关选项 | 输出日志级别 |
|---|---|
| 无日志选项 | LIFECYCLE及更高级别 |
| -q 或 --quite | QUITE及更高级别 |
| -i 或 --info | INFO及更高级别 |
| -d 或 --debug | DEBUG及更高级别 |
5. Gradle命令行
从命令行的角度，Gradle和Git类似，命令都可以用一些IDE、图形工具来代替，但是如果你对Gradle 命令行熟悉，会帮助你更好的理解Gradle，高效的运用Gradle。
5.1 获取所有任务信息
这一节的命令行以3.4小节的代码为例，此前我们通过gradle -q +任务名称来运行一个指定的任务，如果不知道任务的名称，可以通过运行gradle -q tasks命令或者gradle tasks --all来获取所有的任务信息，这样就不需要打开源码了。
源码如下：
build.gradle
task demo1{
group="build"
description="Hello World"
doLast{
println "任务分组: ${group}"
println "任务描述: ${description}"
}
}
task go1(dependsOn: demo1) << {
println "go for it"
}
gradle -q tasks
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle -q tasks
------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------
Build tasks
-----------
demo1 - Hello World
Build Setup tasks
-----------------
init - Initializes a new Gradle build.
wrapper - Generates Gradle wrapper files.
Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'gradle_demo'.
components - Displays the components produced by root project 'gradle_demo'. [incubating]
dependencies - Displays all dependencies declared in root project 'gradle_demo'.
dependencyInsight - Displays the insight into a specific dependency in root project 'gradle_demo'.
dependentComponents - Displays the dependent components of components in root project 'gradle_demo'. [incubating]
help - Displays a help message.
model - Displays the configuration model of root project 'gradle_demo'. [incubating]
projects - Displays the sub-projects of root project 'gradle_demo'.
properties - Displays the properties of root project 'gradle_demo'.
tasks - Displays the tasks runnable from root project 'gradle_demo'.
To see all tasks and more detail, run gradle tasks --all
To see more detail about a task, run gradle help --task <task>
这种默认情况下，只会显示那些被分组的任务的名称和描述。比如Build tasks（Build 任务组）中有我们定义的demo1任务，Build Setup tasks中有init和wrapper，Help tasks有buildEnvironment 和components等等。
gradle tasks --all
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle tasks --all
> Configure project :
The Task.leftShift(Closure) method has been deprecated and is scheduled to be removed in Gradle 5.0. Please use Task.doLast(Action) instead.
at build_1oqisdjvwto6xm4npmzdamdyu.run(D:\DevelopSoftWare_Location\Gradle\gradle_demo\build.gradle:9)
(Run with --stacktrace to get the full stack trace of this deprecation warning.)
> Task :tasks
------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------
Build tasks
-----------
demo1 - Hello World
Build Setup tasks
-----------------
init - Initializes a new Gradle build.
wrapper - Generates Gradle wrapper files.
Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'gradle_demo'.
components - Displays the components produced by root project 'gradle_demo'. [incubating]
dependencies - Displays all dependencies declared in root project 'gradle_demo'.
dependencyInsight - Displays the insight into a specific dependency in root project 'gradle_demo'.
dependentComponents - Displays the dependent components of components in root project 'gradle_demo'. [incubating]
help - Displays a help message.
model - Displays the configuration model of root project 'gradle_demo'. [incubating]
projects - Displays the sub-projects of root project 'gradle_demo'.
properties - Displays the properties of root project 'gradle_demo'.
tasks - Displays the tasks runnable from root project 'gradle_demo'.
Other tasks
-----------
go1
BUILD SUCCESSFUL in 1s
1 actionable task: 1 executed
5.2 排除任务
如果我们不想运行go任务，可以运行gradle hello -x go命令:
以5.1小结的源码为例
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle -q go1 -x demo1
go for it
没有执行demo1任务
5.3 获取任务帮助信息
通过运行gradle -q help –task hello命令来显示hello任务的帮助信息。
以3.4小结的源码为例
Detailed task information for hello
Path
:hello
Type
Task (org.gradle.api.Task)
Description
hello world
Group
build
可以看到hello任务的路径、类型、描述和分组。
5.4 多任务调用
task helloWorld << {
println 'Hello world!'
}
task goForit<< {
println "go for it"
}
通过命令行一次执行多个任务，每个任务通常只会执行一次，无论是在命令行中指定任务还是任务依赖，上面的例子我们运行gradle helloWorld goForit，会先执行helloWorld任务后执行goForit任务。
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle -q helloWorld goForit
hello World
go for it
5.5 任务名称缩写
可以对使用驼峰命名的任务进行缩写，对于名称特别长的任务这个特性非常有用，比如5.4小节中的例子只需要执行gradle hW gF就可以了，不过需要注意一点，那就是任务名称的缩写必须是唯一的，如果5.4小节中第二个任务的名称为helloWangshu，那么就会报错。
PS D:\DevelopSoftWare_Location\Gradle\gradle_demo> gradle -q hW gF
hello World
go for it
