1 Ant是什么？
Apache Ant 是一個基于 Java的生成工具。
生成工具在軟件開發(fā)中用來將源代碼和其他輸入文件轉(zhuǎn)換為可執(zhí)行文件的形式（也有可能轉(zhuǎn)換為可安裝的產(chǎn)品映像形式）。Ant是Java平臺下非常棒的批處理命令執(zhí)行程序，能非常方便地自動完成編譯，測試，打包，部署等等一系列任務，大大提高開發(fā)效率。如果你現(xiàn)在還沒有開始使用Ant，那就要趕快開始學習使用，使自己的開發(fā)水平上一個新臺階。

2 下載、安裝Ant
安裝Ant
下載.zip文件，解壓縮到c:\ant1.3(后面引用為%ANT_HOME%)

2.1 在你運行Ant之前需要做一些配置工作。
? 將bin目錄加入PATH環(huán)境變量。
? 設(shè)定ANT_HOME環(huán)境變量，指向你安裝Ant的目錄。在一些OS上，Ant的腳本可以猜測ANT_HOME（Unix和Windos NT/2000）－但最好不要依賴這一特性。
? 可選地，設(shè)定J***A_HOME環(huán)境變量（參考下面的高級小節(jié)），該變量應該指向你安裝JDK的目錄。
注意：不要將Ant的ant.jar文件放到JDK/JRE的lib/ext目錄下。Ant是個應用程序，而lib/ext目錄是為JDK擴展使用的（如JCE，JSSE擴展）。而且通過擴展裝入的類會有安全方面的限制。
2.2 運行Ant

運行Ant非常簡單，當你正確地安裝Ant后，只要輸入ant就可以了。

? 沒有指定任何參數(shù)時，Ant會在當前目錄下查詢build.xml文件。如果找到了就用該文件作為buildfile。如果你用 -find 選項。Ant就會在上級目錄中尋找buildfile，直至到達文件系統(tǒng)的根。要想讓Ant使用其他的buildfile，可以用參數(shù) -buildfile file，這里file指定了你想使用的buildfile。

? 可以指定執(zhí)行一個或多個target。當省略target時，Ant使用標簽<project>的default屬性所指定的target。


命令行選項總結(jié)：
ant [options] [target [target2 [target3] ...]]
Options:
-help print this message
-projecthelp print project help information
-version print the version information and exit
-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，執(zhí)行缺省的target。
ant -buildfile test.xml dist
使用當前目錄下的test.xml運行Ant，執(zhí)行一個叫做dist的target。
ant -buildfile test.xml -Dbuild=build/classes dist
使用當前目錄下的test.xml運行Ant，執(zhí)行一個叫做dist的target，并設(shè)定build屬性的值為build/classes。

3 編寫build.xml

Ant的buildfile是用XML寫的。每個buildfile含有一個project。

buildfile中每個task元素可以有一個id屬性，可以用這個id值引用指定的任務。這個值必須是唯一的。（詳情請參考下面的Task小節(jié)）

3.1 Projects

project有下面的屬性：
Attribute Description Required
name 項目名稱. No
default 當沒有指定target時使用的缺省target Yes
basedir 用于計算所有其他路徑的基路徑。該屬性可以被basedir property覆蓋。當覆蓋時，該屬性被忽略。如果屬性和basedir property都沒有設(shè)定，就使用buildfile文件的父目錄。 No
項目的描述以一個頂級的<description>元素的形式出現(xiàn)（參看description小節(jié)）。

一個項目可以定義一個或多個target。一個target是一系列你想要執(zhí)行的。執(zhí)行Ant時，你可以選擇執(zhí)行那個target。當沒有給定target時，使用project的default屬性所確定的target。

3.2 Targets

一個target可以依賴于其他的target。例如，你可能會有一個target用于編譯程序，一個target用于生成可執(zhí)行文件。你在生成可執(zhí)行文件之前必須先編譯通過，所以生成可執(zhí)行文件的target依賴于編譯target。Ant會處理這種依賴關(guān)系。

然而，應當注意到，Ant的depends屬性只指定了target應該被執(zhí)行的順序－如果被依賴的target無法運行，這種depends對于指定了依賴關(guān)系的target就沒有影響。

