- Gradle 之Groovy基本语法（一）
- Gradle 之Groovy文件操作（二）
- Gradle 之详解Project（三）
- Gradle 之详解Task（四）
- Gradle 之初识插件（五）
- Gradle 之常用配置（六）
- Gradle 之扩展Extension类 （七）
一、前言
Gradle在初始化阶段会生成所有的Project对象，在配置阶段会构建Task有向无环图，最后的执行阶段会执行该Task和其相关的Task任务。
这一章主要说下，配置阶段之前的Task的构建和Task的执行（没有调用该Task也会让配置阶段执行代码执行）。
二、Task的定义
通过gradlew tasks可查看所有定义好的Task任务。
Task定义方式：
1、Task task(String name,Closure configureClosure)
如：
task helloTask {
println 'hello world'
}
等价于：
task (helloTask,{
println 'hello world'
})
上面的调用：gradlew helloTask；强调一点的是该helloTask的执行在配置阶段中。
2、TaskContainer getTasks() 通过容器
如：
this.getTasks().create(name:'helloTask') {
println 'hello world'
}
每个Project中会有个TaskContainer对象，该对象是为了管理该Project下的所有的Task。
无论通过第一个方式还是第二个方式都会有个XXXXX(Map<String, ?> options, Closure configureClosure)，第一个参数options是什么意思？
我们通过task(String name,Closure configureClosure)方式创建的时候，第一个String name实质也可以理解成map的方式，也就是说map可以保存很多的设置属性。而且这些设置属性都在Task的声明中。
public interface Task extends Comparable<Task>, ExtensionAware {
String TASK_NAME = "name";
String TASK_DESCRIPTION = "description";
String TASK_GROUP = "group";
String TASK_TYPE = "type";
String TASK_DEPENDS_ON = "dependsOn";
String TASK_OVERWRITE = "overwrite";
String TASK_ACTION = "action";
}
- name : Task名称
- description ： Task描述
- group ： Task属于哪个组
- type ： Task类型
- dependsOn ： Task依赖于其他的Task
- overwrite ：
- action：
Task中除了定义属性外，还有对该属性的操作方法，我们可以在创建Task的时候就对添加属性，也可以通过获取特定的属性通过setXXX方法设置。
二、Task的执行
前面也已经介绍了Task的执行方式是调用gradlew task名方式，上面的Task定义的是执行在配置阶段的，而且及时没有明确的被调用该Task中的代码还是会在配置阶段执行。
Task可以通过配置的方式，让其执行在配置阶段还是执行阶段。
1、doFirst{} ： 执行阶段
添加doFirst代码是执行阶段执行；不添加表示在配置阶段执行。
如：可以在Task中添加doFirst，也可以通过找到Task添加doFirst。
this.getTasks().create(name: 'helloTask',description: 'hahahha') {
doFirst {
def name = 'hello'
println name
}
}
helloTask.doFirst {
println it.description
}
2、doLast{} ： 执行阶段
在Task中通过添加doLast，可以让这部分代码执行在执行阶段
如：创建一个helloTask任务，通过执行该任务，他的打印结果为：“world”，因为配置阶段的先执行，最后再顺序执行执行阶段内容。
this.getTasks().create(name: 'helloTask',description: 'hahahha') {
def name = 'hello'
doLast {
println name
}
name = 'world'
}
3、<< ： 执行阶段
当Task中的代码都执行在执行阶段的时候，用<<来简写代替doLast
this.getTasks().create(name: 'helloTask',description: 'hahahha') << {
def name = 'hello'
println name
}
例子：计算执行执行阶段到执行阶段结束时间
this.afterEvaluate { Project project->
def startBuildTime,endBuildTime
def preBuildTask = project.tasks.getByName('preBuild')
def buildTask = project.tasks.getByName('build')
preBuildTask.doFirst {
startBuildTime = System.currentTimeMillis()
println "preBuildTask time is ${startBuildTime}"
}
buildTask.doLast {
endBuildTime = System.currentTimeMillis()
println "preBuildTask time is ${endBuildTime}"
println "执行时间为: ${endBuildTime-startBuildTime}"
}
}
二、Task的执行顺序
Task的执行顺序：
- 1、dependOn方式设置
- 2、输入输出方式
- 3、通过API指定顺序
1）、dependOn方式
如：
task taskZ << {
println 'taskZ'
}
task taskX(dependsOn: taskZ) << {
println 'taskX'
}
task taskY(dependsOn: [taskX,taskZ]) << {
println 'taskY'
}
定义了taskX、taskY和taskZ三个Task，并指定taskY依赖于taskX，而taskX依赖于taskZ；当执行taskY的时候他们的输出顺序如下：
taskZ
taskX
taskY
2）、输入输出方式
当一个参数作为TaskA的输出参数，却作为TaskB的输入参数。那么当执行TaskB的时候先要执行TaskA。即输出的Task先于输入的Task执行。
输入方式：
- TaskInputs property(String name, Object value);
- TaskInputs properties(Map<String, ?> properties);
通过输入一些键值对的方式，KEY为String类型，value为任意类型。
输出方式：
- TaskOutputFilePropertyBuilder dirs(Object... paths);
- TaskOutputFilePropertyBuilder file(Object path);
- TaskOutputFilePropertyBuilder dir(Object path);
3）、指定顺序方式mustRunAfter
如：
task taskX << {
doLast {
println 'taskX'
}
}
task taskY {
mustRunAfter(taskX)
doLast {
println 'taskY'
}
}
task taskZ << {
mustRunAfter(taskY)
doLast {
println 'taskZ'
}
}
三、Gradle生命周期内执行Task
怎么样通过代码调用Task
this.afterEvaluate {
def buildTask = it.tasks.findByName('build')
if (buildTask != null) {
buildTask.doLast {
taskZ.execute()
}
}
}
在buildTask执行中添加对taskZ的执行。
