【Android Gradle 插件】Gradle 构建机制 ④ ( Gradle 构建生命周期 | 初始阶段 | 配置阶段 | 执行阶段 )
Gradle 构建生命周期 :
- 初始阶段 ( Initialization )
- 配置阶段 ( Configuration )
- 执行阶段 ( Execution )
Gradle 构建生命周期 完整流程 : 下图中的函数 , 都可以作为 HOOK 点 , 监听拦截 Gradle 的执行流程 ;
参考
- 【Android Gradle 插件】Gradle 构建生命周期 ① ( 分析构建脚本 | 执行初始化配置 | 执行 Gradle 任务 | Project#beforeEvaluate 函数 )
- 【Android Gradle 插件】Gradle 构建生命周期 ② ( Gradle 类的添加构建生命周期监听器函数 | Gradle#addListener 函数 )
- 【Android Gradle 插件】Gradle 构建生命周期 ③ ( BuildListener 构建监听器 | TaskExecutionGraphListener 任务执行图监听器 )
博客 , 添加 Gradle 生命周期中的监听器 , 以监听拦截生命周期的各个阶段执行情况 ;
一、初始阶段
初始阶段 ( Initialization ) : Gradle 构建启动后最开始执行的阶段 ;
- 执行 settings.gradle 构建脚本 , 查看当前的工程有哪些子模块 , 工程的顶层配置有哪些 , 如 rootProject.name 工程名称 ;
- 为每个 build.gradle 构建脚本 创建对应的 Project 实例对象 ;
Gradle 构建 是 通过 调用 Gradle#buildStarted 函数 开启的 , 该函数 不属于 初始化阶段 ,
下面开始 进入 初始化阶段 :
首先 , 执行 settings.gradle 构建脚本 ;
然后 , 执行 Gradle#settingsEvaluated 函数 , 验证 settings.gradle 中的配置 ;
最后 , 执行 Gradle#projectsLoaded 函数 , 创建 Project 实例对象 ;
下图是初始化阶段执行的过程 :
监听拦截初始化阶段 : 参考 【Android Gradle 插件】Gradle 构建生命周期 ② ( Gradle 类的添加构建生命周期监听器函数 | Gradle#addListener 函数 ) 二、Gradle#addBuildListener 函数 博客 , 调用 Gradle#addBuildListener 方法 , 添加 BuildListener 监听器 , 参考代码如下 :
gradle.addBuildListener(new BuildListener() {
@Override
void buildStarted(Gradle gradle) {
// 构建开始时回调该函数
}
@Override
void settingsEvaluated(Settings settings) {
// 分析 settings.gradle 函数完成后回调该函数
}
@Override
void projectsLoaded(Gradle gradle) {
}
@Override
void projectsEvaluated(Gradle gradle) {
}
@Override
void buildFinished(BuildResult buildResult) {
// 构建完成时回调的函数
}
})
其中
- BuildListener#settingsEvaluated 接口 就可以拦截 初始化阶段的 Gradle#settingsEvaluated 函数 ,
- BuildListener#projectsLoaded 接口 就可以拦截 初始化阶段的 Gradle#projectsLoaded 函数 ,
二、配置阶段
配置阶段 ( Configuration ) 会解析 工程根目录 和 每个模块 下的 build.gradle 构建脚本 , 确定 任务分组 , 任务之间的 依赖关系 , 执行顺序 等 , 然后对任务进行配置 ; 注意这里 只对任务进行配置 , 不会执行任务 ;
在 编写完 build.gradle 构建脚本 后 , 并 不会生成 Gradle 任务 , 在右侧的 Gradle 面板中找不到自定义的 Gradle 任务 , 需要点击 " Sync Now " 按钮 , 进行 配置阶段 操作 , 才会在右侧 Gradle 面板中 生成自定义的 Gradle 任务 , 并且 将指定的任务分配的指定的分组 , 任务间的依赖关系 , 执行先后顺序 也会进行处理配置 ;
如果没有配置 , 是不会再右侧 Gradle 面板显示自定义 Gradle 任务的 ;
配置阶段执行内容 :
如果要对该 " 配置阶段 " 的构建过程进行拦截 , 参考 【Android Gradle 插件】Gradle 构建生命周期 ① ( 分析构建脚本 | 执行初始化配置 | 执行 Gradle 任务 | Project#beforeEvaluate 函数 ) 二、Project#afterEvaluate 函数 三、Project#beforeEvaluate 函数 博客章节 , 可以直接在 build.gradle 构建脚本中 调用上述 Project#beforeEvaluate 函数 和 Project#afterEvaluate 函数 ;
1、任务配置示例演示
在根目录的 build.gradle 构建脚本 中 , 定义一个任务
task Hello {
println "Hello"
}
点击右上方的 " Sync Now " 进行同步 ,
发现在 配置工程 阶段 , 执行了 Hello 任务闭包中的代码 ,
在 Build 面板中输出内容如下 : 下面的输出说明 , 配置阶段只配置任务 , 并没有执行任务 ;
Starting Gradle Daemon...
Gradle Daemon started in 2 s 669 ms
> Configure project :
Hello
BUILD SUCCESSFUL in 11s
2、任务执行示例演示
点击该 Gradle 任务左侧的 运行按钮 , 运行该任务 ;
运行 Hello 任务 , Build 面板输出如下内容 , 说明运行任务前 , 需要配置任务 ;
16:46:20: Executing task 'Hello'...
Executing tasks: [Hello] in project D:\002_Project\002_Android_Learn\MyApplication2
> Configure project :
Hello
AGPBI: {"kind":"warning","text":"Please remove usages of `jcenter()` Maven repository from your build scripts and migrate your build to other Maven repositories.\nThis repository is deprecated and it will be shut down in the future.\nSee http://developer.android.com/r/tools/jcenter-end-of-service for more information.\nCurrently detected usages in: root project 'My Application', project ':app', project ':hello', ...","sources":[{}]}
> Task :Hello UP-TO-DATE
BUILD SUCCESSFUL in 496ms
16:46:21: Task execution finished 'Hello'.
3、任务执行示例代码
修改构建脚本中的 Hello 任务 , 修改完毕后 , 点击右上角的 " Sync Now " 按钮 ,
task Hello {
println "Hello"
doFirst {
println "Hello doFirst"
}
}
输入结果如下 , 该 Hello 任务只进行了配置 , 没有运行任务 ;
> Configure project :
Hello
BUILD SUCCESSFUL in 3s
三、执行阶段
执行阶段 ( Execution ) 会在 配置阶段 的 任务配置 基础上 , 执行任务 ;
执行阶段执行的任务如下 :
如果要对该过程进行拦截 , 可参考 【Android Gradle 插件】Gradle 构建生命周期 ③ ( BuildListener 构建监听器 | TaskExecutionGraphListener 任务执行图监听器 ) 博客进行 拦截 ;
相关文章
- Android配置----DDMS 连接真机(己ROOT),用file explore看不到data/data文件夹的解决办法
- Android源码浅析(一)——VMware Workstation Pro和Ubuntu Kylin 16.04 LTS安装配置
- Android环境配置
- android 11.0删除连接wifi的配置信息
- 【Kotlin 协程】协程简介 ( 协程概念 | 协程作用 | 创建 Android 工程并进行协程相关配置开发 | 异步任务与协程对比 )
- 【Android Gradle 插件】Gradle 构建工具简介 ① ( Gradle 环境配置 | 官网下载 Gradle 软件包 | 在本地用户目录下查找 | 配置 Gradle 环境变量 )
- 【Android Gradle 插件】将自定义 Gradle 插件上传到自建 Maven 仓库 ⑥ ( 配置 Sonatype Nexus 搭建的 Maven 私服 | 配置端口号 | 配置JVM )
- 【Android Gradle 插件】自定义 Gradle 插件模块 ③ ( Gradle 插件模块发布配置 | Windows 本地 Maven 仓库地址 | 将插件上传到本地 Maven 仓库 )
- 【Android Gradle 插件】自定义 Gradle 插件模块 ② ( 在模块中定义插件 | 引入自定义 Gradle 插件模块 | 配置 Gradle 插件上传选项 | 配置分组名称版本号 )
- 【Android Gradle 插件】TestOptions 配置 ④ ( org.gradle.api.tasks.testing.Test 单元测试配置类 | Android 单元测试示例 )
- 【Android Gradle 插件】LintOptions 配置 ⑩ ( textReport 属性配置 | textOutput 属性配置 | warningsAsErrors 属性配置 )
- 【Android Gradle 插件】LintOptions 配置 ⑧ ( ignoreWarnings 属性配置 | lintConfig 属性配置 | noLines 属性配置 )
- 【Android Gradle 插件】DexOptions 配置 ⑧ ( preDexLibraries 属性配置 | threadCount 属性配置 )
- 【Android Gradle 插件】CompileOptions 配置 ( BaseExtension#compileOptions 脚配块配置 | CompileOptions 属性配置 )
- 【Android Gradle 插件】AaptOptions 配置 ⑤ ( AaptOptions#noCompress 压缩配置 )
- 【Android Gradle 插件】AaptOptions 配置 ④ (failOnMissingConfigEntry 配置|ignoreAssets/ignoreAssetsPattern配置)
- 【Android Gradle 插件】BuildType 编译类型配置 ⑦ ( BuildType#testCoverageEnabled 配置 )
- 【Android Gradle 插件】BuildType 编译类型配置 ③ ( javaCompileOptions 配置 | jniDebuggable 配置 )
- 【Android Gradle 插件】ProductFlavor 配置 ( ProductFlavor#resValue 方法 | ProductFlavor#dimension 维度属性 )
- 【Android Gradle 插件】ProductFlavor 配置 ( 测试相关配置 | versionNameSuffix 配置 | applicationIdSuffix 配置 )
- 【Android Gradle 插件】ProductFlavor 配置 ( ProductFlavor#ndk 配置 | ProductFlavor#proguardFiles 配置 )
- 【错误记录】Android Studio 中查看 Gradle 配置的方法源码 ( 配置 gradle-wrapper.properties 中版本为 gradle-x.x.x-all.zip )
- 【Android 安装包优化】使用 lib7zr.so 动态库处理压缩文件 ( 拷贝 lib7zr.so 动态库头文件到 Android 工程中 | 配置 CMakeLists.txt 构建脚本 )
- 【Android Protobuf 序列化】Protobuf 使用 ( protobuf-gradle-plugin 插件简介 | Android Studio 中配置插件 | AS 中编译源文件 )
- Android Studio 安装与配置