Ant會依照depends屬性中target出現(xiàn)的順序（從左到右）依次執(zhí)行每個target。然而，要記住的是只要某個target依賴于一個target，后者就會被先執(zhí)行。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
假定我們要執(zhí)行target D。從它的依賴屬性來看，你可能認為先執(zhí)行C，然后B，最后A被執(zhí)行。錯了，C依賴于B，B依賴于A，所以先執(zhí)行A，然后B，然后C，最后D被執(zhí)行。

一個target只能被執(zhí)行一次，即時有多個target依賴于它（看上面的例子）。

如果（或如果不）某些屬性被設(shè)定，才執(zhí)行某個target。這樣，允許根據(jù)系統(tǒng)的狀態(tài)（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總會被執(zhí)行。

可選的description屬性可用來提供關(guān)于target的一行描述，這些描述可由-projecthelp命令行選項輸出。

將你的tstamp task在一個所謂的初始化target是很好的做法，其他的target依賴這個初始化target。要確保初始化target是出現(xiàn)在其他target依賴表中的第一個target。在本手冊中大多數(shù)的初始化target的名字是"init"。

target有下面的屬性：
Attribute Description Required
name target的名字 Yes
depends 用逗號分隔的target的名字列表，也就是依賴表。 No
if 執(zhí)行target所需要設(shè)定的屬性名。 No
unless 執(zhí)行target需要清除設(shè)定的屬性名。 No
description 關(guān)于target功能的簡短描述。 No

3.3 Tasks

一個task是一段可執(zhí)行的代碼。

一個task可以有多個屬性（如果你愿意的話，可以將其稱之為變量）。屬性只可能包含對property的引用。這些引用會在task執(zhí)行前被解析。

下面是Task的一般構(gòu)造形式：
<name attribute1="value1" attribute2="value2" ... />
這里name是task的名字，attributeN是屬性名，valueN是屬性值。

有一套內(nèi)置的（built-in）task，以及一些可選task，但你也可以編寫自己的task。

所有的task都有一個task名字屬性。Ant用屬性值來產(chǎn)生日志信息。

可以給task賦一個id屬性：
<taskname id="taskID" ... />
這里taskname是task的名字，而taskID是這個task的唯一標識符。通過這個標識符，你可以在腳本中引用相應的task。例如，在腳本中你可以這樣：
<script ... >
task1.setFoo("bar");
</script>
設(shè)定某個task實例的foo屬性。在另一個task中（用java編寫），你可以利用下面的語句存取相應的實例。
project.getReference("task1").
注意1：如果task1還沒有運行，就不會被生效（例如：不設(shè)定屬性），如果你在隨后配置它，你所作的一切都會被覆蓋。

注意2：未來的Ant版本可能不會兼容這里所提的屬性，因為很有可能根本沒有task實例，只有proxies。

3.4 Properties

一個project可以有很多的properties。可以在buildfile中用property task來設(shè)定，或在Ant之外設(shè)定。一個property有一個名字和一個值。property可用于task的屬性值。這是通過將屬性名放在"${"和"}"之間并放在屬性值的位置來實現(xiàn)的。例如如果有一個property builddir的值是"build"，這個property就可用于屬性值：${builddir}/classes。這個值就可被解析為build/classes。

內(nèi)置屬性

如果你使用了<property> task 定義了所有的系統(tǒng)屬性，Ant允許你使用這些屬性。例如，${os.name}對應操作系統(tǒng)的名字。

要想得到系統(tǒng)屬性的列表可參考the Javadoc of System.getProperties。

除了Java的系統(tǒng)屬性，Ant還定義了一些自己的內(nèi)置屬性：
basedir project基目錄的絕對路徑 (與<project>的basedir屬性一樣)。
ant.file buildfile的絕對路徑。
ant.version Ant的版本。
ant.project.name 當前執(zhí)行的project的名字；由<project>的name屬性設(shè)定.
ant.java.version Ant檢測到的JVM的版本； 目前的值有"1.1", "1.2", "1.3" and "1.4".

例子
<project name="MyProject" default="dist" basedir=".">

<!-- set global properties for this build -->
<property name="src" value="."/>
<property name="build" value="build"/>
<property name="dist" value="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">
<!-- Compile the java code from ${src} into ${build} -->
<javac srcdir="${src}" destdir="${build}"/>
</target>

<target name="dist" depends="compile">
<!-- 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">
<!-- Delete the ${build} and ${dist} directory trees -->
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>

</project>

3.5 Path-like Structures
你可以用":"和";"作為分隔符，指定類似PATH和CLASSPATH的引用。Ant會把分隔符轉(zhuǎn)換為當前系統(tǒng)所用的分隔符。

