匯入任務用於將構建檔案匯入當前專案。使用ProjectHelper
解析匯入的檔案。 ProjectHelper
實際上負責解析匯入的檔案。
匯入任務是頂級任務,因此無法在目標元素中使用。 有兩個與此任務相關的功能。
目標覆蓋
如果當前檔案中的目標也可用於匯入的檔案,則當前檔案的目標將優先。
特殊屬性
匯入的檔案是當前主專案的本地檔案。 為了區分匯入和本地檔案,Ant新增了一個屬性,該屬性包含匯入的構建檔案的路徑。
注意:如果匯入的檔案不包含
name
屬性,則不會設定該屬性。
屬性 | 描述 | 必需 |
---|---|---|
file |
要匯入的檔案 | 是 |
optional |
如果為true ,則在檔案不存在時不要停止構建 |
否 |
as |
指定字首為目標名稱的字首 | 否 |
prefixSeparator |
要在字首和目標名稱之間使用的分隔符 | 否 |
以下程式碼從位於父目錄中的common-targets.xml
檔案匯入目標。
<project name="import-project-example" default="import">
<import file="../common-targets.xml"/>
</project>
匯入一個專案
<project name="import-project-example" default="import">
<import file="${deploy-platform}.xml"/>
</project>
它從common目錄內的targets.xml檔案匯入目標。
<project name="import-project-example" default="import">
<import>
<javaresource name="common/targets.xml">
<classpath location="common.jar"/>
</javaresource>
</import>
</project>