ANT

ANT

关键字: ant 【转】Ant 是一个 Apache 基金会下的跨平台的构件工具，它可以实现项目的自动构建和部署等功能。在本文中，主要让读者熟悉怎样将 Ant 应用到 Java 项目中，让它简化构建和部署操作。

一．              安装与配置

下载地址： http://ant.apache.org/ ，在本文中下载的是 1.7.0 版本。解压到某个目录（例如 E:"apache-ant-1.7.0 ），即可使用。

添加系统环境变量： ANT_HOME ，该变量指向 Ant 解压后的根目录，在此为 E:"apache-ant-1.7.0 。

安装与配置完毕后，读者可以测试一下 Ant 是否可用，首先进入 Ant 的 bin 目录，运行命令 ant –version ，若安装和配置成功，则会显示 Ant 版本信息，如下图所示：
   

由上可以看出，读者运行 Ant 的命令时，需要进入到 Ant 的 bin 目录，如何才能让系统自动找到 Ant 呢？这时需要读者在系统环境变量 path 中添加 Ant 的 bin 目录。设置完成后，我们就可以在任何目录（例如 C:"Documents and Settings"AmigoXie 目录）输入 Ant 的命令，来获得命令的运行结果。

二．              Ant 的关键元素

Ant 的构件文件是基于 XML 编写的，默认名称为 build.xml 。为了更清楚的了解 Ant ，在这里编写一个简单的 Ant 程序，用来展现 Ant 的功能，让读者对 Ant 有一个初步的了解。首先在 E 盘下建立一个 build.xml 文件，内容如下：

<? xml version="1.0" ?>
< project  name ="helloWorld">
        < target  name ="sayHelloWorld">
               < echo  message ="Hello,Amigo"/>
        </ target >
</ project >

读者可以进入 E 盘，然后运行 ant sayHelloWorld ，可以看到如下的运行结果：
    

其中 sayHelloWorld 为需要执行的任务的名称。如果文件名不为 build.xml ，而为 hello.xml 时，读者运行同样的命令时，命令窗口会出现如下错误：

Buildfile: build.xml does not exist!

Build failed

由上面的命令的错误提示可以看出， ant 命令默认寻找 build.xml 文件。若文件名为 hello.xml 时，读者还需要对命令做少许改变，改为： ant –f hello.xml sayHelloWorld 、 ant –buildfile hello.xml sayHelloWorld 或 ant –file hello.xml sayHelloWorld 。

接下来开始向读者讲解本节的重点： Ant 的关键元素 project 、 target 、 property 和 task 。

1.        project 元素

project 元素是 Ant 构件文件的根元素， Ant 构件文件至少应该包含一个 project 元素，否则会发生错误。在每个 project 元素下，可包含多个 target 元素。接下来向读者展示一下 project 元素的各属性。

1 ） name 属性

用于指定 project 元素的名称。

2 ） default 属性

用于指定 project 默认执行时所执行的 target 的名称。

3 ） basedir 属性

用于指定基路径的位置。该属性没有指定时，使用 Ant 的构件文件的附目录作为基准目录。

下面给读者一个简单的例子来展示 project 的各元素的使用。修改 E:"build.xml 文件，修改后的内容如下：

<? xml version="1.0" ?>
< project  name ="projectStudy"  default ="sayBaseDir"  basedir ="E:" apache-ant-1.7.0" >
        < target  name ="sayBaseDir">
               < echo  message ="The base dir is: ${basedir}"/>
        </ target >
</ project >

从上面的内容我们可以看出，在这里定义了 default 属性的值为 sayBaseDir ，即当运行 ant 命令时，若未指明执行的 target 时，默认执行的 target 的 sayBaseDir ，同时还定义了 basedir 属性的值为 E:"apache-ant-1.7.0 ，进入 E 盘后运行 ant 命令，可看到运行的结果，如下图所示：
   

因为设定了 basedir 的值，所以 basedir 属性的值变成了读者设置的值。读者可以自行将 project 元素的 basedir 属性去掉后运行 ant 看看运行结果，此时 basedir 的值变成了 E:" ，即为 Ant 构件文件的父目录。

有的时候，读者可能有这种需求，即想得到某个 project 下所有的 target 的名称，读者可以通过在 ant 命令里加上 -proecthelp 来达到该目的。例如针对上述的例子我们运行 ant –projecthelp ，输出结果如下：

Buildfile: build.xml

Main targets:

Other targets:

 sayBaseDir

Default target: sayBaseDir

2.        target 元素

它为 Ant 的基本执行单元，它可以包含一个或多个具体的任务。多个 target 可以存在相互依赖关系。它有如下属性：

1 ） name 属性

指定 target 元素的名称，这个属性在一个 project 元素中是唯一的。我们可以通过指定 target 元素的名称来指定某个 target 。

2 ） depends 属性

用于描述 target 之间的依赖关系，若与多个 target 存在依赖关系时，需要以“ , ”间隔。 Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target 。被依赖的 target 会先执行。

3 ） if 属性

用于验证指定的属性是否存在，若不存在，所在 target 将不会被执行。

4 ） unless 属性

该属性的功能与 if 属性的功能正好相反，它也用于验证指定的属性是否存在，若不存在，所在 target 将会被执行。

5 ） description 属性

该属性是关于 target 功能的简短描述和说明。

下面带领读者来看一个各属性综合使用的例子。修改 E:"build.xml 文件，修改后的内容如下：

<? xml version="1.0" ?>
< project  name ="targetStudy">
        < target  name ="targetA"  if ="ant.java.version">
               < echo  message ="Java Version: ${ant.java.version}"/>
        </ target >
        < target  name ="targetB"  depends ="targetA"  unless ="amigo">
               < description >
                            a depend example!
               </ description >
               < echo  message ="The base dir is: ${basedir}"/>
        </ target >
</ project >

进入 E 盘后运行 ant targetB ，可看到如下图所示的运行结果：
   

读者分析结果后可以看到，我们运行的是名为 targetB 的 target ，因该 target 依赖于 targetA ，所以 targetA 将首先被执行，同时因为系统安装了 java 环境，所以 ant.java.version 属性存在，执行了 targetA 这个 target ，输出信息： [echo] Java Version: 1.5 ， targetA 执行完毕后，接着执行 targetB ，因为 amigo 不存在，而 unless 属性是在不存在时进入所在的 target 的，由此可知 targetB 得以执行，输出信息： The base dir is: E:" 。

3.        property 元素

该元素可看作参量或者参数的定义， project 的属性可以通过 property 元素来设定，也可在 Ant 之外设定。若要在外部引入某文件，例如 build.properties 文件，可以通过如下内容将其引入：

评论

2 楼 Javakeith 2010-09-28  

ant 总报a pseudo attribute name is expected 错误，是什么原因？

1 楼 路在转角处 2010-06-03  

重温了一下。