當需要指定類似路徑的值時，可以使用嵌套元素。一般的形式是
<classpath>
<pathelement path="${classpath}"/>
<pathelement location="lib/helper.jar"/>
</classpath>
location屬性指定了相對于project基目錄的一個文件和目錄，而path屬性接受逗號或分號分隔的一個位置列表。path屬性一般用作預定義的路徑－－其他情況下，應該用多個location屬性。

為簡潔起見，classpath標簽支持自己的path和location屬性。所以：
<classpath>
<pathelement path="${classpath}"/>
</classpath>
可以被簡寫作：
<classpath path="${classpath}"/>
也可通過<fileset>元素指定路徑。構(gòu)成一個fileset的多個文件加入path-like structure的順序是未定的。
<classpath>
<pathelement path="${classpath}"/>
<fileset dir="lib">
<include name="**/*.jar"/>
</fileset>
<pathelement location="classes"/>
</classpath>
上面的例子構(gòu)造了一個路徑值包括：${classpath}的路徑，跟著lib目錄下的所有jar文件，接著是classes目錄。

如果你想在多個task中使用相同的path-like structure，你可以用<path>元素定義他們（與target同級），然后通過id屬性引用－－參考Referencs例子。

path-like structure可能包括對另一個path-like structurede的引用（通過嵌套<path>元素）：
<path id="base.path">
<pathelement path="${classpath}"/>
<fileset dir="lib">
<include name="**/*.jar"/>
</fileset>
<pathelement location="classes"/>
</path>
<path id="tests.path">
<path refid="base.path"/>
<pathelement location="testclasses"/>
</path>
前面所提的關(guān)于<classpath>的簡潔寫法對于<path>也是有效的，如：
<path id="tests.path">
<path refid="base.path"/>
<pathelement location="testclasses"/>
</path>
可寫成：
<path id="base.path" path="${classpath}"/>
命令行變量

有些task可接受參數(shù)，并將其傳遞給另一個進程。為了能在變量中包含空格字符，可使用嵌套的arg元素。
Attribute Description Required
value 一個命令行變量；可包含空格字符。 只能用一個
line 空格分隔的命令行變量列表。
file 作為命令行變量的文件名；會被文件的絕對名替代。
path 一個作為單個命令行變量的path-like的字符串；或作為分隔符，Ant會將其轉(zhuǎn)變?yōu)樘囟ㄆ脚_的分隔符。

例子
<arg value="-l -a"/>
是一個含有空格的單個的命令行變量。
<arg line="-l -a"/>
是兩個空格分隔的命令行變量。
<arg path="/dir;/dir2:\dir3"/>
是一個命令行變量，其值在DOS系統(tǒng)上為\dir;\dir2;\dir3；在Unix系統(tǒng)上為/dir:/dir2:/dir3 。

References

buildfile元素的id屬性可用來引用這些元素。如果你需要一遍遍的復制相同的XML代碼塊，這一屬性就很有用－－如多次使用<classpath>結(jié)構(gòu)。

下面的例子：
<project ... >
<target ... >
<rmic ...>
<classpath>
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</classpath>
</rmic>
</target>
<target ... >
<javac ...>
<classpath>
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</classpath>
</javac>
</target>
</project>
可以寫成如下形式：
<project ... >
<path id="project.class.path">
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</path>
<target ... >
<rmic ...>
<classpath refid="project.class.path"/>
</rmic>
</target>
<target ... >
<javac ...>
<classpath refid="project.class.path"/>
</javac>
</target>
</project>
所有使用PatternSets, FileSets 或 path-like structures嵌套元素的task也接受這種類型的引用。

4.1 File（Directory）類
4.1.1 Mkdir
? 創(chuàng)建一個目錄，如果他的父目錄不存在，也會被同時創(chuàng)建。
? 例子：
<mkdir dir="build/classes"/>
? 說明： 如果build不存在，也會被同時創(chuàng)建
4.1.2 Copy
? 拷貝一個（組）文件、目錄
? 例子：
1. 拷貝單個的文件：
<copy file="myfile.txt" tofile="mycopy.txt"/>
2. 拷貝單個的文件到指定目錄下
<copy file="myfile.txt" todir="../some/other/dir"/>
3. 拷貝一個目錄到另外一個目錄下
<copy todir="../new/dir">
<fileset dir="src_dir"/>
</copy>
4. 拷貝一批文件到指定目錄下
<copy todir="../dest/dir">
<fileset dir="src_dir">
<exclude name="**/*.java"/>
</fileset>
</copy>

