Gradle构建的生命周期和其对象的理解

code小生,一个专注 Android 领域的技术平台

公众号回复 Android 加入我的安卓技术群

作者:William_Huang
链接:https://www.jianshu.com/p/4f0ff9bd2f62
声明:本文已获
William_Huang授权发表,转发等请联系原作者授权

640?wx_fmt=other

文章主题内容来自Gradle官方文档的Understanding the Build Lifecycler章节。通读完该章节,大大加深了我对task对象,project对象,gradle.build脚本和project对象的关系等这3个概念的理解。


官方文档地址:https://docs.gradle.org/current/userguide/build_lifecycle.html#sub:building_the_tree

构建的不同阶段

一个gradle的构建有3个不同的阶段

  1. 初始化(Initialization)
    Gradle支持单和多project的构建。在初始化阶段,gradle决定了哪一个或哪些project将要参与到这次构建,并且为每个project创建一个Project对象。(注意,一个project对应一个build.gradle文件)

  2. 安装(Configuration)
    在这个阶段,Project对象被安装(个人猜测是执行Project对象的构造函数)。所有参与到这次构建的build.gradle脚本文件都会被执行。

  3. 执行(Execution)
    在此阶段,gradle将会决定在安装(Configuration)阶段所创建和装配的tasks的哪些子集tasks要被执行。被执行的那些task是通过gradle命令的参数中的task的名字和当前在哪个目录下来决定的。gradle然后执行每一个被选中的task。

settings.gradle

  1. 除了build.gradle脚本之外,gradle还定义了一个settings.gradle文件。这个文件会在初始化(initialization)阶段被执行。

  2. 一个multi-project的构建必须有一个settings.gradle文件在根目录。因为后者定义了哪些project(也就是build.gradle脚本)会参与到这个构建。当然,单project(单个build.gradle脚本)的情况下,settings.gradle可有可无。

3个不同阶段在构建中的执行顺序

1. 定义了3个task来分别查看他们执行时打印的情况

  1. settings.gradle文件

println('initialization:settings.gradle被执行')
  1. build.gradle文件

println('configuration:build.gradle')
task configured{
    println('configuration:task configured')
}
task A{
    println('configuration:task A')
    doLast{
        println '这里执行task:A#doLast'
    }
}
task B {
    doFirst{
        println '这里执行task:B#doFirst'
    }
    doLast{
        println '这里执行task:B#doLast'
    }
    println 'configuration:task B'
}
  1. 640 gradle A

initializationsettings.gradle被执行

Configure project : 
configurationbuild.gradle
configuration:task configured
configuration:task A
configuration:task B

Task :A 
这里执行task:A#doLast
  1. 640 gradle A B

initializationsettings.gradle被执行

Configure project : 
configurationbuild.gradle
configuration:task configured
configuration:task A
configuration:task B

Task :A 
这里执行task:A#doLast

Task :B 
这里执行task:B#doFirst
这里执行task:B#doLast

2. 结论

  1. 初始化阶段执行settings.gradle脚本中的内容,

  2. 安装阶段执行build.gradle脚本中除了task.doLast(Closure c)和task.doFirst(Closure c)中的所有内容。因为在安装阶段时,该build.gradle文件对应的Project对象已经创建,此时安装阶段对应的就是Project对象执行其构造方法。而上述代码中在build.gradle中定义了3个task,那么在安装阶段,这3个task就会被创建为3个task对象实例,并且被加入到Project对象的TaskContainer容器中,此后,这3个task实例就作为Project对象的属性,可以直接使用了。

  3. 执行阶段,根据输入的task的名称和相关依赖(如果存在),去遍历执行对应的task对象中

private List<ContextAwareTaskAction> actions=new ArrayList<>();

的所有的方法,而当我们调用doLast或者doFirst都是往那个ArrayList的头尾插入由我们传入的闭包而转化成的Action接口的对象。而Action接口长这样:

@HasImplicitReceiver
public interface Action<T{
    void execute(T t);
}

那么到执行阶段,这个task的Action的容器actions就会被遍历并调用每个Action的execute(T t)方法。

响应build.gradle脚本的生命周期

1. Project的安装
build.gradle中的内容依靠Project对象的构造方法来安装Project对象,其中有两个回调暴露给我们,分别是

afterEvalueate(Closure closure)
beforeEvalueate(Closure closure)

它们属于Project接口中就定义了的方法,因此直接用就行

build.gradle:

afterEvaluate {
    if (it.hasProperty('group')) {
        println('has group')
        it.task('B'){
            doLast{
                println 'execute B'
            }
        }
    } else {
        println('do not have group')
    }
}
task A {
    println(' configure A')
}

执行task B

william@localhost:~/IdeaProjects/1$ gradle B

> Configure project : 
configure A
has task A

> Task :B 
execute B


BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed

执行结果如上,Project#afterEvaluated(Closure closure)方法会在Project对象全部安装完之后被调用,这也是其构造方法暴露给客户端的回调,那么Project对象的构造方法的伪代码如下:

public ProjectImpl(){
    runClosureBeforeEvalueation();//执行安装前的闭包
    configureCodeInSript();//安装
    runClosureAfterEvalueation();//执行安装后的闭包    
}

2. Task的创建
在一个task对象被添加到一个Project对象后,可以立刻收到一个回调。

用tasks.whenTaskAdded(Closure closure)就可以办到

build.gradle:

tasks.whenTaskAdded {
    println(it.name)
}
task A {
    println('configure A')
}
task B {
    println 'configure B'
}

执行task A

william@localhost:~/IdeaProjects/1$ gradle A

> Configure project : 
A
configure A
B
configure B

3.Task的执行

gradle.taskGraph.addTaskExecutionListener(new TaskExecutionListener() {
    @Override
    void beforeExecute(Task task) {
    }
    @Override
    void afterExecute(Task task, TaskState state) {
    }
})

gradle.taskGraph.beforeTask {
}
gradle.taskGraph.afterTask {
}

上面的接口的方法和下面的两个闭包方法的作用都是一样的,我认为他们相比于Task#doFirst 或者 Task#doLast 方法的优点在于,TaskExecutionGraph 的这几个方法,是为每一个安装了的 task 对象都插入一段回调,这段回调在每一个task 执行前后被调用。

个人总结:

  1. 在执行build.gradle之前,他所对应的Project对象已然创建,猜测是在执行settings.gradle时已经创建了。

  2. build.gradle中的所有代码,都作为Project对象的构造函数一部分而插入构造函数。

  3. 在build.gradle脚本中创建的所有Task对象都在创建后都被Project对象的TaskContainer这个容器对象引用。

  4. 命令行每执行一次gradle命令,就创建一个程序,从类似java的main方法开始运行。创建Project对象,执行build.gradle脚本来安装(在他的构造方法中),而gradle命令后面跟随的是task的名字,此时装配好Project对象后,根据传入的task的名字来去直接执行这个task。当task执行完毕输出结果后,程序结束,main()方法结束。

  5. 当直接执行gradle命令而不加task,也会依然会执行build.gradle中为Project装配而存在的代码,即此时Project对象存在,但是只是不去execute task了。

以上,为总结和对gradle运行原理的猜想,待考证更多资料后证实之。

Gradle 推荐阅读

Gradle基础知识点总结

Android Gradle 多渠道打包

提速 Android Gradle 构建

640

分享技术我是认真的

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值