ant入门-.pdf

第一章
Ant入门

你可能已经下载并安装了Ant，现在打算看一个例子来了解它是如何工作的。如
果是这样，那么这一章正是为你准备的。在此我们会介绍一个非常基本的构建文
件示例。其后将对Ant的命令行选项做全面的描述。如果你想先按部就班完成安
装过程，那么可以先跳到第二章，然后再来阅读这一章。

我们不打算在这一章中对构建文件的每一处细节都加以解释。请参见第三章中一
个更复杂的例子。

文件和目录

对于这个例子，我们先从如图1-1所示的目录和文件结构开始介绍。阴影框表示
文件，未加阴影的框表示目录。

注意：可以由本书网页下载此例，网址为http://www.oreilly.com/catalog/anttdg/。

Ant的构建文件build.xml位于工程的基目录中。这是一般情况，不过你完全可以
使用其他的文件名，或者将此构建文件放在其他的位置上。src目录包括了组织为
一种普通包结构的Java源代码。一般来说，这些源文件的内容并不重要。不过需
要指出，PersonTest.java是一个单元测试，生成的JAR文件中不包括此文件。
15
16第一章

工程基
目录

srcbuild.xml

com

oreillyAccount.java

samplePerson.java

PersonTest.java

图1-1：示例构建文件的起点

我们这个示例构建文件将使Ant创建一个目录树及一些文件，如图1-2虚线阴影
框中所示。它还会编译Java源代码、创建oreilly.jar并且提供一个“clean”目标
来删除所有生成的文件和目录。

下面来看使这一切成为可能的构建文件。

Ant的构建文件

Ant的构建文件是用XML编写的。例1-1显示了此例中完整的Ant构建文件。与
大多数实际应用中的构建文件相比，它要简单一些，但确实能够说明几乎每个
Java工程所需的一些核心概念。

例1-1：build.xml
<?xmlversion="1.0"?>

<!--build.xml-asimpleAntbuildfile-->
<projectname="SimpleBuildfile"default="compile"basedir=".">
Ant入门17

工程基
目录

srcbuild.xmlbuild

comlibclasses

oreillyAccount.javaoreilly.jarcom

samplePerson.javaAccount.classoreilly

PersonTest.javaPerson.classsample

PersonTest.class

图1-2：示例构建文件创建的目录和文件

<!--Thedirectorycontainingsourcecode-->
<propertyname="src.dir"value="src"/>

<!--Temporarybuilddirectories-->
<propertyname="build.dir"value="build"/>
<propertyname="build.classes"value="${build.dir}/classes"/>
<propertyname="build.lib"value="${build.dir}/lib"/>

<!--Targettocreatethebuilddirectoriespriortothe-->
<!--compiletarget.-->
<targetname="prepare">
<mkdirdir="${build.dir}"/>
<mkdirdir="${build.classes}"/>
<mkdirdir="${build.lib}"/>
</target>

<targetname="clean"description="Removesallgeneratedfiles.">
<deletedir="${build.dir}"/>
</target>
18第一章

<targetname="compile"depends="prepare"
description="Compilesallsourcecode.">
<javacsrcdir="${src.dir}"destdir="${build.classes}"/>
</target>

<targetname="jar"depends="compile"
description="Generatesoreilly.jarinthe'dist'directory.">
<!--ExcludeunittestsfromthefinalJARfile-->
<