Gradle的Project从本质上说只是含有多个Task的容器,一个Task与Ant的Target相似,表示一个逻辑上的执行单元。我们可以通过很多种方式定义Task,所有的Task都存放在Project的TaskContainer中。
上一篇: http://blog.csdn.net/y874961524/article/details/57417812
调用Project的task()方法创建Task
// 调用Project的task关键字创建 Task
// 这里的 << 表示追加的意思, 向hello1 task中追加执行过程
task hello1 << {
print 'Hello 1'
}
使用doLast实现追加的效果
// 使用doLast同样可以实现追加执行执行过程
task hello2 {
doLast {
println 'doLast in hello2'
}
}
执行结果
$~ gradle hello2
Parallel execution with configuration on demand is an incubating feature.
:hello2
doLast in hello2
BUILD SUCCESSFUL
Total time: 0.734 secs
使用doFirst实现在task执行之前追加代码
如果需要向Task的最前面加入执行过程,我们可以使用doFirst
task hello3 {
// 在Task执行之前添加代码
doFirst{
println "doFirst in hello3"
}
}
在上面的3个例子中,Gradle的DSL向我们展示了一种非常自然的风格来创建Task,而事实上这些都只是一种内部DSL,也即必须符合groovy的语法要求。
上面的task关键字实际上是一个方法调用,该方法属于Project。Project中存在多个重载的task()方法。和Ruby等动态语言一样,在调用groovy方法时,我们不用将参数放在括号里面。
以上我们自定义的3个Task都位于TaskContainer中,Project中的tasks属性即表示该TaskContainer。为此,我们可以新建一个Task来显示这些信息:
// 输出task信息
task showTask << {
// tasks 的 class类型
println tasks.class
// Project 中的 task个数
println tasks.size()
}
输出结果:
:showTask
class org.gradle.api.internal.tasks.DefaultTaskContainer_Decorated
4
上面的DefaultTaskContainer_Decorated表示tasks类型,而4表示该TaskContainer中包含有4个自定义的Task——包括showTasks本身。
通过TaskContainer的create()方法创建Task
在上文中我们讲到,通过task()方法创建的Task都被存放在了TaskContainer中,而Project又维护了一个TaskContainer类型的属性tasks,那么我们完全可以直接向TaskContainer里面添加Task。
通过TaskContainer的API文档可以发现,TaskContainer向我们提供了大量重载的create()方法用于添加Task。
// 通过TaskContainer 方式创建Task
tasks.create(name: 'hello4') << {
println 'hello4'
}
tasks 是Project中的一个TaskContainer对象。
声明Task之间的依赖关系
Task之间是可以存在依赖关系,比如TaskA依赖TaskB,那么在执行TaskA时,Gradle会先执行TaskB,再执行TaskA。我们可以在定义一个Task的同时声明它的依赖关系:
// 定义Task之间的依赖关系
// 使用dependsOn进行确定依赖关系,此时会先执行hello4 task ,再执行hello5 task
task hello5(dependsOn: hello4) << {
println 'Hello5'
}
执行结果
Parallel execution with configuration on demand is an incubating feature.
:hello4
hello4
:hello5
Hello5
BUILD SUCCESSFUL
我们也可以在定义Task之后再声明依赖
task hello6 << {
println 'hello6'
}
// 声明依赖
hello6.dependsOn hello5
配置Task
一个Task除了执行操作之外,还可以包含多个Property,其中有Gradle为每个Task默认定义的Property,比如description,logger等。
另外,每一个特定的Task类型还可以含有特定的Property,比如Copy的from和to等。
当然,我们还可以动态地向Task中加入额外的Property。在执行一个Task之前,我们通常都需要先设定Property的值,Gradle提供了多种方法设置Task的Property值。
// 配置Gradle task的 property
task hello7 << {
// 声明一个property, 并且赋值
description = "this is description"
println description
println 'hello7'
}
输出结果
:hello7
this is description
hello7
通过闭包的方式配置属性值
task hello8 << {
println description
}
// 通过闭包的方式进行配置
hello8{
description = "this is desc in hello8 task. "
}
需要注意的是,对hello8的description设置发生在创建该Task之后,在执行“gradle hello8”时,命令行依然可以打印出正确的“this is desc in hello8 task.”,这是因为Gradle在执行Task时分为两个阶段,首先是配置阶段,然后才是实际执行阶段。
所以在执行hello8之前,Gradle会扫描整个build.gradle文档,将hello8的description设置为“this is desc in hello8 task.”,然后执行hello8,此时hello8的description已经包含了设置后的值。
通过调用Task的configure()方法完成Property的设置
task hello9 <<{
println description
}
// 调用task的配置方法
hello9.configure{
description = "this is hello9"
}
实际上,通过闭包的方式配置Task在内部也是通过调用Task的configure()方法完成的。