<copy todir="../dest/dir">
<fileset dir="src_dir" excludes="**/*.java"/>
</copy>
5. 拷貝一批文件到指定目錄下，將文件名后增加。Bak后綴
<copy todir="../backup/dir">
<fileset dir="src_dir"/>
<mapper type="glob" from="*" to="*.bak"/>
</copy>
6. 拷貝一組文件到指定目錄下，替換其中的@標簽@內(nèi)容
<copy todir="../backup/dir">
<fileset dir="src_dir"/>
<filterset>
<filter token="TITLE" value="Foo Bar"/>
</filterset>
</copy>
4.1.3 Delete
? 刪除一個（組）文件或者目錄
? 例子
1. 刪除一個文件
<delete file="/lib/ant.jar"/>
2. 刪除指定目錄及其子目錄
<delete dir="lib"/>
3. 刪除指定的一組文件
<delete>
<fileset dir="." includes="**/*.bak"/>
</delete>
4. 刪除指定目錄及其子目錄，包括他自己
<delete includeEmptyDirs="true">
<fileset dir="build"/>
</delete>
4.1.4 Move
? 移動或重命名一個（組）文件、目錄
? 例子：
1. 移動或重命名一個文件
<move file="file.orig" tofile="file.moved"/>
2. 移動或重命名一個文件到另一個文件夾下面
<move file="file.orig" todir="dir/to/move/to"/>
3. 將一個目錄移到另外一個目錄下
<move todir="new/dir/to/move/to">
<fileset dir="src/dir"/>
</move>
4. 將一組文件移動到另外的目錄下
<move todir="some/new/dir">
<fileset dir="my/src/dir">
<include name="**/*.jar"/>
<exclude name="**/ant.jar"/>
</fileset>
</move>
5. 移動文件過程中增加。Bak后綴
<move todir="my/src/dir">
<fileset dir="my/src/dir">
<exclude name="**/*.bak"/>
</fileset>
<mapper type="glob" from="*" to="*.bak"/>
</move>
4.2 Java相關(guān)
4.2.1 Javac
? 編譯java原代碼
? 例子
1. <javac srcdir="${src}"
destdir="${build}"
classpath="xyz.jar"
debug="on"
/>
編譯${src}目錄及其子目錄下的所有。Java文件，。Class文件將放在$｛build｝指定的目錄下，classpath表示需要用到的類文件或者目錄，debug設(shè)置為on表示輸出debug信息
2. <javac srcdir="${src}:${src2}"
destdir="${build}"
includes="mypackage/p1/**,mypackage/p2/**"
excludes="mypackage/p1/testpackage/**"
classpath="xyz.jar"
debug="on"
/>
編譯${src}和${src2}目錄及其子目錄下的所有。Java文件，但是package/p1/**,mypackage/p2/**將被編譯，而mypackage/p1/testpackage/**將不會被編譯。Class文件將放在$｛build｝指定的目錄下，classpath表示需要用到的類文件或者目錄，debug設(shè)置為on表示輸出debug信息
3. <property name="classpath" value=".;./xml-apis.jar;../lib/xbean.jar;./easypo.jar"/>

<javac srcdir="${src}"
destdir="${src}"
classpath="${classpath}"
debug="on"
/>
路徑是在property中定義的
4.2.2 java
? 執(zhí)行指定的java類
? 例子：
1. <java classname="test.Main">
<classpath>
<pathelement location="dist/test.jar"/>
<pathelement path="${java.class.path}"/>
</classpath>
</java>
classname中指定要執(zhí)行的類，classpath設(shè)定要使用的環(huán)境變量
2. <path id="project.class.path">
<pathelement location="lib/"/>
<pathelement path="${java.class.path}/"/>
<pathelement path="${additional.path}"/>
</path>

<target ... >
<rmic ...>
<classpath refid="project.class.path"/>
</rmic>
</target>
4.3 打包相關(guān)
4.3.1 jar
? 將一組文件打包
? 例子：
1. <jar destfile="${dist}/lib/app.jar" basedir="${build}/classes"/>
將${build}/classes下面的所有文件打包到${dist}/lib/app.jar中
2. <jar destfile="${dist}/lib/app.jar"
basedir="${build}/classes"
includes="mypackage/test/**"
excludes="**/Test.class"
/>
將${build}/classes下面的所有文件打包到${dist}/lib/app.jar中，但是包括mypackage/test／所有文件不包括所有的Test.class
3. <jar destfile="${dist}/lib/app.jar"
basedir="${build}/classes"
includes="mypackage/test/**"
excludes="**/Test.class"
manifest=”my.mf”
/>
manifest屬性指定自己的META-INF/MANIFEST.MF文件，而不是由系統(tǒng)生成
4.3.2 war
? 對Jar的擴展，用于打包Web應用
? 例子：
? 假設(shè)我們的文件目錄如下：
thirdparty/libs/jdbc1.jar
thirdparty/libs/jdbc2.jar
build/main/com/myco/myapp/Servlet.class
src/metadata/myapp.xml
src/html/myapp/index.html
src/jsp/myapp/front.jsp
src/graphics/images/gifs/small/logo.gif
src/graphics/images/gifs/large/logo.gif
? 下面是我們的任務的內(nèi)容：
<war destfile="myapp.war" webxml="src/metadata/myapp.xml">
<fileset dir="src/html/myapp"/>
<fileset dir="src/jsp/myapp"/>
<lib dir="thirdparty/libs">
<exclude name="jdbc1.jar"/>
</lib>
<classes dir="build/main"/>
<zipfileset dir="src/graphics/images/gifs"
prefix="images"/>
</war>
? 完成后的結(jié)果：
WEB-INF/web.xml
WEB-INF/lib/jdbc2.jar
WEB-INF/classes/com/myco/myapp/Servlet.class
META-INF/MANIFEST.MF
index.html
front.jsp
images/small/logo.gif
images/large/logo.gif
4.3.3 ear
? 用于打包企業(yè)應用
? 例子
<ear destfile="${build.dir}/myapp.ear" appxml="${src.dir}/metadata/application.xml">
<fileset dir="${build.dir}" includes="*.jar,*.war"/>
</ear>
4.4 時間戳
在生成環(huán)境中使用當前時間和日期，以某種方式標記某個生成任務的輸出，以便記錄它是何時生成的，這經(jīng)常是可取的。這可能涉及編輯一個文件，以便插入一個字符串來指定日期和時間，或?qū)⑦@個信息合并到 JAR 或 zip 文件的文件名中。
這種需要是通過簡單但是非常有用的 tstamp 任務來解決的。這個任務通常在某次生成過程開始時調(diào)用，比如在一個 init 目標中。這個任務不需要屬性，許多情況下只需 <tstamp/> 就足夠了。
tstamp 不產(chǎn)生任何輸出；相反，它根據(jù)當前系統(tǒng)時間和日期設(shè)置 Ant 屬性。下面是 tstamp 設(shè)置的一些屬性、對每個屬性的說明，以及這些屬性可被設(shè)置到的值的例子：
屬性 說明 例子
DSTAMP 設(shè)置為當前日期，默認格式為yyyymmdd 20031217
TSTAMP 設(shè)置為當前時間，默認格式為 hhmm 1603
TODAY 設(shè)置為當前日期，帶完整的月份 2003 年 12 月 17 日
例如，在前一小節(jié)中，我們按如下方式創(chuàng)建了一個 JAR 文件：

