写在前面的话：
博主最近在学习Android Studio相关的东西。Gradle相对于我这个从Eclipse转过来的Android开发者，也算是一个全新的事物。但它却承担着Android构建系统中相当重要的一环。本着与人方便，自己方便的精神，觉得有必要翻译一下《Gradle User Guide》中的Tutorials相关部分。由于英语水平相当有限，请大家多多指教。

文章地址：http://blog.csdn.net/mikulee/article/details/45478177
英文原文地址：http://gradle.org/docs/current/userguide/tutorial_using_tasks.html
请尊重相关知识版权，谢谢。

第六章. 构建脚本基础

6.1. Projects and tasks(工程和任务)

Gradle中的所有东西都以这两个概念为基础：projects 和 tasks.

每个Gradle构建都以一个或多个projects组合而成。一个project代表的意义依赖于你正在用Gradle处理什么。例如，一个project可能代表一个库（JAR）或网页应用（web application）.它可能代表其他项目的库的ZIP压缩包发布版。一个project并不需要代表要构建的什么确切东西，它可能仅仅用来说明某个东西已经完成了，例如发布你的应用到工作或者生产环节去。如果你对这些概念性的东西还不够清楚，请不要紧张。Gradle的构建规则支持添加一个或多个project到底是什么的具体定义。

每个project都是有一个或多个tasks组成。一个task代表一个不可分割的构建工作。它可能编译一些calsses，创建JAR，生成Javadoc，或者发布一些文件到仓库里。

从现在开始，我们将把注意力集中在为一个project构建定义一些简单的tasks.后面的章节会深入学习处理多个projects的projects和tasks。

6.2. Hello world

当你用gradle命令运行一个Gradle构建的时候，gradle命令会在当前目录查找一个命名为build.gradle的文件。我们称呼build.gradle文件为构建脚本（build script），虽然严格来说，它是一个构建配置脚本。这个构建脚本定义了一个project及一些和它相关的的tasks.

为了验证这个，创建一个build.gradle文件，并添加下面的构建脚本。

例子 6.1. 你的第一个构建脚本
build.gradle

task hello {doLast {println 'Hello world!'}
}

在命令行shell中，进入到包含这个build.gradle的目录，运行gradle -q hello去执行这个构建脚本。

例子 6.2. 运行一个构建脚本
gradle -q hello的输出

> gradle -q hello
Hello world!

这里发生了什么？这个构建脚本定义了一个单独的命名为hello的任务，并添加了一个动作进去。当你运行gradle hello的时候，Gradle执行了这个hello任务，继而执行了你提供的动作。这个动作是一个包含一些执行Groovy代码的闭包。

如果你觉得这个看起来像Ant target，你是对的。Gradle task任务和Ant target是差不多的，但你会看到，它们（Gradle）更强大.我们使用了一个和Ant不一样的专业术语,因为我们觉得task这个词比target更加传神。不幸的是，这是一个和ant冲突的术语，例如Ant中调用自己的命令，例如javac或copy,tasks。所以当我们提到tasks时，我们要说的是Gradle tasks.如果我们要说 Ant tasks（Ant 命令）时，我们会明确的说 Ant task。

6.3. A shortcut task definition（定义任务的快捷方式）

这里有一个快速定义一个task的方法,非常简洁，例如要定义上面提到的hell task。
例子6.3.一个task定义快捷方式
build.gradle

task hell << {println 'Hello world!'
}

同样，我们定义了一个名称为hello的可执行任务，其中包含了一个单独的闭包。我们将会在整个用户指南中使用这种风格的task定义方式。

6.4. Build scripts are code（构建脚本是代码）

Gradle构建脚本给予你一个全功能的Groovy。作为引子，请看下面这2个示例：
例子6.4. 在Gradle任务中使用Groovy
build.gradle

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

gradle -q upper 输出：

> gradle -q upper
Original: mY_nAmE
Upper case: MY_NAME

或

例子6.5. 在Gradle任务中使用Groovy
build.gradle

task count << {4.times { print "$it " }
}

gradle -q count 输出：

> gradle -q count
0 1 2 3

6.5. Task dependencies（任务依赖）

你很可能已经想到，你可以声明一些可以依赖于其他任务的任务。
例子6.6. 声明一个依赖于其他task的task
build.gradle

task hello << {println 'Hello world!'
}
task intro(dependsOn: hello) << {println "I'm Gradle"
}

gradle -q intro 输出：

> gradle -q intro
Hello world!
I'm Gradle

