第四章 Gradle任务

上一章我们已经介绍了Gradle脚本的基础,在其中我们也强调了Gradle中最要的Projects和Tasks这两个概念,尤其是Tasks,我们的所有Gradle的构建工作都是由Tasks组合完成的,那么这一章我们就详细的介绍下Tasks–任务。
任务的介绍也是从实用性出发,比如如何多种方式创建任务,如果访问任务的方法和属性等信息,如果对任务进行分组、排序,以及任务的一些规则性知识。

第一种是直接以一个任务名字创建任务的方式:

//1: 
def Task createTask1 = task(creatTask1)
//配置doLast方法
creatTask1.doLast{
    println "创建方法原型: Task task(String name)"    
}

第二种是以一个任务名字+一个对该任务配置的Map对象来创建任务:

//2: 任务名字 + 该任务配置的Map
def Task createTask2 = task(createTask2, group: BasePlugin.BUILD_GROUP)
createTask2.doLast{
    println "任务分组: ${createTask2.group}"    
}

和第一种方式大同小异,只是多了一个Map参数,用于对要创建的Task进行配置,比如我们例子里为其指定了分组为BUILD,我们通过执行该任务可以看到我们的配置其了作用。

《第四章 Gradle任务》 Map中可用的配置

第三种方式就是任务名字+闭包配置的方式:

《第四章 Gradle任务》

因为Map传参配置的方式(第二种)毕竟可配置的项有限,所以可以通过闭包的方式进行更多更灵活的配置,闭包里的委托对象就是Task,所以你可以使用Task对象的任何方法、属性等信息进行配置,比如示例中我们配置了任务的描述和任务执行后要做的事情。

Project中还有一种名字+Map参数+闭包的的方式,和上面演示的非常相似,就不列出了,下面我们说下TaskContainer创建任务的方式。如果我们去看Project对象中关于上面我们演示的task方法的源代码,就会发现其实他们最终都是调用TaskContainer对象中的create方法,其参数和Project中的task方法基本一样,我们下面看例子,我们使用这种方式重写第三种方式的例子:

《第四章 Gradle任务》

tasks是Project对象的属性,其类型是TaskContainer,我们可以使用它来直接创建任务。对于关于TaskContainer其他几种创建方式和前面演示的Project的task方法基本上一样,就不一一写示例了,大家可以参考上面的练习写一下。

4.2 多种方式访问任务

首先呢,我们创建的任务都会作为项目(Project)的一个属性,属性名就是任务名,所以我们可以直接通过该任务名访问和操纵该任务:

通过索引访问的时候,任务名就是我们Key(关键索引),其实这里说key不恰当,因为tasks并不是一个Map,这里再顺便扩展下Groovy的知识,[]在Groovy中是一个操作符,我们知道Groovy的操作符都有对应的方法让我们重载,a[b]对应的是a.getAt(b)这个方法.

//直接通过该任务名访问和操纵该任务
task creatTask1{
    doLast{
        println 'doLast'
    }
}

tasks['creatTask1'].doLast{ 
    //通过路径访问, find找不到会返回null, 而get找不到会抛异常
    println tasks.findByPath(':creatTask1')
    //通过名字访问,通过的名称的访问也有get和find两种,区别和路径访问方式一样。
    println tasks.findByName('creatTask1')
}

值得强调的时候,通过路径访问的时候,参数值可以是任务路径也可以是任务的名字,但是通过名字访问的时候,参数值只能是任务的名字,不能为路径。
通过以上几种方式我们发现访问Gradle的任务非常方便,当我们拿到这个任务的引用的时候,我们就可以按我们的业务逻辑去操纵它,比如配置任务依赖,配置任务的一些属性,调用方法呢,这是Ant做不到的,这也是Gradle的灵活之处。

4.3 任务分组和描述

任务是可以分组和添加描述的,任务的分组其实就是对任务的分类,便于我们对任务进行归类整理,清晰明了。任务的描述就是说明这个任务有什么作用,是这个任务的大概说明。

建议大家创建任务的时候,这两个都要进行配置,便于其他人在看到的时候能很快的了解你定义任务的分类和通途。

def Task myTask = task task1
myTask.description = '这是一个构建的引导任务'
myTask.group = BasePlugin.BUILD_GROUP
myTask.doLast{
    println "group: ${group}, desc: ${description}"
}

4.4 <<操作符

详细读者们已经看到了我们很多例子中使用了这个操作符,这一小节我们就从源代码的角度来讲解下这个操作符,让大家对它有个更深入的了解。
<<操作符在Gradle的Task上是doLast方法的短标记形式,也就是说<<可以代替doLast

《第四章 Gradle任务》

过时了吧

4.5 任务的执行分析

当我们执行一个Task的时候其实就是执行其拥有的Actions列表,这个列表保存在Task对象实例中的actions成员变量中,其类型是一个List。

《第四章 Gradle任务》

接下来看实例

Task task1 = task(task1, type: CustomTask)
task1.doFirst{
    println "doFirst"
}
task1.doLast{
    println "doLast"
}
task1.doFirst{
    println "new doFirst"
}

class CustomTask extends DefaultTask{
    @TaskAction
    def doSelf(){
        println 'doself'
    }
}

《第四章 Gradle任务》 Output

