上一篇我们已经知道了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 F G H,由于依赖关系,先执行 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》。