「Gradle」| 进阶篇(Project & Task & 构建生命周期)

点赞关注,不再迷路,你的支持对我意义重大!

Hi,我是丑丑。本文 「Android 路线」| 导读 —— 从零到无穷大 已收录,这里有 Android 进阶成长路线笔记 & 博客,欢迎跟着彭丑丑一起成长。(联系方式在 GitHub)


目录


1. 前置知识

在 Gradle 中,build.gradle 脚本文件中每个元素都会映射一个 Java 类。其中最重要的两个类是 「Project」&「Task」。在这篇文章里,我将带你分析 Gradle 中 Project 与 Task 的原理与使用,以及分析 Gradle 构建的生命周期

这篇文章的内容会涉及以下前置 / 相关知识,贴心的我都帮你准备好了,请享用~

  • Gradle 筑基: 「Gradle」| 筑基篇(概念 & Groovy & 配置 & 命令)

  • 官方文档:Project API 文档

  • 官方文档:Task API 文档


2. Project 项目

Project 代表一个构建组件,在「构建-初始化阶段」,Gradle 引擎会为每个 build.gradle 脚本文件实例化一个 Project 实例。 所以我们在 build.gradle 中编写的构建逻辑,本质上相当于编写在 Project 类内部。

org.gradle.api.Project.java

public interface Project extends Comparable, ExtensionAware, PluginAware {
}

Editting...


3. Task 任务

一个 Project 由一个或多个 Task 组成,Task 代表一个可执行的任务

org.gradle.api.Task.java

public interface Task extends Comparable, ExtensionAware
}

3.1 定义 Task

定义 Task 的语法主要有三种:

  • 使用 task 函数:
task('hello')
task('world') {
}
  • 使用 DSL 语言:
task(hello)
task(world) {
}
  • 使用 tasks container:
tasks.create('hello')
tasks.create('world') {
}

3.2 Task 属性

定义 Task 之后,就可以设置属性,设置属性的语法主要有两种:

  • 在创建 Task 时设置:
task hello(group : 'MyTask')
  • 调用 setter 设置:
task hello {
    setGroup('MyTask')
}

访问属性可以使用$符号或者 getter 方法,例如:

task hello(group : 'MyTask') {
    println "$group"
    println getGroup()
}

Task 中比较常用的属性有:

