Bindtargets

自 Apache Ant 1.8.2 起

說明

讓某些目標成為某些已定義 擴充點 的延伸。它會讓目標清單成為擴充點的相依性。

當您想要讓目標參與另一個明確公開該類插入的擴充點時,此目標會很有用。因此,要繫結的目標和要繫結到的擴充點都會在某些匯入的建置檔案中宣告。但直接修改這些外部建置檔案的目標相依性圖表可能會對匯入它們的其他專案造成副作用。此任務有助於修改目標相依性,但僅限於您的內容。

注意:此任務相當於中間目標的定義,而中間目標會是繫結目標和擴充點之間的橋樑。例如

<bindtargets targets="jar,javadoc" extensionPoint="dist"/>

相當於

<target name="bind-to-dist" depends="jar,javadoc" extensionOf="dist"/>

此任務基本上會避免建立目標。

bindtargets 任務只能用作頂層任務。這表示它不能用在目標中。這會讓目標相依性圖表在載入每個建置檔案後就變成靜態且可預測。

參數

屬性 說明 必要
targets 要繫結的目標名稱清單,以逗號分隔。
extensionPoint 要將目標繫結到的擴充點名稱。
onMissingExtensionPoint 如果此目標嘗試延伸遺失的 擴充點,該怎麼辦:failwarnignore 否;預設為 fail

範例

<bindtargets targets="build-jar,build-src-jar" extensionPoint="dist"/>