结果和我们期望的一样。我们前面讲了,执行Tasks的时候就是在遍历执行actions List,那么要达到这种doFirst、doSelf、doLast顺序的目的,就必须把doFirst的Actions放在actions List的最前面,把doSelf的Actions放在List中间,把doLast的Actions放在List最后面,这样才能达到按约定顺序执行的目的。

当我们使用task方法创建task1这个任务的时候,Gradle会解析其带有TaskAction标注的方法作为其Task执行的Action,然后通过Task的prependParallelSafeAction方法把该Action添加到actions List里:

《第四章 Gradle任务》
《第四章 Gradle任务》 doFirst和doLast这两个方法的实现代码

doFirst永远都是在actions List第一位添加,保证其添加的Action在现有actions List元素的最前面,doLast永远都是在actions List末尾添加,保证其添加的Action在现有actions List元素的最后面。一个往最前面添加,一个往最后面添加,最后这个actions List按顺序就形成了doFirst、doSelf、doLast三部分的Actions,就达到的doFirst、doSelf、doLast三部分的Actions顺序执行的目的。

这一小结是基于源代码对Task执行的分析,可能有点难,但是我还是建议大家仔细看,一遍看不懂多看几遍,结合着例子和源代码看,理解了对整个Task的执行就熟悉的多了。

4.6 任务排序

其实并没有真正的任务排序功能,这个排序不像我们想象的通过设置优先级或者Order顺序实现,而是通过任务的shouldRunAfter和mustRunAfter这两个方法来显示的,他们可以控制一个任务一定或者应该在某个任务之后执行,通过这种方式你可以在某些情况下控制任务的执行顺序,而不是通过强依赖的方式。

这个功能是非常有用的,比如我们公司自己设置的必须先执行单元测试,才能进行打包,这就保证了App的质量。类似情况还有很多,比如必须要单元测试之后才能进行集成测试;打包成功之后才能进行部署发布等。

taskB.shouldRunAfter(taskA) 表示taskB应该在taskA执行之后执行,这里的应该而不是必须,所以有可能任务顺序并不会按预设的执行。
taskB.mustRunAfter(taskA) 表示taskB必须在taskA执行之后执行,这个规则就比较严格。

task task1{
    doLast{
        println 'task1.doLast'
    }
}

task task2{
    doLast{
        println 'task2.doLast'
    }
}

task2.mustRunAfter(task1)

然后在此执行./gradlew task2 task1,查看输出

《第四章 Gradle任务》

这个排序目前还属于Beta版,以后的Gradle版本可能会有变动,但是如果正好项目中遇到了类似的情况,不妨试试,很有用。

4.7 任务的启用和禁用

Task中有个enabled属性,用于启用和禁用任务,默认是true表示启用的,设置为false则禁止该任务执行,输出会提示该任务被跳过.

《第四章 Gradle任务》

在某些情况下可以通过该属性灵活的控制任务的执行,这种方式需要在执行到具体逻辑的时候才能进行判断设置,下面我们讲一种提前设置条件的方式来控制任务执行还是跳过。

4.8 任务的onlyIf断言

断言就是一个条件表达式,Task有一个onlyIf方法,它接受一个闭包作为参数,如果该闭包返回true则该任务执行,否则则跳过。这有很多用途,比如控制哪些情况下打什么包,什么时候执行单元测试,什么情况下执行单元测试的时候不执行网络c而是等等,现在就以一个打首发包的例子来说明。

假如我们的首发渠道是应用宝和百度,直接执行build会编译出来所有包,这个太慢也不符合我们的需求,现在我们就采用onlyIf的方式通过属性来控制:

4.9 任务规则

我们通过以上章节知道了我们创建的任务都在TaskContainer里,是由其进行管理的。所以我们当我们访问任务的时候时候都是通过TaskContainer进行访问,而TaskContainer又是一个NamedDomainObjectCollection(继承它),所以我们说的任务规则其实是NamedDomainObjectCollection的规则。

NamedDomainObjectCollection是一个具有唯一不变名字的域对象的集合,它里面所有的元素都有一个唯一不变的名字,该名字是String类型,所以我们可以通过名字获取该元素,比如我们通过任务的名字获取该任务。

说完唯一不变的名字,我们再说规则,NamedDomainObjectCollection的规则有什么用呢?我们上面说了要想获取一个NamedDomainObjectCollection的元素是通过一个唯一的名字获取的,那么这个唯一的名字可能在NamedDomainObjectCollection中并不存在,具体到任务中就是说你想获取的这个任务不存在,这时候就会调用我们添加的规则来处理这种异常情况,我们看下源代码:

《第四章 Gradle任务》

以名字查找的时候,如果没有找到则调用applyRules(name)应用我们添加的规则。
我们可以通过调用addRule来添加我们自定义的规则,它有两个用法:

《第四章 Gradle任务》

一个是直接添加一个Rule,一个是通过闭包配置成一个Rule再添加,两种方式大同小异,如果仔细观察你会发现,Gradle中基本上都是这种写法,成对出现。

当我们执行、依赖一个不存在的任务时,Gradle会执行失败,失败信息是任务不存在,我们使用规则对其进行改进,当执行、依赖不存在的任务时,不会执行失败,而是打印提示信息提示该任务不存在:

《第四章 Gradle任务》

此外它还可以根据不同的规则动态创建需要的任务等情况。

本文属自学历程, 仅供参考
详情请支持原书 Android Gradle权威指南

    原文作者:leiTKai
    原文地址: https://www.jianshu.com/p/8c8940bff846
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