属性 描述
name Task 标识符,在定义 Task 时指定
group Task 所属的组
description Task 的描述信息
type Task类型,默认为 DefaultTask(见 第 3.7 节
actions 动作列表(见 第 3.3 节
dependsOn 依赖 Task 集合

Task 最重要的三个概念是「Task 动作」&「Task 依赖」&「Task 配置」:

3.3 Task 动作

动作(action)就是 Task 中的构建逻辑,这些构建逻辑在「构建-执行阶段」运行。Task 接口提供了两个方法来声明 Task 任务:

动作 描述
doFirst(Closure) 表示 Task 的第一个动作
doLast(Closure) 表示 Task 的最后一个动作

例如:

task helloworld {
    doFirst {
        println "hello"
    }
    doLast {
        println "world"
    }
}

除此之外,还可以在 Task 闭包外部添加动作:

task helloworld

helloworld.doFirst { println "hello" }
helloworld.doLast { println "world" }

3.4 Task 输入 / 输出

3.5 Task 依赖

Task 往往不是独立存在的,而是与其他 Task 存在依赖关系,使用 dependsOn 方法来声明依赖一个或多个 Task ,例如:

task first {
    doFirst { println "first" }
}
task second {
    doFirst { println "second" }
}
task third {
    doFirst { println "third" }
}
// 单依赖
third.dependsOn first
// 多依赖
third.dependsOn([first,second])

3.6 Task 配置

不在 Task 动作中定义的代码属于 Task 配置,两者完全不同:Task 配置运行在「构建-配置阶段」,Task 动作运行在「构建-执行阶段」,配置代码永远在动作代码之前执行。

3.7 自定义 Task

3.8 Task 类型


4. 理解 Gradle 构建生命周期

无论什么时候执行 Gradle 构建,都会先后执行三个生命周期阶段 ——「初始化」&「配置」&「执行」

4.1 初始化阶段(Initiliazation phase)

在初始化阶段,Gradle 会解析工程根目录下的setting.gradle文件,并构造一个 Settings 实例。Settings 是一个接口,主要包含以下方法:

org.gradle.api.initialization.Settings.Java

public interface Settings extends PluginAware, ExtensionAware {
    String DEFAULT_SETTINGS_FILE = "settings.gradle";

    void include(String... var1);
    void includeFlat(String... var1);
    File getSettingsDir();
    File getRootDir();
    Gradle getGradle();
    ...
}

其中的 include 方法你应该很熟悉了,include 方法指定了参与构建的项目(build.gradle)。在初始化阶段,Gradle 会为「包含」的每个的项目实例化一个 Project 实例。

setting.gradle

include ':app'

在 setting.gradle 里,你还可以做这些事:

  • include 指定目录下的项目

Gradle 默认会在工程根目录下寻找 include 包含的项目,那么如果你想包含其他目录下的项目,可以这样配置:

include ':app'
include 'video' 不要加 : 符号

project(:video).projectDir = new File("..\\libs\\video")
  • 监听生命周期

在 setting.gradle 里,可以对构建过程中的节点增加监听,监听器添加在Setting.getGradle() 实例上:

setting.gradle

include ':app'

gradle.addBuildListener(new BuildListener() {
    void buildStarted(Gradle var1) {
        println '【开始构建】'
    }
    void settingsEvaluated(Settings var1) {
        // 注意:在这里不能访问 var1.gradle.rootProject,因为 Project 还没有初始化
        println '【settings.gradle 解析完成】'
    }
    void projectsLoaded(Gradle var1) {
        println '【初始化阶段结束】'
    }
    void projectsEvaluated(Gradle var1) {
        println '【配置阶段结束】'
    }
    void buildFinished(BuildResult var1) {
        println '【构建过程结束】'
    }
})

构建过程输出(Build Output)如下:

Executing tasks: [:app:generateDebugSources] in project E:\workspace ...

【settings.gradle 解析完成】
【初始化阶段结束】

【这里是配置阶段】
【配置阶段结束】

> Task :app:preBuild UP-TO-DATE
> Task :app:preDebugBuild UP-TO-DATE
> Task :app:checkDebugManifest UP-TO-DATE
> ...
> Task :app:assembleDebug
【构建过程结束】

BUILD SUCCESSFUL in 14s
24 actionable tasks: 19 executed, 5 up-to-date

除了设置监听器方法,还可以直接设置闭包,例如:

gradle.projectsLoaded {
    println '【初始化阶段结束】'
}

4.2 配置阶段(Configration phase)

在配置阶段,Gradle 会解析每个项目中的 build.gradle 文件,完成「Project 配置」&「Task 配置」,并根据 Task 依赖关系来创建一个有向无环图。例如:

build.gradle

apply plugin: 'com.android.application'

println '配置 app project'

task hello {
    println '配置 hello task'
    doFirst{
        println 'hello 动作'
    }
}
...

构建过程输出(Build Output)如下:

Executing tasks: [:app:assembleDebug] in project E:\workspace\...

【settings.gradle 解析完成】
【初始化阶段结束】

> Configure project :app
配置 app project
配置 hello task
【配置阶段结束】

> Task :app:preBuild UP-TO-DATE
> Task :app:preDebugBuild UP-TO-DATE
> Task :app:checkDebugManifest UP-TO-DATE
> ...
> Task :app:assembleDebug
【构建过程结束 】

BUILD SUCCESSFUL in 14s
24 actionable tasks: 19 executed, 5 up-to-date

易混淆: Task 配置运行在「配置阶段」,Task 动作运行在「执行阶段」。

  • 监听 Task 有向无环图生成

setting.gradle

gradle.getTaskGraph().addTaskExecutionGraphListener(new TaskExecutionGraphListener() {
    @Override
    void graphPopulated(TaskExecutionGraph graph) {
        println '【Task 有向无环图生成】'
    }
})

4.3 执行阶段(Execution phase)

在获得 Task 的有向无环图之后,执行阶段就是根据依赖关系依次执行 Task 动作。

4.4 监听构建过程的耗时情况

long beginOfSetting = System.currentTimeMillis()
def beginOfConfig = false
def configHasBegin = false
def beginOfProjectConfig = new HashMap()
def beginOfProjectExecute

gradle.projectsLoaded {
    println "【初始化阶段结束】,总共耗时:" + (System.currentTimeMillis() - beginOfSetting) + "ms"
}
gradle.beforeProject { project ->
    if (!configHasBegin) {
        configHasBegin = true
        beginOfConfig = System.currentTimeMillis()
    }
    beginOfProjectConfig.put(project, System.currentTimeMillis())
}
gradle.afterProject { project ->
    def begin = beginOfProjectConfig.get(project)
    println "【配置 " + project + "】,耗时:" + (System.currentTimeMillis() - begin) + "ms"
}
gradle.taskGraph.whenReady {
    println "【配置阶段结束】,总耗时:" + (System.currentTimeMillis() - beginOfConfig) + "ms"
    beginOfProjectExecute = System.currentTimeMillis()
}
gradle.taskGraph.beforeTask { task ->
    task.doFirst {
        task.ext.beginOfTask = System.currentTimeMillis()
    }
    task.doLast {
        println "【执行 " + task + "】,耗时:" + (System.currentTimeMillis() - task.beginOfTask) + "ms"
    }
}
gradle.buildFinished {
    // 如果工程中包含 buildSrc 目录,对 buildSrc 项目的构建在这里会 beginOfProjectExecute 空指针
    if(null != beginOfProjectExecute){
        println "【执行阶段结束】,总耗时:" + (System.currentTimeMillis() - beginOfProjectExecute) + "ms"
    }
}

5. 总结

  • 初始化阶段: 解析 setting.gradle,为包含的每个项目实例化 Project 实例;
  • 配置阶段: 解析每个项目中的 build.gradle 文件,完成「Project 配置」&「Task 配置」,并根据 Task 依赖关系来创建一个有向无环图;
  • 执行阶段: 根据依赖关系依次执行 Task 动作。

参考资料

  • 《实战 Gradle》—— [美] Benjamin Muschko 著
  • 《深度探索 Gradle 自动化构建技术(三、Gradle 核心解密)》 —— JsonChao 著

创作不易,你的「三连」是丑丑最大的动力,我们下次见!

你可能感兴趣的:(「Gradle」| 进阶篇(Project & Task & 构建生命周期))