ANT使用指南

ANT 使用指南

导言

Ant 是基于 java 的编译工具,她类似于 Make 工具

环境

下载最新的 Ant 版本(Http://ant.apache.org),解压到某个目录$Ant。然后设置一下环境变量

ANT_HOME=$Ant

PATH=$PATH:$ANT_HOME/bin

运行 Ant

设置好环境以后,就可以运行 Ant 了。

-quiet be extra quiet

-verbose be extra verbose

-debug print debugging information

-emacs produce logging information without adornments

-logfile file use given file for log output

-logger classname the class that is to perform logging

-listener classname add an instance of class as a project listener

-buildfile file use specified buildfile

-find file search for buildfile towards the root of the filesystem and use the first one found

-Dproperty=value set property to value

使用当前目录下的 test.xml 运行 Ant，执行一个叫做 dist 的 target。

ant -buildfile test.xml -Dbuild=build/classes dist

使用当前目录下的 test.xml 运行 Ant，执行一个叫做 dist 的 target，并设定 build 属性的值为 build/classes。

编写 build.xml

Projects

buildfile 中每个 task 元素可以有一个 id 属性，可以用这个 id 值引用指定的任务。这个值必须是唯一的。

project 有下面的属性：

Attribute Description Required

一个项目可以定义一个或多个 target。一个 target 是一系列你想要执行的。执行 Ant 时，你可以选择执行那

个 target。当没有给定 target 时，使用 project 的 default 属性所确定的 target。

Targets

一个 target 可以依赖于其他的 target。例如，你可能会有一个 target 用于编译程序，一个 target 用于生成可

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

会处理这种依赖关系。

然而，应当注意到，Ant 的 depends 属性只指定了 target 应该被执行的顺序－如果被依赖的 target 无法运行，

这种 depends 对于指定了依赖关系的 target 就没有影响。

<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 因该有所判断的属性。例如：

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

初始化 target是出现在其他 target依赖表中的第一个target。在本手册中大多数的初始化 target的名字是"init"。

target 有下面的属性：

Attribute Description Required

name target 的名字 Yes

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

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

一个 task 是一段可执行的代码。

一个 task 可以有多个属性（如果你愿意的话，可以将其称之为变量）。属性只可能包含对 property 的引用。

这些引用会在 task 执行前被解析。

下面是 Task 的一般构造形式：

<name attribute1="value1" attribute2="value2" ... />

可以给 task 赋一个 id 属性：