可以添加一个还没存在的task作为依赖：
例子6.7. 懒依赖-另外的task还没存在
build.gradle

task taskX(dependsOn: 'taskY') << {println 'taskX'
}
task taskY << {println 'taskY'
}

gradle -q taskX 输出：

> gradle -q taskX
taskY
taskX

taskX对应taskY的依赖关系先于taskY的定义。这对应多重项目构建非常重要。更多任务依赖的讨论可以参考为一个task添加多个依赖。
请注意，当你要关联一个未存在的task时，不可以使用快捷标记。（参看6.8小节）

6.6. Dynamic tasks（动态任务）

Groovy的能力远远大于定义一个单独的task.例如，你可以使用它来动态创建task。
例子6.8. 动态创建task
build.gradle

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

gradle -q task1 输出：

> gradle -q task1
I'm task number 1

6.7. Mainipulating existing tasks （操作调整已经存在任务）

一旦任务被创建，任务就可以被API访问到。例如，你可以使用这个在运行时去动态给一个任务添加依赖。Ant是不允许这种行为的。
例子6.9. 通过API访问一个任务-添加一个依赖
build.gradle

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

gradle -q task0 输出：

> gradle -q task0
I'm task number 2
I'm task number 3
I'm task number 0

或者你可以为当前已经存在的任务添加其他行为。
例子6.10. 通过API访问一个任务-添加行为
build.gradle

task hello << {println 'Hello Earth'
}
hello.doFirst {println 'Hello Venus'
}
hello.doLast {println 'Hello Mars'
}
hello << {println 'Hello Jupiter'
}

gradle -q task0 输出：

> gradle -q hello
Hello Venus
Hello Earth
Hello Mars
Hello Jupiter

对doFirst和doLast的调用可以执行多次。他们添加一个动作到任务动作列表的开始或结束位置。当任务被执行时，在动作动作列表中的动作会被按顺序的执行。操作符<<是doLast的同名词。

6.8. Shortcut notations（快捷标记符）

在上一个例子中，你可能早已注意到有一个方便的标记符号去访问一个已经存在的task。作为构建脚本的一个属性，在每个task中都可以使用这种快捷方式。
例子6.11. 用构建脚本属性的方式访问task
build.gradle

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

gradle -q hello 输出：

> gradle -q hello
Hello world!
Greetings from the hello task.

这功能使构建脚本代码可读性更加强，特别是当使用插件提供的任务时，就像一个编译任务。

6.9. Extra task properties（扩展任务属性）

你可以向任务添加自定义属性。添加一个名称为myProperty的属性，并设置 ext.myProperty一个初始值。从此以后，这个属性就可以像预先定义的task属性一样被读取。
例子6.12. 向任务添加一个扩展属性
build.gradle

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

gradle -q printTaskProperties 输出：

> gradle -q printTaskProperties
myValue

扩展属性并不仅限于task.你可以获取更多扩展属性的相关内容，请参考扩展属性。

6.10. Using Ant Tasks（使用Ant任务）

Ant tasks在Gradle中是非常优秀的。Gradle中可以非常简单的使用Groovy来为Ant task提供非常优秀集成。Groovy封装了抽象的AntBuilder。在Gradle中使用Ant task相当方便，而且比在build.xml中使用Ant tasks更加强大有力。例如下面的示例，你可以学到怎么执行Ant tasks和怎么访问Ant属性。
例子6.13. 使用AntBuilder去执行ant.loadfile target
build.gradle

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

gradle -q loadfile 输出：

> gradle -q loadfile*** agile.manifesto.txt ***
Individuals and interactions over processes and tools
Working software over comprehensive documentation
Customer collaboration  over contract negotiation
Responding to change over following a plan*** gradle.manifesto.txt ***
Make the impossible possible, make the possible easy and make the easy elegant.
(inspired by Moshe Feldenkrais)

你可以在你的构建脚本中使用Ant去做更多事情。你可以参考在Gradle中使用Ant。

6.11. Using methods（使用方法）

Gradle为你如何组织你的构建逻辑划分等级。组织构建逻辑的第一级便是上面的例子，提前一个方法。
例子6.14. 使用方法去组织你的构建逻辑
build.gradle

task checksum << {fileList('../antLoadfileResources').each {File file ->ant.checksum(file: file, property: "cs_$file.name")println "$file.name Checksum: ${ant.properties["cs_$file.name"]}"}
}task loadfile << {fileList('../antLoadfileResources').each {File file ->ant.loadfile(srcFile: file, property: file.name)println "I'm fond of $file.name"}
}File[] fileList(String dir) {file(dir).listFiles({file -> file.isFile() } as FileFilter).sort()
}

