前言

Apache Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的软件开发。由Apache软件基金会所提供。

Ant是纯Java语言编写的，所以具有很好的跨平台性。

 

1 下载和安装

1.1 下载

 

ant的官方下载地址：http://ant.apache.org/bindownload.cgi

进入页面后，在下图的红色方框中可以下载最新版本。笔者下载的版本是 apache-ant-1.9.4。

 

1.2 配置环境变量

配置环境变量（我的电脑 -> 属性 -> 高级 -> 环境变量）。

设置ant环境变量：

ANT_HOME

    C:/ apache-ant-1.9.4

path               C:/ apache-ant-1.9.4/bin

 

classpath        C:/apache-ant-1.9.4/lib

 

1.3 验证

点击 开始 -> 运行 -> 输入cmd

执行构建文件

输入如下命令：ant
如果出现如下内容，说明安装成功：

Buildfile: build.xml does not exist!

Build failed

注意：因为ant默认运行build.xml文件，这个文件需要我们创建。

如果不想命名为build.xml，运行时可以使用 ant -buildfile test.xml 命令指明要运行的构建文件。

 

查看版本信息

输入 ant  -version，可以查看版本信息。 

 

但如果出现 'ant' 不是内部或外部命令，也不是可运行的程序或批处理文件

说明安装失败：（可以重复前述步骤，直至安装成功。）

 

2 例子

在安装和配置成功后，我们就可以使用ant了。

为了让读者对ant有一个直观的认识，首先以Ant官方手册上的一个简单例子做一个说明。

以下是一个build.xml文件的内容：

<

project 

name

="MyProject"

 default

="dist"

 basedir

="."

>

    

<

description

>

        simple example build file

    

</

description

>

  

<!--

 set global properties for this build 

-->

  

<

property 

name

="src"

 location

="src"

/>

  

<

property 

name

="build"

 location

="build"

/>

  

<

property 

name

="dist"

  location

="dist"

/>

  

<

target 

name

="init"

>

    

<!--

 Create the time stamp 

-->

    

<

tstamp

/>

    

<!--

 Create the build directory structure used by compile 

-->

    

<

mkdir 

dir

="${build}"

/>

  

</

target

>

  

<

target 

name

="compile"

 depends

="init"

        description

="compile the source "

 

>

    

<!--

 Compile the java code from ${src} into ${build} 

-->

    

<

javac 

srcdir

="${src}"

 destdir

="${build}"

/>

  

</

target

>

  

<

target 

name

="dist"

 depends

="compile"

        description

="generate the distribution"

 

>

    

<!--

 Create the distribution directory 

-->

    

<

mkdir 

dir

="${dist}/lib"

/>

    

<!--

 Put everything in ${build} into the MyProject-${DSTAMP}.jar file 

-->

    

<

jar 

jarfile

="${dist}/lib/MyProject-${DSTAMP}.jar"

 basedir

="${build}"

/>

  

</

target

>

  

<

target 

name

="clean"

        description

="clean up"

 

>

    

<!--

 Delete the ${build} and ${dist} directory trees 

-->

    

<

delete 

dir

="${build}"

/>

    

<

delete 

dir

="${dist}"

/>

  

</

target

>

</

project

>

在这个xml文件中，有几个target标签，每个target对应一个执行目标。

我们将这个build.xml放在 D:\Temp\ant_test 路径下，然后在dos界面下进行测试。

ant init

在 D:\Temp\ant_test 路径下创建了一个build目录，执行成功。

 

ant compile

提示错误，原来是在build.xml的所在目录下找不到src目录。好的，我们直接创建一个src目录，然后再次尝试。

这次，执行成功。

 

ant dist

在 D:\Temp\ant_test 路径下创建了一个dist目录，执行成功。

 

ant clean

清除创建的build和dist目录，执行成功。

 

一个细节

细心的读者，想必已经发现一个问题——在执行 ant compile 和 ant dist 命令的时候把前面的命令也执行了。这是为什么呢？

请留意一下build.xml中的内容。有部分 target 标签中含有 depends 关键字。

这表明，当前的 target 在执行时需要依赖其他的target，必须先执行依赖的target，然后再执行。

 

3 关键元素

 

Ant的构件文件都是XML格式的。每个构件文件包含一个project元素和至少一个target。

target元素可以包含多个task元素。

 

3.1 Project 元素

 

project 元素是构建文件的根元素。

一个 project 元素可以有多个 target 元素，一个 target 元素可以有多个 task。

在上节的例子中，project标签里有三个属性。 

<

project 

name

="MyProject"

 default

="dist"

 basedir

="."

>

name属性，指示 project 元素的名字。例子中的名字就是 MyProject。

default属性，指示这个 project 默认执行的 target。在本文的例子中，默认执行的 target 为 dist。

如果我们输入命令 ant 时，不指定 target 参数，默认会执行 dist 这个 target。

basedir属性，指定根路径的位置。该属性没有指定时，使用Ant的构件文件的所在目录作为根目录。

 

3.2 Target 元素

target 元素是 task 的容器，也就是 Ant 的一个基本执行单元。

以上节例子中的 compile 来举例。

<

target 

name

="compile"

 depends

="init"

 description

="compile the source "

 

>

    

<!--

 Compile the java code from ${src} into ${build} 

-->

    

<

javac 

srcdir

="${src}"

 destdir

="${build}"

/>

</

target

>

这个 target 中出现了几个属性。

name属性，指示target元素的名称。

