【Gradle】Gradle任务

个人博客:
http://www.milovetingting.cn

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
}