显示项目中所有当前属性(或由嵌套的 <propertyset>
指定的属性子集)。如果需要,输出可以发送到文件。此任务可以用作从 ant 调用返回数据的某种人为方式,但实际上用于调试构建文件。
属性 | 描述 | 必需 |
---|---|---|
destfile | 如果指定,该值表示要将语句输出发送到的文件名称。生成的输出文件与任何 Java 应用程序作为属性文件加载兼容。 | 否;默认情况下,输出到日志 |
prefix | 用于过滤属性的前缀:仅名称以该前缀开头的属性将被回显。 | 否 |
regex | 用于过滤属性的正则表达式:仅名称与其匹配的属性将被回显。 | 否 |
failonerror | 如果在将属性写入文件时发生错误,并且启用了此属性,则将抛出 BuildException ,导致构建失败。如果禁用,则 IO 错误将作为日志语句报告,并且构建将继续,不会因此任务而失败。 |
否;默认值为 true |
format | text或 xml之一。确定输出格式。 |
否;默认为 text |
自 Ant 1.6 起.
您可以使用 propertyset 指定要回显的属性子集。使用 propertyset
可以更好地控制哪些属性将被选中。属性 prefix 和 regex 只是内部使用 propertyset
的快捷方式。
将当前属性报告到日志。
<echoproperties/>
将当前属性报告到文件 my.properties,如果无法创建或写入文件,则使构建失败。
<echoproperties destfile="my.properties"/>
将当前属性报告到文件 my.properties,如果无法创建或写入文件,则记录一条消息,但仍允许构建继续。
<echoproperties destfile="my.properties" failonerror="false"/>
列出所有以 java. 开头的属性。
<echoproperties prefix="java."/>
使用嵌套的 <propertyset/>
列出所有以 java. 开头的属性,这是一种等效但更长的方式。
<echoproperties> <propertyset> <propertyref prefix="java."/> </propertyset> </echoproperties>
列出名称中包含 ant 的所有属性。
<echoproperties regex=".*ant.*"/>
使用 <propertyset/>
的等效代码段为
<echoproperties> <propertyset> <propertyref regex=".*ant.*"/> </propertyset> </echoproperties>