第四章 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,我们通过执行该任务可以看到我们的配置其了作用。

Map中可用的配置

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

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

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

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

过时了吧

4.5 任务的执行分析

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

接下来看实例

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

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,查看输出

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

4.7 任务的启用和禁用

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

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

4.8 任务的onlyIf断言

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

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

4.9 任务规则

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

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

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

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

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

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

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


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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • Gradle简介 Gradle是一个构建工具,同时它也是一个编程框架。 当你把Gradle当构建工具看的时候,我们...
    Rangethan阅读 2,301评论 1 8
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,392评论 25 707
  • 冉冉年华中很漠然, 勾心斗角有多寡淡, 面孔是越美轮美奂, 心里无法阻止不堪; 淡淡, 只想生活平淡, 漫漫, 我...
    兮稚阅读 156评论 0 0
  • 又名大三不务正业少女死宅寝室三天都看了什么 今天不想更逃避的自由了,我心浮气躁,在姨妈期间放飞自我,伺候自己简...
    三月日阅读 242评论 0 0