echoproperties

描述

显示项目中所有当前属性(或由嵌套的 <propertyset> 指定的属性子集)。如果需要,输出可以发送到文件。此任务可以用作从 ant 调用返回数据的某种人为方式,但实际上用于调试构建文件。

参数

属性 描述 必需
destfile 如果指定,该值表示要将语句输出发送到的文件名称。生成的输出文件与任何 Java 应用程序作为属性文件加载兼容。 否;默认情况下,输出到日志
prefix 用于过滤属性的前缀:仅名称以该前缀开头的属性将被回显。
regex 用于过滤属性的正则表达式:仅名称与其匹配的属性将被回显。
failonerror 如果在将属性写入文件时发生错误,并且启用了此属性,则将抛出 BuildException,导致构建失败。如果禁用,则 IO 错误将作为日志语句报告,并且构建将继续,不会因此任务而失败。 否;默认值为 true
format textxml 之一。确定输出格式。 否;默认为 text

作为嵌套元素指定的参数

propertyset

自 Ant 1.6 起.

您可以使用 propertyset 指定要回显的属性子集。使用 propertyset 可以更好地控制哪些属性将被选中。属性 prefixregex 只是内部使用 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>