The Gradle Daemon

改变Gradle的记录内容

你可以用自己的内容取代大部分摇篮的UI记录.你可以这样做，例如，如果你想以某种方式定制UI,如:记录更多或更少的信息，或更改log的格式.你可以使用Gradle.useLogger()方法替换日志.可从一个构建脚本或初始化脚本，或通过嵌入API替换.注意，这会完全禁用Gradle的默认输出.下面的初始化脚本改变任务执行和完成构建后日志的输出.例 17.6.定制Gradle logsinit.

从外部工具和库记录日志

在内部, Gradle 使用 Ant 和 lvy ,都有自己的 log 系统,Gradle 重定向他们的日志输出到 Gradle 日志系统.除了Ant/lvy的TRACE级别的日志, 映射到Gradle的DEBUG级别, 其余的都会有一个1:1的映射从 Ant/lvy 的日志等级到 Gradle 的日志等级.这意味着默认的 Gradle 日志级别将不会显示任何的 Ant /lvy 的输出, 除非它是一个错误或警告.

Choosing a log level

你可以在命令行中选择如[表 17.2.Log 等级命令行选项]()所示的选项选择不同的日志级别.如[表 17.3.堆栈信息选项]()中所示的选项来选择堆栈信息.表17.2.Log 等级命令行选项选项输出日志等级no logging optionsLIFECYCLE及更高-q or --quietQUIET及更高-i or --infoINFO及更高-d or --debugDEBUG及更高(所有日志信息)表 17.3.

Logging

Log 是构建的主要"UI"工具. 如果日志太过冗长, 那么真正的警告和问题会隐藏其中, 另一方面, 如果你出错了,你又需要搞清楚相关错误信息. Gradle 提供了6个等级的 log, 如[表17.1.Logs Level]()所示.出了那些你可能经常看到的, 还有两个是 Gradle 特定级别的日志,被称为QUIET和LIFECYCLE.后者是默认的, 并用于报告生成进度.表17.1.

API

Ant 集成是由 AntBuilder 提供的.git

Ant的属性与引用

有许多方法可以设定 Ant 属性,可以通过Ant任务使用属性.您可以直接在AntBuilder的实例设置属性。Ant的属性也可以作为一个可改变的Map.也可以使用Ant的任务属性,如下例所示:例16.13.设置Ant属性build.gradleant.buildDir = buildDirant.properties.buildDir = buildDirant.properties['buildDir'] = buildDirant.property(name: 'buildDir', location: buildDir)build.

在 Gradle中使用Ant

Gradle 出色的集成了 Ant. 你可以在 Gradle 构建时使用单独的 Ant 任务或完整的 Ant 构建. 事实上, 你会发现在 Gradle 构建脚本中使用Ant任务远比直接使用 Ant 的 XML 格式更加容易和强大. 你甚至可以将 Gradle 仅仅作为一个强大的 Ant 脚本工具.Ant 可以分为两层. 第一层是 Ant 语言. 它给 build.xml 文件, 处理目标, 像 macrodefs 的特殊构造等提供语法支持.

创建归档文件

一个项目可以有很多 JAR 文件,你可以向项目中添加 WAR , ZIP 和 TAR 文档,使用归档任务可以创建这些文档: Zip , Tar , Jar , War 和Ear. 它门都以同样的机制工作.例 15.19 创建一个 ZIP 文档 build.gradleapply plugin: 'java'task zip(type: Zip) { from 'src/dist' into('libs') { from configurations.

使用同步任务

同步任务 ( Sync ) 任务继承自复制任务 ( Copy ) , 当它执行时,它会复制源文件到目标目录中,然后从目标目录中的删除所有非复制的文件,这种方式非常有用,比如安装一个应用,创建一个文档的副本,或者维护项目的依赖关系副本.下面有一个例子,维护 build/libs 目录下项目在运行时的依赖例 15.7 使用 Sync 任务复制依赖关系build.

复制文件

你可以使用复制任务( Copy )去复制文件. 复制任务扩展性很强,能够过滤复制文件的内容, 映射文件名.使用复制任务时需要提供想要复制的源文件和一个目标目录,如果你要指定文件被复制时的转换方式，可以使用 复制规则. 复制规则被 CopySpec 接口抽象,复制任务实现了这个接口. 使用 CopySpec.from() 方法指定源文件.使用 CopySpec.into() 方法指定目标目录.例 15.10.

文件树

文件树就是一个按照层次结构分布的文件集合,例如,一个文件树可以代表一个目录树结构或者一个 ZIP 压缩文件的内容.它被抽象为 FileTree 结构,FileTree 继承自 FileCollection,所以你可以像处理文件集合一样处理文件树, Gradle 有些对象实现了FileTree 接口,例如 源集合.使用 Project.

文件集合

文件集合表示一组文件，Gradle 使用 FileCollection 接口表示文件集合, Gradle API 中的许多项目都实现了这个接口,例如 dependency configurations .获取 FileCollection 实例的一种方法是使用 Project.files() 方法.你可以传递任何数量的对象参数,这个方法能将你传递的对象集合转换为一组文件对象.files() 方法接收任何类型对象参数.

Locating files

使用 Project.file() 方法能够相对项目目录定位一个文件例 16.1. 定位文件build.gradle// 使用一个相对路径File configFile = file('src/config.xml')// 使用一个绝对路径configFile = file(configFile.absolutePath)// 使用一个项目路径的文件对象 configFile = file(new File('src/config.xml'))`file() 方法接收任何形式的对象参数.

文件操作

大多数构建工作需要操作文件，Gradle 增加了一些API帮助您处理这些工作。

缓存

为了提高响应能力，Gradle 默认缓存了所有编译后的脚本. 包括所有的构建脚本，初始化脚本，还有其他脚本. Gradle 创建了一个 .gradle 目录来存放编译后的脚本，下次您运行构建脚本时，如果这个脚本自从它被编译后就再也没有被改动过，Gradle 会先使用编译后的脚本. 否则 Gradle 会重新编译脚本，然后将新编译后的文件缓存起来.

配置任意对象

您可以使用下面方法配置任意的对象.例子 14.4.配置任意对象build.gradletask configure << { def pos = configure(new java.text.FieldPosition(10)) { beginIndex = 1 endIndex = 5 } println pos.beginIndex println pos.endIndex}使用 gradle -q configure 输出> gradle -q configure15

Gradle 属性 和 system 属性

Gradle 提供了多种的方法让您可以在构建脚本中添加属性. 使用 -D 命令选项，您可以向运行 Gradle 的 JVM 传递一个 system 属性 . Gradle 命令的 -D 选项 和 Java 命令的 -D 选项有些相同的效果.您也可以使用属性文件向您的 Project 对象中添加属性. 您可以在 Gradle 用户目录( 如果您没有在 USER_HOME/.gradle 配置默认设置,则由"GRADLE_USER_HOME"

补充

下面补充的部分原本是第 14 章，最新的 Gradle 文档将其移除，所以将其作为补充放到这一章节。

终止 tasks

终止任务是一个正在开发的功能.这里的终止任务并不是指终止一个任务, 而是指一个无论运行结果如何最后都会被执行的任务.例子 15.27. 加入一个任务终止器build.gradletask taskX << { println 'taskX'}task taskY << { println 'taskY'}taskX.finalizedBy taskYgradle -q taskX 的输出>