增强

自 Apache Ant 1.8.1 起

描述

通过添加嵌套元素或(重新)分配映射为 XML 属性的属性来修改现有引用。这是一个不寻常的任务,它利用 Ant 的内部处理机制通过 id 属性重新加载先前声明的引用,然后将声明的 augment 元素视为原始元素。

参数

属性 描述 必需
id 要增强的引用的 id。如果未声明此类引用,则会抛出 BuildException

其他允许的属性取决于要修改的引用。

作为嵌套元素指定的参数

允许的嵌套元素取决于要修改的引用。

示例

鉴于

<fileset id="input-fs" dir="${basedir}"/>

调用

<augment id="input-fs" excludes="foo"/>

修改 input-fsexcludes 属性,而

<augment id="input-fs">
  <filename name="bar"/>
</augment>

input-fs 添加一个 filename 选择器。