本篇文章主要介绍一下Gradle的构建基础。

它看起来似乎和android项目没多大关系。不能让人一下子理解android项目中的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，然后加入下面代码：

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

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

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

msdx@msdx-ubuntu:~/tmp$ gradle hello:helloHello, Gradle!BUILD SUCCESSFUL

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一样，以脚本方式来运行代码，如以下样例：

task upper << {    String someString = 'mY_nAmE'    println "Original: " + someString     println "Upper case: " + someString.toUpperCase()}

运行结果例如以下。它将定义的字符串转为大写：

msdx@msdx-ubuntu:~/tmp$ gradle -q upperOriginal: mY_nAmEUpper case: MY_NAME

这也就是说，我们在写Gradle脚本的时候。能够像写Groovy代码一样。而Groovy是基于Java的。兼容Java语法，所以Java的朋友们。是不是忽然发现Gradle脚本非常好上手了呢？

5 任务依赖

我们能够通过下面方式创建依赖：

task hello << {    print 'Hello, '}task intro(dependsOn: hello) << {    println "Gradle!"}

定义一个任务hello，输出“Hello, ”，然后定义一个任务intro，并依赖hello，输出“Gradle!”。结果是打印出“Hello, Gradle!”，例如以下：

msdx@msdx-ubuntu:~/tmp$ gradle -q introHello, Gradle!

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

6 动态任务

借助于强大的Groovy。我们还能够动态地创建任务。

例如以下代码：

4.times { counter ->    task "task$counter" << {        println "I'm task number $counter"    }}

我们定义了4个task，各自是task0, task1, task2, task3。我们来运行task1。例如以下：

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

另外。gradle tasks命令能够查看我们定义的task。从这里我们也能够看到定义的task，例如以下：

...Other tasks-----------task0task1task2task3...

注意，假设任务还没有定义，不能使用短标记法（见本篇兴许内容）来执行任务。

7 任务操纵

在Gradle其中。任务创建之后能够通过API进行訪问，这是Gradle与Ant的不同之处。

7.1 添加依赖

还是以上面的样例。可是我们加入一行代码。例如以下：

4.times { counter ->    task "task$counter" << {        println "I'm task number $counter"    }}task1.dependsOn task0, task3

然后还是运行 gradle -q task1。看看结果：

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

它先运行了task0和task3，由于task1依赖于这两个。

7.2 添加任务行为

例如以下代码：

task hello << {    println 'Hello, Gradle!'}hello.doFirst {    println 'I am first.'}hello.doLast {    println 'I am last.'}hello << {    println 'I am the the last'}

运行后的输出：

msdx@msdx-ubuntu:~/tmp$ gradle -q helloI am first.Hello, Gradle!I am last.I am the the last

8 短标记法

假设你对groovy有一定了解，那你或许会注意到。每一个task都是一个构建脚本的属性，所以能够通过“$”这样的短标记法来訪问任务。例如以下：

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

运行结果：

msdx@msdx-ubuntu:~/tmp$ gradle -q helloHello, Gradle!Greetings from the hello task.

注意，通过这样的方法訪问的任务一定是要已经定义的。

9 添加自己定义属性

task myTask {    ext.myProperty = "myValue"}task printTaskProperties << {    println myTask.myProperty}

输出结果：

msdx@msdx-ubuntu:~/tmp$ gradle -q printTaskPropertiesmyValue

10. 调用Ant任务

比方利用AntBuilder运行ant.loadfiile。

task loadfile << {    def files = file('config').listFiles().sort()    files.each { File file ->        if (file.isFile()) {            ant.loadfile(srcFile: file, property: file.name)            println " *** $file.name ***"            println "${ant.properties[file.name]}"        }    }}

运行结果：

msdx@msdx-ubuntu:~/tmp$ gradle -q loadfile *** db.config ***db=mysqlusername=rootpassword=123456 *** user.config ***username=adminwriteable=true

11 方法抽取

在上面的脚本中，我们能够把部分代码抽取出来。例如以下：

task loadfile << {    fileList('config').each { File file ->        ant.loadfile(srcFile: file, property: file.name)        println " *** $file.name ***"        println "${ant.properties[file.name]}"    }}File[] fileList(String dir) {    file(dir).listFiles({file -> file.isFile() } as FileFilter).sort()}

运行结果一样。

12. 定义默认任务

defaultTasks 'clean', 'run'task clean << {    println 'Default Cleaning!'}task run << {    println 'Default Running!'}task other << {    println "I'm not a default task!"}

运行结果：

msdx@msdx-ubuntu:~/tmp$ gradle -q Default Cleaning!Default Running!

13 DAG配置

Gradle使用DAG（Directed acyclic graph。有向非循环图）来决定任务运行的顺序。

通过这一特性，我们能够实现依赖任务做不同输出。

例如以下代码：

task distribution << {    println "We build the zip with version=$version"}task release(dependsOn: 'distribution') << {    println 'We release now'}gradle.taskGraph.whenReady {taskGraph ->    if (taskGraph.hasTask(release)) {        version = '1.0'    } else {        version = '1.0-SNAPSHOT'    }}

运行结果例如以下：

msdx@msdx-ubuntu:~/tmp$ gradle -q distributionWe build the zip with version=1.0-SNAPSHOTmsdx@msdx-ubuntu:~/tmp$ gradle -q releaseWe build the zip with version=1.0We release nowmsdx@msdx-ubuntu

在上面的脚本代码中。whenReady会在release任务运行之前影响它。即使这个任务不是基本的任务（即不是通过命令行传入參数来调用）。

本文原创，參考自Gradle官方文档，可看作是阅读该文档的笔记。转载请注明本段内容及本文出处：http://blog.csdn.net/maosidiaoxian/article/details/40340571