Gradle 编写构建脚本.pdf

Gradle 编写构建脚本 编写构建脚本 这⼀章着眼于⼀些编写构建脚本的详细信息。 Gradle 构建语⾔ Gradle 提供⼀种领域特定语⾔或者说 DSL ，来描述构建。这种构建语⾔基于 Groovy 中，并进⾏了⼀些补充，使其易于描述构建。 Project API 在Java 构建⼊门的教程中，我们使⽤了 apply ()⽅法。这⽅法从何⽽来？我们之前说 在 Gradle 中构建脚本定义了⼀个项⽬ （project ）。在构建的每⼀个项⽬中，Gradle 创 建了⼀个 Project 类型的实例，并在构建脚本中关联此 Project 对象。当构建脚本执⾏ 时，它会配置此 Project 对象： 在构建脚本中，你所调⽤的任何⼀个⽅法，如果在构建脚本中未定义，它将被 委托给 Project 对象。 在构建脚本中，你所访问的任何⼀个属性，如果在构建脚本⾥未定义，它也会 被委托给 Project 对象。 下⾯我们来试试这个，试试访问 Project 对象的 name 属性。 访问 Project 对象的属性 build .gradle println name println gradle -q chec 的输出结果 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 projectDir/build group Object 未指定 ersion Object 未指定 ant AntBuilderAntBuilder实例 Script API 当 Gradle 执⾏⼀个脚本时，它将脚本编译为⼀个实现了 Script 接⼜的类。这意味着所 有由该Script 接⼜声明的属性和⽅法在您的脚本中 可⽤的。 声明变量 有两类可以在⽣成脚本中声明的变量： 局部变量和额外属性。 局部变量局部 局部变量 ⽤ def 关键字声明的。它们只在定义它们的范围内可以被访问。局部变量 Groovy 语⾔底层的⼀个特征。 ⽰例 13.2. 使⽤局部变量 build .gradle def dest = dest task copy(type: Copy) { from source into dest } 额外属性 Gradle 的域模型中，所有增强的对象都可以容纳⽤户定义的额外的属性。这包括但并 不限于项⽬ （project ）、任务 （tas ）和源码集 （source set ）。额外的属性可以通过所 属对象的 ext 属性进⾏添加，读取和设置。或者，可以使⽤ ext 块同时添加多个属 性。 13.3 例⼦. 使⽤额外属性 build .gradle apply plugin: ja a ext { springVersion = 3.1.0.RELEASE emailNotification = build@ } sourceSets.all { ext.purpose = null } sourceSets { main { purpose = production } test { purpose