<jar destfile="package.jar" basedir="classes"/>

在調(diào)用 tstamp 任務之后，我們能夠根據(jù)日期命名該 JAR 文件，如下所示：

<jar destfile="package-${DSTAMP}.jar" basedir="classes"/>

因此，如果這個任務在 2003 年 12 月 17 日調(diào)用，該 JAR 文件將被命名為 package-20031217.jar。
還可以配置 tstamp 任務來設(shè)置不同的屬性，應用一個當前時間之前或之后的時間偏移，或以不同的方式格式化該字符串。所有這些都是使用一個嵌套的 format 元素來完成的，如下所示：

<tstamp>
<format property="OFFSET_TIME"
pattern="HH:mm:ss"
offset="10" unit="minute"/>
</tstamp>

上面的清單將 OFFSET_TIME 屬性設(shè)置為距離當前時間 10 分鐘之后的小時數(shù)、分鐘數(shù)和秒數(shù)。
用于定義格式字符串的字符與 java.text.SimpleDateFormat 類所定義的那些格式字符相同
4.5 執(zhí)行SQL語句
? 通過jdbc執(zhí)行SQL語句
? 例子：
1. <sql
driver="org.gjt.mm.mysql.Driver"
url="jdbc:mysql://localhost:3306/mydb"
userid="root"
password="root"
src="/data.sql"
/>
2. <sql
driver="org.database.jdbcDriver"
url="jdbc:database-url"
userid="sa"
password="pass"
src="/data.sql"
rdbms="oracle"
version="8.1."
>
</sql>
只有在oracle、版本是8.1的時候才執(zhí)行
4.6 發(fā)送郵件
? 使用SMTP服務器發(fā)送郵件
? 例子：
<mail mailhost="smtp.myisp.com" mailport="1025" subject="Test build">
<from address="me@myisp.com"/>
<to address="all@xyz.com"/>
<message>The ${buildname} nightly build has completed</message>
<fileset dir="dist">
<includes name="**/*.zip"/>
</fileset>
</mail>
? mailhost： SMTP服務器地址
? mailport： 服務器端口
? subject： 主題
? from： 發(fā)送人地址
? to： 接受人地址
? message： 發(fā)送的消息
? fileset： 設(shè)置附件
－－－－－－－－－－

