Gradle技术之四 - Gradle的Task详解

794 阅读4分钟

1 Gradle的Task详解

  • 1 Task定义和配置
  • 2 Task的执行
  • 3 Task的依赖和执行顺序
  • 4 Task类型
  • 5 Task结合gradle的生命周期
  • 6 Task实战

1.1 Task定义和配置

1.1.1 查看所有的task

./gradlew tasks
输出
> Task :tasks 
------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------

Android tasks
-------------
androidDependencies - Displays the Android dependencies of the project.
signingReport - Displays the signing info for each variant.
sourceSets - Prints out all the source sets defined in this project.

Build tasks
-----------
assemble - Assembles all variants of all applications and secondary packages.

.....

1.1.1 新建一个task

可以使用project的task()方法创建一个task,也可以使用project的TaskContainer去创建task,这两种方法创建的task没有任何区别,TaskContainer就是方便project管理task用的,通过TaskContainer可以对project下的task进行管理,比如创建,查找task等


//第一种方法,直接使用project的task()方法创建
task helloTask{
    println 'this is helloTask'
}


//第二种方法,使用TaskContainer创建task
this.tasks.create(name:'helloTask2'){
    println 'this is helloTask2'
}

1.1.2 对task进行配置

有两种方法可以对task进行配置 1 创建的时候就对task进行配置 2 在闭包中对task进行配置

//第一种方法,直接使用project的task()方法创建
//第一种配置方法,创建的时候就配置task的group和description
//description就是个说明,类似对注释
task helloTask(group:'hard',description:'task learn'){
    println 'this is helloTask'
}


//第二种方法,使用TaskContainer创建task
this.tasks.create(name:'helloTask2'){
    //第二种配置方式:直接在闭包中配置
    setGroup('hard')
    setDescription('task learn')
    println 'this is helloTask2'
}

通过配置以后,就可以在右侧的面板中看到task了,如下图:

a83050120333.png

1.1.3 task的执行顺序

//第一种方法,直接使用project的task()方法创建
//配置的时候就配置task的group和description
//description就是个说明,类似对注释
task helloTask(group:'hard',description:'task learn'){

    //直接写在闭包里面的,是在配置阶段就执行的
    println 'this is helloTask'

    doFirst {
        println 'task in do first'  //运行任务时,会第一个执行
    }

    doLast {
        println 'task in do last'   //运行任务时,会最后一个执行
    }
}

doFirst和doLast中的代码,不执行这个任务时,是不会执行的,但是直接写在闭包中的,就也是在这两个函数外的代码,是在配置阶段就会执行的。运行任务时,doFirst中的代码最先执行,doLast中的代码最后执行

切记大部分的内容是写在 doLast{} 或 doFirst{} 闭包中,因为写在如果写在 task 闭包中的话,会在 Configuration 阶段也被执行。

1.1.4 计算build编译时间

def startBuildTime
def endBuildTime

//配置完后,所有的task的拓扑图都已经生成好了
//保证要找的task已经配置完毕
this.afterEvaluate { Project project ->
    
    //找到第一个执行的task
    def preBuildTask = project.tasks.getByName('preBuild')
    preBuildTask.doFirst {
        startBuildTime = System.currentTimeMillis()
        println 'the start time is:' + startBuildTime
    }

    //找到最后一个编译的build任务
    def buildTask = project.tasks.getByName('build')
    buildTask.doLast {
        endBuildTime = System.currentTimeMillis()
        println 'the build time is:' + (endBuildTime - startBuildTime)
    }
}

1.1.5 task依赖 task之间是有依赖关系的,比如taskA 依赖 taskB,那么在执行taskA的时候,Gradle会先执行taskB,再执行taskA,我们可以在定义一个task的时候,指定task的依赖关系:

task taskB {
    doLast {
        println '我是taskB'
    }
}

//定义一个taskA,且依赖于taskB
task taskA(dependsOn: taskB) {
    doLast {
        println '我是taskA'
    }
}

//运行
./gradlew taskA

输出
> Task :app:taskB 
我是taskB

> Task :app:taskA 
我是taskA

或者定义taskA,taskB之后,再定义依赖关系:

task taskB {
    doLast {
        println '我是taskB'
    }
}

//定义一个taskA
task taskA() {
    doLast {
        println '我是taskA'
    }
}

//定义之后,再依赖于taskB
taskA.dependsOn taskB

//运行
./gradlew taskA

输出
> Task :app:taskB 
我是taskB

> Task :app:taskA 
我是taskA

一个task也可以依赖多个task,依赖多个task的话,直接在denpendsOn后面跟一个task列表:

taskA.dependsOn 'taskB','taskC'
或者在定义的时候
task taskA(dependsOn:['taskB','taskC']) {
    doLast {
        println '我是taskA'
    }
}

执行taskA的时候,先执行taskB,taskC,但是taskB,taskC的执行顺序是随机的。

1.1.6 将自定义的task挂到构建过程中去 比如有这样一个需求,我们需要在build之后,就执行我们的task,应该怎么写呢? 这就是把我们自定义的task挂到build后,代码如下:

afterEvaluate{ project ->
    def buildTask = project.tasks.findByName('build')
    if(buildTask == null){
        throw new GradleException('the build task is not found')
    }

    //在buildTask后添加doLast,并在里面执行printTask
    //这样我们就把自定义的task挂到build构建过程中了
    buildTask.doLast {
        printTask.execute()
    }
}

SourceSets类的作用

SourceSets类的作用就是定义去哪找源文件,去哪找资源文件,库文件等,那么为什么我们平时不用定义也会知道去哪找这些东西呢?那是因为gradle有个约定的配置,如果没有指定,就会使用约定的。所以我们修改这些位置。如下:

  sourceSets {
        main {
            jniLibs.srcDirs = ['libs'] //修改so库存放的位置
        }
    }

    sourceSets {
        main {
            //修改资源文件的位置
            // res存放公共的资源,res-ad 存放广告资源,res-player存放播放器资源
            res.srcDirs = ['src/main/res', 'src/main/res-ad', 'src/main/res-player']
        }
    }