Gradle笔记——构建基础

学习Gradle前，需要有一个Groovy语言的基础，以免被Groovy的语法困扰，反而忽略了Gradle的知识。这里有一个Groovy的简明中文教程文档，可以快速学习Groovy的一些语法：http://download.csdn.net/detail/maosidiaoxian/8049823

1. Projects和tasks

先明确两个概念，projects和tasks，它们是Gradle中的两个重要概念。

任何一个Gradle构建，都是由一个或多个projects组成的。Project就是你想要用Gradle做什么，比如构建一个jar包，构建一个web应用。Project也不单指构建操作，部署你的应用或搭建一个环境，也可以是一个project。

一个project由多个task组成。每个task代表了构建过程当中的一个原子性操作，比如编译，打包，生成javadoc，发布等等这些操作。

2. 编写第一个构建脚本

新建一个文件build.gradle，然后添加以下代码：

<span style="font-family:Arial;font-size:14px;">task hello {    doLast {        println 'Hello, Gradle!'    }}</span><span style="font-family: 'microsoft yahei'; font-size: 15px;"></span>

这是本系列文章里的第一个构建脚本，它定义了一个叫hello的task，task的内容是在最后打印出“Hello, Gradle!”。

我们输入命令gradle hello来执行它：

<span style="font-family:Arial;">msdx@msdx-ubuntu:~/tmp$ gradle hello:helloHello, Gradle!BUILD SUCCESSFUL</span>

Gradle是领域驱动设计的构建工具，在它的实现当中，Project接口对应上面的project概念，Task接口对应上面的task概念，实际上除此之外还有一个重要的领域对象，即Action，对应的是task里面具体的某一个操作。一个project由多个task组成，一个task也是由多个action组成。

当执行gradle hello的时候，Gradle就会去调用这个hello task来执行给定操作(Action)。这个操作其实就是一个用Groovy代码写的闭包，代码中的task是Project类里的一个方法，通过调用这里的task方法创建了一个Task对象，并在对象的doLast方法中传入println 'Hello, Gradle!'这个闭包。这个闭包就是一个Action。

Task是Gradle里定义的一个接口，表示上述概念中的task。它定义了一系列的诸如doLast, doFirst等抽象方法，具体可以看gradle api里org.gradle.api.Task的文档。

在上面执行了gradle hello后，除了输出“Hello, Gradle!”之外，我们发现像“:hello”这样的其他内容。这其实是Gradle打印出来的日志，如果不想输出这些内容，可以在gradle后面加上参数 -q。即：gradle -q hello。

3. 快速定义任务

上面的代码，还有一种更简洁的写法，如下：

task hello << {    println 'Hello, Gradle!'}

执行这个脚本，打印出来的是一样的。也就是我们把像doLast这样的代码，直接简化为<<这个符号了。这其实是Gradle利用了Groovy的操作符重载的特性，把左位移操作符实现为将action加到task的最后，相当于调用doLast方法。看Gradle的api文档里对doLast()和leftShift()这两个方法的介绍，可知它们的作用是一样的，所以在这里，<<左移操作符即doLast的简写方式。

4. 代码即脚本

Gradle脚本是采用Groovy编写的，所以也像Groovy一样，以脚本方式来执行代码，如下面例子：

<span style="font-family:Arial;">task upper << {    String someString = 'mY_nAmE'    println "Original: " + someString     println "Upper case: " + someString.toUpperCase()}</span>
执行结果如下：

msdx@msdx-ubuntu:~/tmp$ gradle -q upperOriginal: mY_nAmEUpper case: MY_NAME
这也就是说，我们在写Gradle脚本的时候，可以像写Groovy代码一样。而Groovy是基于Java的，兼容Java语法，所以Java的朋友们，是不是忽然发现Gradle脚本很好上手了呢？
5. 任务依赖
可以通过以下方式创建依赖
<span style="font-family:Arial;">task hello << {    print 'Hello, '}task intro(dependsOn: hello) << {    println "Gradle!"}</span>

输出结果如下：
msdx@msdx-ubuntu:~/tmp$ gradle -q introHello, Gradle!

另外，被依赖的task不必放在前面声明，在后面也是可以的，这一点在后面将会用到。

6. 动态任务

借助于强大的Groovy，我们还可以动态地创建任务。如下代码：

<span style="font-family:Arial;">4.times { counter ->    task "task$counter" << {        println "I'm task number $counter"    }}</span>

我们定义了4个task，分别是task0, task1, task2, task3。我们来执行task1，如下：

msdx@msdx-ubuntu:~/tmp$ gradle -q task1I'm task number 1

7. 任务操纵

在Gradle当中，任务创建之后可以通过API进行访问，这是Gradle与Ant的不同之处。

4.times { counter ->    task "task$counter" << {        println "I'm task number $counter"    }}task1.dependsOn task0, task3
8. 短标记法
如果你对groovy有一定了解，那你也许会注意到，每个task都是一个构建脚本的属性，所以可以通过“$”这种短标记法来访问任务。如下：

task hello << {    println 'Hello, Gradle!'}hello.doLast {    println "Greetings from the $hello.name task."}

执行结果：

<span style="font-family:Arial;font-size:14px;">msdx@msdx-ubuntu:~/tmp$ gradle -q helloHello, Gradle!</span><span style="font-family: Arial; font-size: 15px;">Greetings from the hello task.</span>