?在Eclipse中使用Ant

Eclipse中已經(jīng)集成了Ant，我們可以直接在Eclipse中運行Ant。

以前面建立的Hello工程為例，創(chuàng)建以下目錄結(jié)構(gòu)：


?
新建一個build.xml，放在工程根目錄下。build.xml定義了Ant要執(zhí)行的批處理命令。雖然Ant也可以使用其它文件名，但是遵循標準能更使開發(fā)更規(guī)范，同時易于與別人交流。

通常，src存放Java源文件，classes存放編譯后的class文件，lib存放編譯和運行用到的所有jar文件，web存放JSP等web文件，dist存放打包后的jar文件，doc存放API文檔。

然后在根目錄下創(chuàng)建build.xml文件，輸入以下內(nèi)容：

?1 <? xml?version = " 1.0 " ?>
?2 < project?name = " Hello?world " ? default = " doc " > ?
?3
?4 ? <!-- ?properies? -->
?5 ???? < property?name = " src.dir " ?value = " src " ? />
?6 ???? < property?name = " report.dir " ?value = " report " ? />
?7 ???? < property?name = " classes.dir " ?value = " classes " ? />
?8 ???? < property?name = " lib.dir " ?value = " lib " ? />
?9 ???? < property?name = " dist.dir " ?value = " dist " ? />
10 ? < property?name = " doc.dir " ?value = " doc " /> ?
11
12 ???? <!-- ?定義classpath? -->
13 ???? < path?id = " master-classpath " >
14 ???????? < fileset?file = " ${lib.dir}/*.jar " ? />
15 ???????? < pathelement?path = " ${classes.dir} " />
16 ???? </ path > ?
17
18 ???? <!-- ?初始化任務? -->
19 ???? < target?name = " init " >
20 ???? </ target > ?
21
22 ???? <!-- ?編譯? -->
23 ???? < target?name = " compile " ?depends = " init " ?description = " compile?the?source?files " >
24 ???????? < mkdir?dir = " ${classes.dir} " />
25 ???????? < javac?srcdir = " ${src.dir} " ?destdir = " ${classes.dir} " ?target = " 1.4 " >
26 ???????????? < classpath?refid = " master-classpath " />
27 ???????? </ javac >
28 ???? </ target > ?
29
30 ???? <!-- ?測試? -->
31 ???? < target?name = " test " ?depends = " compile " ?description = " run?junit?test " >
32 ???????? < mkdir?dir = " ${report.dir} " />
33 ???????? < junit?printsummary = " on "
34 ????????????????haltonfailure = " false "
35 ????????????????failureproperty = " tests.failed "
36 ????????????????showoutput = " true " >
37 ???????????? < classpath?refid = " master-classpath " ? />
38 ???????????? < formatter?type = " plain " />
39 ???????????? < batchtest?todir = " ${report.dir} " >
40 ???????????????? < fileset?dir = " ${classes.dir} " >
41 ???????????????????? < include?name = " **/*Test.* " />
42 ???????????????? </ fileset >
43 ???????????? </ batchtest >
44 ???????? </ junit >
45 ???????? < fail? if = " tests.failed " >
46 ???????? ***********************************************************
47 ???????? **** ??One?or?more?tests?failed ! ??Check?the?output??? ****
48 ???????? ***********************************************************
49 ???????? </ fail >
50 ???? </ target > ?
51
52 ???? <!-- ?打包成jar? -->
53 ???? < target?name = " pack " ?depends = " test " ?description = " make?.jar?file " >
54 ????? < mkdir?dir = " ${dist.dir} " ? />
55 ???????? < jar?destfile = " ${dist.dir}/hello.jar " ?basedir = " ${classes.dir} " >
56 ???????????? < exclude?name = " **/*Test.* " ? />
57 ???????????? < exclude?name = " **/Test*.* " ? />
58 ???????? </ jar >
59 ???? </ target > ?
60
61 ???? <!-- ?輸出api文檔? -->
62 ???? < target?name = " doc " ?depends = " pack " ?description = " create?api?doc " >
63 ????? < mkdir?dir = " ${doc.dir} " ? />
64 ????? < javadoc?destdir = " ${doc.dir} "
65 ????????????author = " true "
66 ????????????version = " true "
67 ????????????use = " true "
68 ????????????windowtitle = " Test?API " >
69 ???????????? < packageset?dir = " ${src.dir} " ?defaultexcludes = " yes " >
70 ???????????????? < include?name = " example/** " ? />
71 ???????????? </ packageset >
72 ???????????? < doctitle ><! [CDATA[ < h1 > Hello,?test </ h1 > ]] ></ doctitle >
73 ???????????? < bottom ><! [CDATA[ < i > All?Rights?Reserved. </ i > ]] ></ bottom >
74 ???????????? < tag?name = " todo " ?scope = " all " ?description = " To?do: " ? />
75 ???????? </ javadoc >
76 ???? </ target >
77 </ project > ?
78
79

