编写 Gradle 任务Task
前面几节课我们先介绍了 Gradle，然后学习了 Groovy 的基础语法，紧接着介绍了 Android 项目中 Gradle 的配置。我们从配置中可以看出 Gradle 的构建都是基于任务(Task) 的，有了前面几节的基础，今天这节课我们来学习一下，怎么样去定义一个 Gradle 的任务(Task) ，以及Task的生命周期。
1. 声明 Task
关于 Task 的声明，我们其实在第三节《构建自己的 Gradle 工程》这一节里面就有所介绍，我们创建 Gradle 项目时就声明了一个 Task 为 hello，下面我们声明一个名字为 mTask 的 Task。
task mTask{
doLast{
println "Hello，这是我声明的Task"
}
}
我们在控制台执行命令gradle mTask，我们会看到输出结果。
$ gradle mTask
Starting a Gradle Daemon (subsequent builds will be faster)
> Task :mTask
Hello，这是我声明的Task
BUILD SUCCESSFUL in 13s
1 actionable task: 1 executed
一般情况下，我们这样声明 Task，其实创建的都是org.gradle.api.DefaultTask的对象，它是org.gradle.api.Task的一个实现。DefaultTask的所有属性都是私有的，只能通过 get 和 set 方法获取。
Tips: 其实 Task 的声明除了上面方法外还有下面 2 种方法：
//Task的第二种声明方法
task (mTask){
doLast{
println "Hello，这是我声明的Task"
}
}
//Task的第三种声明方法
task ('mTask'){
doLast{
println "Hello，这是我声明的Task"
}
}
2. 给 Task 添加 Action
我们创建一个 Task 后可以根据我们的需要给 Task 添加不同的 Action，上面的“doLast”就是给队列尾增加一个Action。下面我们先来了解以下，关于 Task 添加 Action 的一些 API：
//在Action 队列头部添加Action
Task doFirst(Action<? super Task> action);
Task doFirst(Closure action);
//在Action 队列尾部添加Action
Task doLast(Action<? super Task> action);
Task doLast(Closure action);
//已经过时了，建议用 doLast 代替
Task leftShift(Closure action);
//删除所有的Action
Task deleteAllActions();
关于上面的 API，deleteAll 就是删除所有的 Action，这个我们不用太多讲解，而 leftShift 和 doLast 其实是一样的就是在队列的尾部增加一个 Action。这个 leftShift API 已经过时，我们建议使用 doLast 代替。关于 doFirst 和 doLast 我们下面通过一个例子来讲解：
//创建一个名字为apiTask的 task
task apiTask {
//创建一个 Action , 添加到 Action 列表的头部
doFirst(new Action<Task>() {
@Override
void execute(Task task) {
println "action1++++++++++"
}
})
//创建一个 Action , 添加到 Action 列表的头部
doFirst {
println "action2++++++++++"
}
//创建一个 Action , 添加到 Action 列表的尾部
doLast(new Action<Task>() {
@Override
void execute(Task task) {
println "action3++++++++++"
}
})
//创建一个 Action , 添加到 Action 列表的尾部
doLast {
println "action4++++++++++"
}
}
我们在上面的例子的 Task 队列中，先添加了 action1，然后再在头部添加了 action2，现在队列从头到尾应该是"action2=>action1"然后再在队尾增加 action3，action4，最终队列里面从头至尾依次为：“action2 => action1 => action3 => action4”。我们下面执行 apiTask 任务看看是不是输出这个顺序。
3. 定义 Task 的依赖
关于 Task，它也是可以进行依赖的，Task 声明依赖的关键字是dependsOn，它支持声明一个或多个依赖，下面我们看个例子：
task first {
doLast {
println "+++++first+++++"
}
}
task second {
doLast {
println "+++++second+++++"
}
}
//指定多个task依赖
task print(dependsOn :[second,first]) {
doLast {
logger.quiet "指定多个task依赖"
}
}
task third(dependsOn : print) {
doLast {
println '+++++third+++++'
}
}
// //还可以采用这样的方式
// task third {
// doLast {
// println "+++++third+++++"
// }
// }
// third.dependsOn('print')
我们分别执行gradle print 和 gradle third命令：
我们从上面的执行结果中可以看出，执行 Task 之前，会先执行它的依赖 Task。
4. Task 的执行顺序
我们通过前面dependsOn关键字的定义知道，如果一个 Task 定义了依赖，那么执行这个 Task 之前，它的依赖 Task 需要先执行。这也就是 Gradle 的一个比较优秀思想：声明在一个给定的 Task 执行之前什么 Task 该被执行，而没有定义如何去执行。 在 Gradle 中 Task 的执行顺序是由输入/输出规范自动确定的。既然这么做，肯定是有优点的，那么我们看下它的优点：
优点：
- 由于没有明确规定，如何去执行，而是规定什么先去执行，这就是支持 Task 并行。这样可以极大的节约构建的时间成本。
- 我们只需要关注依赖任务，不用去关注依赖链上的关系是否发生变化。
5. Gradle 构建的生命周期
前面我们说了 Task 的执行顺序，下面我们了解以下 Gradle 构建的生命周期。我们学习 Android 时候我们知道，一个应用(Application)、活动(Activity)、服务(Service)都是有生命周期。同样今天我们学习的 Gradle 的构建它也是有生命周期的。Gradle 构建的生命周期有三个阶段：初始阶段，配置阶段和运行阶段。
5.1 初始阶段
在这个阶段，Gradle 项目根据正在执行的项目，找出哪些项目依赖需要参与到构建中。在 Android 项目中就是根据setting.gradle中include信息，查看有模块项目参与到构建中。
Tips： 在这个构建阶段当前已有的构建脚本代码都不会被执行。
5.2 配置阶段
在这个阶段，Gradle 创建了一个模型来代表任务，并参与到项目构建中来。Android 项目中这个阶段就是执行build.gradle 脚本文件。
5.3 运行阶段
这个阶段，就是根据 Gradle 命令传递过来的 Task 的名称，执行相关的依赖任务。Task 的 Action 会在这个阶段执行。
下面分享一个小技巧。
Tips: 自定义 Task 的名字最好采用驼峰命名法
我们以我们上面的 apiTask 来定义：
//创建一个名字为apiTask的 task
task apiTask {
//创建一个 Action , 添加到 Action 列表的头部
doFirst(new Action<Task>() {
@Override
void execute(Task task) {
println "action1++++++++++"
}
})
//创建一个 Action , 添加到 Action 列表的头部
doFirst {
println "action2++++++++++"
}
//创建一个 Action , 添加到 Action 列表的尾部
doLast(new Action<Task>() {
@Override
void execute(Task task) {
println "action3++++++++++"
}
})
//创建一个 Action , 添加到 Action 列表的尾部
doLast {
println "action4++++++++++"
}
}
前面我们执行命令是：gradle apiTask,我们使用来驼峰命名法还可以使用gradle aT来执行。
这个我们其实日常开发中也遇到过，我们打包时执行的gradle aR 相当于gradlew assembleRelease。
6. 小结
这篇文章我们从 Task 的声明开始，介绍了如何声明 Task，再到给 Task 添加 Action，逐步深入，再介绍了 Task 的依赖，执行顺序，以及 Gradle 构建的生命周期。通过这一篇文章，大家应该对 Task 有了一定的认识和理解。这将为我们后面组件化和插件化打下基础。
- 还没有人评论，欢迎说说您的想法！
客服
