導(dǎo)入任務(wù)用于將構(gòu)建文件導(dǎo)入當(dāng)前項(xiàng)目。使用ProjectHelper解析導(dǎo)入的文件。 ProjectHelper實(shí)際上負(fù)責(zé)解析導(dǎo)入的文件。
導(dǎo)入任務(wù)是頂級任務(wù),因此無法在目標(biāo)元素中使用。 有兩個(gè)與此任務(wù)相關(guān)的功能。
目標(biāo)覆蓋
如果當(dāng)前文件中的目標(biāo)也可用于導(dǎo)入的文件,則當(dāng)前文件的目標(biāo)將優(yōu)先。
特殊屬性
導(dǎo)入的文件是當(dāng)前主項(xiàng)目的本地文件。 為了區(qū)分導(dǎo)入和本地文件,Ant添加了一個(gè)屬性,該屬性包含導(dǎo)入的構(gòu)建文件的路徑。
注意:如果導(dǎo)入的文件不包含
name屬性,則不會(huì)設(shè)置該屬性。
| 屬性 | 描述 | 必需 |
|---|---|---|
file |
要導(dǎo)入的文件 | 是 |
optional |
如果為true,則在文件不存在時(shí)不要停止構(gòu)建 |
否 |
as |
指定前綴為目標(biāo)名稱的前綴 | 否 |
prefixSeparator |
要在前綴和目標(biāo)名稱之間使用的分隔符 | 否 |
以下代碼從位于父目錄中的common-targets.xml文件導(dǎo)入目標(biāo)。
<project name="import-project-example" default="import">
<import file="../common-targets.xml"/>
</project>
導(dǎo)入一個(gè)項(xiàng)目
<project name="import-project-example" default="import">
<import file="${deploy-platform}.xml"/>
</project>
它從common目錄內(nèi)的targets.xml文件導(dǎo)入目標(biāo)。
<project name="import-project-example" default="import">
<import>
<javaresource name="common/targets.xml">
<classpath location="common.jar"/>
</javaresource>
</import>
</project>