本文整理自网络,侵删。
编写构建脚本
这一章着眼于一些编写构建脚本的详细信息。
Gradle 构建语言
Gradle 提供一种领域特定语言或者说是 DSL,来描述构建。这种构建语言基于 Groovy 中,并进行了一些补充,使其易于描述构建。
Project API
在Java 构建入门的教程中,我们使用了 apply ()方法。这方法从何而来?我们之前说在 Gradle 中构建脚本定义了一个项目(project)。在构建的每一个项目中,Gradle 创建了一个 Project 类型的实例,并在构建脚本中关联此 Project 对象。当构建脚本执行时,它会配置此 Project 对象:
- 在构建脚本中,你所调用的任何一个方法,如果在构建脚本中未定义,它将被委托给 Project 对象。
- 在构建脚本中,你所访问的任何一个属性,如果在构建脚本里未定义,它也会被委托给 Project 对象。
下面我们来试试这个,试试访问 Project 对象的 name 属性。
访问 Project 对象的属性
build.gradle
println name
println project.name
gradle -q check 的输出结果
> gradle -q check
projectApi
projectApi
这两个 println 语句打印出相同的属性。在生成脚本中未定义的属性,第一次使用时自动委托到 Project 对象。其他语句使用了在任何构建脚本中可以访问的 project 属性,则返回关联的 Project 对象。只有当您定义的属性或方法 Project 对象的一个成员相同名字时,你才需要使用 project 属性。
标准 project 属性
Project对象提供了一些在构建脚本中可用的标准的属性。下表列出了常用的几个属性。
表 13.1. Project 属性
名称 | 类型 | 默认值 |
project
|
Project
|
Project 实例 |
name
|
String
|
项目目录的名称。 |
path
|
String
|
项目的绝对路径。 |
description
|
String
|
项目的描述。 |
projectDir
|
File
|
包含生成脚本的目录。 |
buildDir
|
File
|
|
group
|
Object
|
未指定
|
version
|
Object
|
未指定
|
ant
|
AntBuilder
|
AntBuilder 实例 |
Script API
当 Gradle 执行一个脚本时,它将脚本编译为一个实现了 Script 接口的类。这意味着所有由该Script 接口声明的属性和方法在您的脚本中是可用的。
声明变量
有两类可以在生成脚本中声明的变量: 局部变量和额外属性。
局部变量局部
局部变量是用 def 关键字声明的。它们只在定义它们的范围内可以被访问。局部变量是 Groovy 语言底层的一个特征。
示例 13.2. 使用局部变量
build.gradle
def dest = "dest"
task copy(type: Copy) {
from "source"
into dest
}
额外属性
Gradle 的域模型中,所有增强的对象都可以容纳用户定义的额外的属性。这包括但并不限于项目(project)、任务(task)和源码集(source set)。额外的属性可以通过所属对象的 ext 属性进行添加,读取和设置。或者,可以使用 ext 块同时添加多个属性。
13.3 例子. 使用额外属性
相关阅读 >>
更多相关阅读请进入《Gradle》频道 >>