文章来源
上一篇咱们已经知道了Gradle构建脚本的重要性,要使用比较复杂的项目构建就需要来书写构建脚本,那Gradle 的构建脚本有哪些呢,请看构建脚本介绍.
构建脚本介绍
Gradle 构建脚本中最重要的两个概念是 project 和 task,任何一个 Gradle 构建都由一个或者多个project 组成,每个 project 包括许多的构建部分,可以是一个 jar 包,也可以是一个 web 应用,也可以是多个 jar 的整合,可以部署应用和搭建环境.Gradle 的 build-by-convention 可以指定 project 具体做什么.
每个 project 由一个或多个 task 组成,每个 task 表示在构建执行过程中的一个原子操作。如编译,打包,生成 javadoc,发布到仓库等操作。
project 和 task 的关系如下图
如图: Project1 依赖 Project2,所以需先构建 Project2 ,Project2 中有三个任务 Task FGH,由于依赖关系,先执行 Task G 再执行Task F 再执行 Task H.Project1 中的 Task 也是先执行被依赖的任务.
那 Project 到底是什么呢? 有什么内容呢? 以下咱们就来看下Project .
Project
一个 project 代表一个正在构建的组件(jar/war文件),当构建开始时,Gradle 会基于 build.gradle 实例化一个 org.gradle.api.Project 对象.并通过 project 变量来隐式调用其成员.那 Project 的成员有哪些呢?
Project 属性
名字 | 类型 | 默认值 |
---|---|---|
project | Project | project 实例 |
group | Object | 项目分组:未指定 |
name | String | 项目目录名 |
version | Object | 项目版本:未指定 |
path | String | 项目绝对路径 |
description | String | 项目描述 |
projectDir | File | 包含生成脚本目录 |
buildDir | File | projectDir/build |
ant | AntBuilder | AntBuilder 实例 |
常用的属性有project (隐式使用),group,name,version
Project 其他常用配置
- plugins , apply plugin 用来引入插件使用
- dependencies 依赖配置
- repositories 仓库配置
- task 任务书写
- ext,gradle.properties Project 中属性的其他配置方式
以上咱们已经对 project 有一定的了解了,知道 Gradle 构建项目离不开 Project 对象,以上配置都会被封装到 Project 对象中,但是Project 中同样离不开任务(task),以下咱们就来看下什么是 task ,task 有什么作用?
task 任务介绍
每个任务在构建执行过程中会被封装成 org.gradle.api.Task 对象. 主要包括任务的动作和任务依赖.任务动作定义了一个原子操作.可以定义依赖其他任务、动作顺序和执行条件.那任务有哪些相关操作呢?
任务主要操作动作
- dependsOn : 依赖相关操作
- doFirst : 任务执行之前执行的方法
- doLast,<< : 任务执行之后执行的方法、
例子:
// 定义一个简单的任务
task t1 {
println 'hello t1'
}
// t2 执行时依赖 t1
task t2 (dependsOn : 't1'){
// t2 执行前执行操作,
doFirst{
println 'do first'
}
println 'hello t2'
// t2 执行后执行操作,
doLast{
println 'do last'
}
}
命令 : gradle t2 或 双击 IDEA -> 右边Gradle -> Task -> other -> t2
> Configure project :
hello t1
hello t2
> Task :t1
> Task :t2
do first
do last
以上结果可以看出,直接定义在任务下的代码会在配置 project 时执行,其他时候不执行,就算依赖也不执行.只有在doFirst 或 doLast 中配置的操作才会在调用任务或者依赖执行时调用.以上是 task 的简单运用,至于任务的定义细节请看下一篇:Gradle 的任务task