这个属性在一个project元素中必须是唯一的。这很好理解，如果出现重复，Ant就不知道具体该执行哪个 target 了。

depends属性，指示依赖的 target，当前的 target 必须在依赖的 target 之后执行。

description属性，是关于 target 的简短说明。

此外，还有其他几个未出现在构建文件中的属性。

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

unless属性，正好和 if属性相反，验证指定的属性是否存在，若存在，所在target将不会被执行。

extensionOf属性，添加当前 target 到 extension-point 依赖列表。——Ant1.8.0新特性。

extension-point 元素和 target 元素十分类似，都可以指定依赖的target。但是不同的是，extension-point 中不能包含任何 task。

请看以下实例：

<

target 

name

="create-directory-layout"

>

   ...

</

target

>

<

extension-point 

name

="ready-to-compile"

depends

="create-directory-layout"

/>

<

target 

name

="compile"

 depends

="ready-to-compile"

>

   ...

</

target

>

调用target顺序:  create-directory-layout --> 'empty slot' --> compile

<

target 

name

="generate-sources"

extensionOf

="ready-to-compile"

>

   ...

</

target

>

调用target顺序:  create-directory-layout --> generate-sources  --> compile

onMissingExtensionPoint属性：当无法找到一个extension-point时，target尝试去做的动作("fail", "warn", "ignore")。

——Ant1.8.2新特性。

 

 

3.3 Task 元素

task是一段可以被执行的代码。

一个task可以有多个属性， 一个属性可以包含对一个 property 的引用。

task的通常结构为

<

name 

attribute1

="value1"

 attribute2

="value2"

 ... 

/>

其中，name 是 task 的名字， attributeN 是属性名， valueN 是这个属性的值。

还是以 compile 做为例子：

<

target 

name

="compile"

 depends

="init"

 description

="compile the source "

 

>

    

<!--

 Compile the java code from ${src} into ${build} 

-->

    

<

javac 

srcdir

="${src}"

 destdir

="${build}"

/>

</

target

>

在 compile 这个 target 标签中包含了一个任务。

这个任务的动作是：执行JAVA编译，编译src下的代码，并把编译生成的文件放在build目录中。

常用task 

javac：用于编译一个或者多个Java源文件，通常需要srcdir和destdir两个属性，用于指定Java源文件的位置和编译后class文件的保存位置。

<

javac 

srcdir

="${src}"

 destdir

="${build}"

 classpath

="abc.jar"

 debug

="on"

 source

="1.7"

 

/>

java：用于运行某个Java类，通常需要classname属性，用于指定需要运行哪个类。

<

java 

classname

="test.Main"

>

    

<

arg 

value

="-h"

 

/>

    

<

classpath

>

        

<

pathelement 

location

="dist/test.jar"

 

/>

    

</

classpath

>

</

java

> 

jar：用于生成JAR包，通常需要指定destfile属性，用于指定所创建JAR包的文件名。除此之外，通常还应指定一个文件集，表明需要将哪些文件打包到JAR包里。

<

jar 

jarfile

="${dist}/lib/MyProject-${DSTAMP}.jar"

 basedir

="${build}"

/>

echo：输出某个字符串。

<

echo 

message

="Building to ${builddir}"

/>

<

echo

>You are using version ${java.version} 

of Java! This message spans two lines.

</

echo

>

copy：用于复制文件或路径。

<

copy 

todir

="${builddir}/srccopy"

>

    

<

fileset 

dir

="${srcdir}"

>

        

<

include 

name

="**/*.java"

/>

    

</

fileset

>

    

<

filterset

>

        

<

filter 

token

="VERSION"

 value

="${app.version}"

/>

    

</

filterset

>

</

copy

> 

delete：用于删除文件或路径。

<

delete 

file

="/lib/ant.jar"

 

/>

<

delete 

dir

="lib"

 

/>

<

delete

>

    

<

fileset 

dir

="."

 includes

="**/*.bak"

 

/>

</

delete

> 

mkdir：用于创建文件夹。

<

mkdir 

dir

="${dist}/lib"

 

/> 

move：用户移动文件和路径。

<

move 

todir

="some/new/dir"

>

    

<

fileset 

dir

="my/src/dir"

>

        

<

include 

name

="**/*.jar"

 

/>

        

<

exclude 

name

="**/ant.jar"

 

/>

    

</

fileset

>

</

move

> 

 

3.4 Property 元素

Property 是对参数的定义。

project的属性可以通过property元素来设定，也可在Ant之外设定。若要在外部引入某文件，例如build.properties文件，可以通过如下内容将其引入：<property file=” build.properties”/>。

property元素可用作 task 的属性值。在task中是通过将属性名放在“${”和“}”之间，并放在task属性值的位置来实现的。

例如 complile 例子中，使用了前面定义的 src 作为源目录。

<

javac 

srcdir

="${src}"

 destdir

="${build}"

/>

Ant提供了一些内置的属性，它能得到的系统属性的列表与Java文档中System.getPropertis()方法得到的属性一致，这些系统属性可参考sun网站的说明。

 

3.5 extension-point元素

和 target 元素十分类似，都可以指定依赖的target。但是不同的是，extension-point 中不能包含任何 task。——Ant1.8.0新增特性。

在 target元素中的例子里已提到过，不再赘述。

 

参考资料

[1] ant官方手册：http://ant.apache.org/manual/index.html

[2] http://www.blogjava.net/amigoxie/archive/2007/11/09/159413.html