Gradle任务
多种方式创建任务
1、直接以一个任务名字创建一个任务的方式:
def Task task1 = task(task1)
task1.doLast{
println 'task1'
}
这种方式的创建其实是调用Project对象中的task(String name)方法。该方法的完整定义:
Task task(String name) throws InvalidUserDataException
2、以一个任务名字+一个对该任务配置的Map对象来创建任务:
def Task task2 = task(task2,group:BasePlugin.BUILD_GROUP)
task2.doLast{
println 'task2'
}
Task参数Map可用配置
配置项 | 描述 | 默认值 |
---|---|---|
type | 基于一个存在的Task来创建,和我们类继承差不多 | DefaultTask |
overwrite | 是否替换存在的Task,这个和type配合起来用 | false |
dependsOn | 用于配置任务的依赖 | [] |
action | 添加到任务中的一个Action或者闭包 | null |
description | 用于配置任务的描述 | null |
group | 用于配置任务的分组 | null |
3、任务名字+闭包配置的方式:
task task3{
description 'task3'
doLast{
println 'task3'
println "任务描述:${description}"
}
}
Map配置的项有限,所以可以通过闭包的方式进行更加灵活的配置。闭包里的委托对象就是Task,所以你可以使用Task对象的任何方法,属性等信息。
TaskContainer创建任务的方式:
tasks.create("task4"){
description 'task4'
doLast{
println 'task4'
println "任务描述:${description}"
}
}
tasks是Project对象的属性,其类型是TaskContainer,可以用它来直接创建任务。
多种方式访问任务
创建的任务都会作为项目的一个属性,属性名就是任务名,所以可以直接通过任务名称来访问和操作任务:
task task5
task5.doLast{
println 'task5:doLast'
}
任务都是通过TaskContainer创建的,其实TaskContainer就是我们创建的集合。在Project中可以通过tasks属性访问TaskContainer,所以可以通过访问集合的方式来访问创建的任务:
task task6
tasks['task6'].doLast{
println 'task6:doLast'
}
通过路径来访问。访问方式有两种,一种是get,一种是find,区别在于get如果找不到任务会抛出UnKnownTaskException异常,而find在找不到任务时返回null。
task task7
tasks['task7'].doLast{
println tasks.findByPath(':Chapter4:task7')
println tasks.getByPath(':Chapter4:task7')
println tasks.findByPath('abc')
}
通过名称访问。方式也有两种:get和find,区别和路径方式相同:
task task8
tasks['task8'].doLast{
println tasks.findByName('task8')
println tasks.findByName('task8')
println tasks.findByName('abc')
}
通过路径访问的时候,参数值可以是任务路径,也可以是任务名字。而通过名称访问,参数只能是任务名称,不能是路径。
任务分组和描述
任务是可以分组和添加描述的。任务分组其实就是对任务分类,便于对任务归类整理。任务的描述就是说明任务有什么用,是任务的大概说明。
task task9{
group BasePlugin.BUILD_GROUP
description '构建任务'
doLast{
println 'task9:doLast'
}
}
<<操作符
在Gradle 5.1后已经废弃。
任务的执行分析
当我们执行一个任务的时候,其实就是执行其拥有的actions列表。这个列表保存在Task的对象实例中的actions成员变量中,其类型是List。
任务排序
通过任务的shouldRunAfter和mustRunAfter这两个方法,可以控制一个任务应该或者一定要在某个任务之后执行。
task task12{
doLast{
println 'task12'
}
}
task task13{
doLast{
println 'task13'
}
}
task12.mustRunAfter task13
任务的启用和禁用
Task中有个enabled属性,用于启用和禁用任务,默认为true,表示启用,设置为false,则禁止任务执行,输出会提示该任务被跳过。
task task14 {
doLast{
println 'task14'
}
}
task14.enabled = false
任务的onlyIf断言
Task有一个onlyIf方法,它接受一个闭包作为参数,如果该闭包返回true,则该任务执行,否则跳过。
以打渠道包为例。首发应用宝和百度,直接编译会打出所有包,执行时间长,不符合需求,可以采用onlyIf来控制:
final String BUILD_APP = "build_app"
final String BUILD_APPS_ALL = "all"
final String BUILD_APPS_SHOUFA = "shoufa"
final String BUILD_APPS_EXCLUDE_SHOUFA = "exclude_shoufa"
task(QQRelease).doLast{
println '打应用宝的包'
}
task(BaiduRelease).doLast{
println '打百度的包'
}
task(HuaWeiRelease).doLast{
println '打华为的包'
}
task(MIUIRelease).doLast{
println '打MIUI的包'
}
task build{
group BasePlugin.BUILD_GROUP
description "打渠道包"
}
build.dependsOn QQRelease,BaiduRelease,HuaWeiRelease,MIUIRelease
QQRelease.onlyIf{
def execute = false
if(project.hasProperty(BUILD_APP))
{
Object buildApp = project.property(BUILD_APP)
if(BUILD_APPS_SHOUFA.equals(buildApp)||BUILD_APPS_ALL.equals(buildApp))
{
execute = true
}
else{
execute = false
}
}
else{
execute = true
}
execute
}
BaiduRelease.onlyIf{
def execute = false
if(project.hasProperty(BUILD_APP))
{
Object buildApp = project.property(BUILD_APP)
if(BUILD_APPS_SHOUFA.equals(buildApp)||BUILD_APPS_ALL.equals(buildApp))
{
execute = true
}
else{
execute = false
}
}
else{
execute = true
}
execute
}
HuaWeiRelease.onlyIf{
def execute = false
if(project.hasProperty(BUILD_APP))
{
Object buildApp = project.property(BUILD_APP)
if(BUILD_APPS_EXCLUDE_SHOUFA.equals(buildApp)||BUILD_APPS_ALL.equals(buildApp))
{
execute = true
}
else{
execute = false
}
}
else{
execute = true
}
execute
}
MIUIRelease.onlyIf{
def execute = false
if(project.hasProperty(BUILD_APP))
{
Object buildApp = project.property(BUILD_APP)
if(BUILD_APPS_EXCLUDE_SHOUFA.equals(buildApp)||BUILD_APPS_ALL.equals(buildApp))
{
execute = true
}
else{
execute = false
}
}
else{
execute = true
}
execute
}
执行方式如下:
#打所有渠道包
gradle build
gradle -Pbuild_app=all build
#打首发包
gradle -Pbuild_app=shoufa build
#打非首发包
gradle -Pbuild_app=exclude_shoufa build
命令行中-P意思是为Project指定K-V格式的属性键值对,格式为-PK=V。
任务规则
tasks.addRule("对规则的描述"){
String taskName->
task(taskName) {
println "${taskName}任务不存在"
}
}
task task15{
dependsOn missTask
}