了解Gradle的整个构建生命周期之前我们需要先了解一下这些概念:
Gradle项目的组成
先来看一个常见的用Gradle构建的Android的项目(比如这个项目叫Search,主要包含一个搜索library和对library测试的Demo)
Search
--demo
--src
--build.gradle
--library
--src
--build.gradle
--build.gradle
--setting.gradle
相信这个目录对大部分android工程师来说都是挺熟悉的。我们来大致看一下Gradle是如何理解这个目录组织的。
gradle中的工程
其实我们可以认为如果在一个目录下存在build.gradle文件,那么就可以认为这是一个gradle工程(即Project,工程名即目录的名字)。
build.gradle
主要用于对工程进行配置。比如配置版本、依赖、使用的插件等等。
根工程与子工程
上面的Search项目有三个工程: Search、demo、library。从目录结构上看,demo、library好像是Search的子工程,但是如何在gradle中描述这种关系呢?
settings.gradle
settings.gradle
文件是gradle用来初始化整个构建工程树的。默认情况下,如果不配置这个文件,只是在Search目录下执行构建,那么gradle是不会去构建demo和library这两个
项目的。只有在setting.gradle
中配置了这两个工程,它们才算是Search的子工程。才会参与到Search项目的构建。如何配置呢?
如果demo和library项目的目录和settings.gralde
是平级的,那么可以直接这样配置:
include ':demo',':library'
如果demo和library项目的目录与settings.gradle
不是平级,或者在其他的地方,那么就需要指定这两个工程的目录:
include ':demo',':library'
project(':demo').projectDir = new File('dir path')
Task
举一个我们经常运行的命令 : gradle build
这里的build
就是一个task,在gradle中task就是一个操作,比如:打jar包、编译Java代码、上传jar包到maven。除了这些还有一些比较复杂的task,比如build,它就是由很多task组成的。
一个Project可以包含很多Task。
我们可以在一个工程根目录下运行gradle tasks
查看,这个工程包含哪些task。
Gradle的整个构建生命周期
上面我们大体简单回顾了一下gradle中基本概念,我们接下来就看一下当我们在工程中敲gradle build
时,gradle是如何对整个工程进行构建的。
在gradle中,整个构建分为3个过程:Initialization、Configuration、Execution,下面就针对这3个阶段简单看一下
Initialization
在初始化阶段,gradle要确定的一件比较重要的事是:这次构建是单工程构建还是多工程。即gradle会去寻找settings.grale
文件, 找的大致逻辑是:
- 当前目录查找
settings.grale
文件。查找到后开始构建 - 如果当前目录没有,则找当前目录的父目录有没有,如果有,则按照父目录的settings.grale开始构建
- 如果没有,则如果当前目录存在build.grale,进行单工程构建
确定好是单工程构建还是多工程构建后就会把参与构建的工程生成Project
对象。
Configuration
在这个阶段会对build.gralde
编写的脚本进行逐行执行,会进行如下任务
- 加载插件
- 加载依赖
- 加载task
- 执行脚本,自定义的插件DSL代码,本身gradle支持的API等
….
Execution
这个阶段很简单,就是执行对应的任务,比如 gradle build
关于gradle构建生命周期更细节的一些内容,可以参考官方文档 : https://docs.gradle.org/4.3/userguide/build_lifecycle.html