Ant build 文件中的 Targets

一个target可以依赖于其他的target。

例如,你可能会有一个target用于编译程序,一个target用于生成可执行文件。

你在生成可执行文件之前必须先编译通过,所以生成可执行文件的target依赖于编译target。

Ant会处理这种依赖关系。

然而,应当注意到,Ant的depends属性只指定了target应该被执行的顺序-如果被依赖的target无法运行,这种depends对于指定了依赖关系的target就没有影响。

Ant会依照depends属性中target出现的顺序(从左到右)依次执行每个target。

然而,要记住的是只要某个target依赖于一个target,后者就会被先执行。<target name="A" /> <target name="B" depends="A" /> <target name="C" depends="B" /> <target name="D" depends="C,B,A" /> 假定我们要执行target D。从它的依赖属性来看,你可能认为先执行C,然后B,最后A被执行。

错了,C依赖于B,B依赖于A,所以先执行A,然后B,然后C,最后D被执行。

一个target只能被执行一次,即时有多个target依赖于它(看上面的例子)。

如果(或如果不)某些属性被设定,才执行某个target。

这样,允许根据系统的状态(java version, OS, 命令行属性定义等等)来更好地控制build的过程。

要想让一个target这样做,你就应该在target元素中,加入if(或unless)属性,带上target因该有所判断的属性。

例如:<target name="build-module-A" if="module-A-present"/> <target name="build-own-fake-module-A" unless="module-A-present"/> 如果没有if或unless属性,target总会被执行。

可选的description属性可用来提供关于target的一行描述,这些描述可由-projecthelp命令行选项输出。

将你的tstamp task在一个所谓的初始化target是很好的做法,其他的target依赖这个初始化target。

要确保初始化target是出现在其他target依赖表中的第一个target。

在本手册中大多数的初始化target的名字是"init"。

target有下面的属性:

Attribute Description Required name target 的名字

depends 用逗号分隔的target的名字列表,也就是依赖表。

if 执行target所需要设定的属性名。

unless 执行target需要清除设定的属性名。

description 关于target功能的简短描述。