擴充

自 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>

會新增一個 filename 選擇器至 input-fs