以上xml依次定義了init（初始化），compile（編譯），test（測試），doc（生成文檔），pack（打包）任務，可以作為模板。

選中Hello工程，然后選擇“Project”，“Properties”，“Builders”，“New…”，選擇“Ant Build”：

填入Name：Ant_Builder；Buildfile：build.xml；Base Directory：${workspace_loc:/Hello}（按“Browse Workspace”選擇工程根目錄），由于用到了junit.jar包，搜索Eclipse目錄，找到j(luò)unit.jar，把它復制到Hello/lib目錄下，并添加到Ant的Classpath中：

然后在Builder面板中鉤上Ant_Build，去掉Java Builder：
?

再次編譯，即可在控制臺看到Ant的輸出：

Buildfile: F:\eclipse-projects\Hello\build.xml

init:

compile:
?????? [mkdir] Created dir: F:\eclipse-projects\Hello\classes
?????? [javac] Compiling 2 source files to F:\eclipse-projects\Hello\classes

test:
?????? [mkdir] Created dir: F:\eclipse-projects\Hello\report
?????? [junit] Running example.HelloTest
?????? [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 0.02 sec

pack:
?????? [mkdir] Created dir: F:\eclipse-projects\Hello\dist
???????? [jar] Building jar: F:\eclipse-projects\Hello\dist\hello.jar

doc:
?????? [mkdir] Created dir: F:\eclipse-projects\Hello\doc
???? [javadoc] Generating Javadoc
???? [javadoc] Javadoc execution
???? [javadoc] Loading source files for package example...
???? [javadoc] Constructing Javadoc information...
???? [javadoc] Standard Doclet version 1.4.2_04
???? [javadoc] Building tree for all the packages and classes...
???? [javadoc] Building index for all the packages and classes...
???? [javadoc] Building index for all classes...
???? [javadoc] Generating F:\eclipse-projects\Hello\doc\stylesheet.css...
???? [javadoc] Note: Custom tags that could override future standard tags:? @todo. To avoid potential overrides, use at least one period character (.) in custom tag names.
???? [javadoc] Note: Custom tags that were not seen:? @todo
BUILD SUCCESSFUL
Total time: 11 seconds

Ant依次執(zhí)行初始化，編譯，測試，打包，生成API文檔一系列任務，極大地提高了開發(fā)效率。將來開發(fā)J2EE項目時，還可加入部署等任務。并且，即使脫離了Eclipse環(huán)境，只要正確安裝了Ant，配置好環(huán)境變量ANT_HOME=<Ant解壓目錄>，Path=…;%ANT_HOME%\bin，在命令行提示符下切換到Hello目錄，簡單地鍵入ant即可。

?