gradle -q loadfile 输出：

> gradle -q loadfile
I'm fond of agile.manifesto.txt
I'm fond of gradle.manifesto.txt

迟点你将会看到在多重项目构建方面，子项目之间可以有很多共享的方法。如果你的构建逻辑变得更加复杂，Gradle可以提供给你其他非常方便的方法去组织构建逻辑。我们已经准备了整整一个章节去讨论它。可以参看组织构建逻辑。

6.12. Default tasks（默认任务）

Gradle允许你为你的构建定义一个或多个默认tasks。
例子6.15. 定义默认任务
build.gradle

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

gradle -q 输出：

> gradle -q
Default Cleaning!
Default Running!

这个等价于去允许gradle clean run。在多重项目构建中，每个子项目可以有自己指定的默认tasks.如果一个子项目没有指定默认task,父项目的默认task会被使用（假如父项目存在默认task）。

6.13. Configure by DAG（有向无环图的配置）

就如我们迟点详细说明的（参考构建的生命周期），Gradle有一个配置阶段和一个执行阶段。配置阶段完成后，Gradle了解到所有将会被执行到的tasks.Gradle会给你提供一个钩子，让你可以使用到这些信息。一个用例是去检查release task是否在这些即将被执行的任务之中。根据这个，你可以给一些变量赋予不同的值。
在下面这个例子中，distribution和release这2个tasks会有不同的版本值。
例子6.16. 选择不同的task，输出不同的结果
build.gradle

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'}
}

gradle -q distribution 输出：

> gradle -q distribution
We build the zip with version=1.0-SNAPSHOT

gradle -q release 输出：

> gradle -q release
We build the zip with version=1.0
We release now

重要的事情是whenReady在release被执行前影响到了release task。即使release不是主task,也可以生效。

6.14. Where to next?（接下来怎么学习？）

在这个章节，我们简单的介绍了task。但对task的学习还没结束。如果你想更详细的学习task，请到这里学习：更多关于task的事情。

否则，继续第七章Java快速开始的教程和第八章依赖管理基础。

Gradle用户指南之初学者教程（三）相关推荐

Gradle用户指南（章9：Groovy快速入门）
Gradle用户指南(章9:Groovy快速入门) 你可以使用groovy插件来构建groovy项目.这个插件继承了java插件的功能,且扩展了groovy编译.你的项目可以包含groovy代码.ja ...
Gradle用户指南(1)-Gradle安装
前置条件 Gradle 需要 Java JDK 或者 JRE,版本是 6 及以上.Gradle 将会装载自己的 Groovy 库,因此,Groovy 不需要被安装.任何存在的 Groovy 安装都会被 ...
TINA超级好用的电路仿真软件中文版下载含用户指南入门使用教程
TINA-TI ™ - 免费的SPICE模拟仿真工具说明,我也不是想要积分,主要是我下载东西人家管我要积分,也就想着分享一些东西换些积分了.希望大家理解,天下苦秦久已. https://downlo ...
摘要-Amira用户指南
第1章介绍 Amira是一款3D数据可视化,分析和建模系统.它使您能够从各种应用领域可视化科学数据集,例如医学,生物学,生物化学,显微学,生物医学,生物工程.三维数据可以快速探索,分析,比较和量化. ...
Android官方技术文档翻译——Gradle 插件用户指南（5）
昨晚把第五章未译完的几句话攻克了.只是第六章没怎么译,明后天又是周末,假设周一前第六章翻译完的话,周一再发第六章. 本文译自Android官方技术文档<Gradle Plugin User Gu ...
Gradle 2.0 用户指南翻译——第五十六章. 多项目构建
本文禁止w3cschool转载! 翻译项目请关注Github上的地址:https://github.com/msdx/gradledoc . 本文翻译所在分支:https://github.com/m ...
Gradle 1.12用户指南翻译——第五十六章. 多项目构建
其他章节的翻译请参见: http://blog.csdn.net/column/details/gradle-translation.html 翻译项目请关注Github上的地址: https://g ...
gradle插件用户指南(翻译)
gradle插件用户指南(翻译) http://www.open-open.com/lib/view/open1428320744713.html gradle属性文件详解(英文): https:// ...
FastAPI 教程翻译 - 用户指南 26 - 安全性
FastAPI 教程翻译 - 用户指南 26 - 安全性 FastAPI Tutorial - User Guide - Secuity Security Intro 安全性简介 There are ...

Gradle用户指南之初学者教程（三）