<jar destfile="dist/project.jar" basedir="build/classes"/>
<ftp server="
" userid="
" password="
">
<fileset dir="dist"/>
</ftp>
</target>
</project>
該構(gòu)建過程如下：
系統(tǒng)初始化1、編譯 2、生成JAVADOC 4、打包 5、上傳到FTP，其中后兩步結(jié)合到一起叫部署。
執(zhí)行時輸出如下：
> ant -propertyfile ftp.properties
Buildfile: build.xml
init:
[mkdir] Created dir: /home/ant/Projects/OurProject/build/classes
[mkdir] Created dir: /home/ant/Projects/OurProject/dist
compile:
[javac] Compiling 1 source file to /home/ant/Projects/OurProject/build/
classes
doc:
[javadoc] Generating Javadoc
[javadoc] Javadoc execution
[javadoc] Loading source files for package org.example.antbook.lesson1...
[javadoc] Constructing Javadoc information...
[javadoc] Building tree for all the packages and classes...
[javadoc] Building index for all the packages and classes...
[javadoc] Building index for all classes...
deploy:
[jar] Building jar: /home/ant/Projects/OurProject/dist/project.jar
[ftp] sending files
[ftp] 1 files sent
BUILD SUCCESSFUL
Total time: 5 seconds.
在執(zhí)行時使用命令行參數(shù)以傳入一個屬性文件，屬性文件中包含連接FTP服務(wù)器使用的服務(wù)器名，用戶名，用戶密碼來給特性使用。
這個例子很好的展示了Ant的一些基本要素：目標(biāo)依賴、特性的使用、編譯、文檔生成、JAR打包（tar,Zip,WAR,EAR等），最后是部署。
Ant的簡單任務(wù)(<mkdir>)都是由Java類庫來實(shí)現(xiàn)相應(yīng)的功能。而一些復(fù)雜的任務(wù)<ftp>、<junit>還需要第三方庫的支持。
Ant的一個強(qiáng)大之處：它總能工作。只要正確的指定構(gòu)建文件，Ant就能計算出目標(biāo)的依賴性，并且按照正確的順序調(diào)用目標(biāo)。目標(biāo)通過任務(wù)按序執(zhí)行，而任務(wù)自身處理其文件依賴性以及實(shí)際的操作來完成工作。因?yàn)槊總€任務(wù)通常都是在高層陳述，所以一兩行XML語句經(jīng)常就已經(jīng)足夠描述任務(wù)的內(nèi)容。
4. 下載并安裝Ant
使用Ant前提條件，系統(tǒng)中已經(jīng)安裝JDK以及Ant。在文檔編寫之時，Ant的最新版本是Ant 1.7,但是為了穩(wěn)定性，本文檔使用版本為Ant 1.6.5.
其次，解壓縮文件，放到指定的系統(tǒng)目錄中，例如C:\Ant。
再次，將其添加到path，以便從命令行使用。(一些IDE，例如Eclipse可以不需要設(shè)置path,而通過IDE相關(guān)設(shè)置將Ant添加到path中。)
再次，設(shè)置一些環(huán)境變量指向JDK以及ANT。
最后，添加需要的可選庫。
在Windows安裝過程（以筆者的安裝過程為例）
下載apache-ant-1.6.5-bin.zip到本地硬盤，解壓縮之后將文件夾命名為Ant,放在C:\Ant中。這個目錄就是Ant主目錄。
應(yīng)該將主目錄中的bin目錄添加到path屬性中，這樣就可以在命令行中調(diào)用ant命令，ANT_HOME是批處理文件所在目錄的上級目錄。最好明確設(shè)定。
現(xiàn)在許多工具已經(jīng)集成了特定版本的Ant，一些操作系統(tǒng)甚至默認(rèn)的已經(jīng)安裝了Ant。所以，你的系統(tǒng)中可能已經(jīng)安裝了Ant。
首先可以通過運(yùn)行以下命令：
ant -version
和
ant -diagnostics
來確定。我們推薦您不設(shè)置CLASSPATH來運(yùn)行Ant命令。如果任何版本的Ant可以從CLASSPATH加載 ，這時就會由于加載了不兼容的類而產(chǎn)生許多錯誤。
一些其他問題請參閱Ant的FAQ設(shè)置。
正常情況下，執(zhí)行ant ?Cversion即可顯示Ant版本，則說明安裝配制成功：
5. 運(yùn)行第一個構(gòu)建文件：
首先創(chuàng)建一個Java工程，名為AntProject，工程中源文件和目標(biāo)文件是分開的，分別為文件夾src和bin,然后創(chuàng)建一個Java類文件，類名為
com.neusoft.test.AntTest，只是為了測試，所以類的內(nèi)容很簡單：
package com.neusoft.test;
/**
*This is just a test class.
*/
public class AntTest{
public static void main(String[] args){
for(int i=0;i<args.length;i++){
System.out.println(args[i]);
}
}
}
然后我們在工程的路徑下面建立一個構(gòu)建文件build.xml，內(nèi)容如下：
<?xml version="1.0" ?>
<project name="structured" default="archive" >
<target name="init">
<mkdir dir="build/classes" />
<mkdir dir="dist" />
</target>
<target name="compile" depends="init" >
<javac srcdir="src" destdir="build/classes"/>
</target>
<target name="archive" depends="compile" >
<jar destfile="dist/project.jar"
basedir="build/classes" />
</target>
<target name="clean" depends="init">
<delete dir="build" />
<delete dir="dist" />
</target>
</project>
構(gòu)建文件說明如下圖：
關(guān)于XML的知識，請參考其他書籍，這里不做介紹。
以上創(chuàng)建完成后，目錄結(jié)構(gòu)如下圖：
Ant構(gòu)建文件總是有一個<project>元素做為根元素，它有兩個屬性，name和default，<target>元素是<project>元素的子元素，可以有多個，它有兩個屬性，name和depends，<target>元素包含的元素就是一些任務(wù)元素。
<target>可以由命令行進(jìn)行顯示的調(diào)用，也可以在內(nèi)部使用如可以直接調(diào)用ant init、ant compile等。如果不寫參數(shù)，則默認(rèn)的build文件是build.xml，默認(rèn)的目標(biāo)是<project>的default屬性定義的目標(biāo)。目標(biāo)的名稱是唯一的，可以是任意字符串。
下面我們先運(yùn)行一下這個Ant構(gòu)建，再講解其他的內(nèi)容，進(jìn)入工程目錄，執(zhí)行
ant
這里就相當(dāng)于執(zhí)行默認(rèn)的目標(biāo)，也就是<project name="structured" default="archive" >中的archive目標(biāo)。
這里說明了首先初始化創(chuàng)建兩個目錄，然后編譯了一個JAVA文件，然后進(jìn)行了打包的操作。
這里講解一下如果構(gòu)建失敗了怎么辦？
首先有可能是XML語法書寫不正確(將<target>寫成<targe>)，或者在任務(wù)執(zhí)行過程中出現(xiàn)了錯誤(.java文件中包含編譯錯誤)，或者任務(wù)名稱書寫錯誤(將<javac>寫成<javacc>)等等，這些都不是Ant的錯誤，不需要填寫B(tài)ug Report。寫XML時一定要細(xì)心，一些IDE已經(jīng)有驗(yàn)證功能，可以很好的防止書寫的錯誤。
出現(xiàn)錯誤時，可以使用
ant ?Cverbose
或者
ant ?Cdebug來獲取更加詳細(xì)的構(gòu)建信息，以解決問題。
下圖是使用ant ?Cverbose時的輸出，使用ant ?Cdebug將獲取比這更詳細(xì)的信息，這里就不舉例了。
本例中直接使用了軟件工程中的構(gòu)建結(jié)構(gòu)，使用src作為源文件目錄，build/class作為中間生成文件，以dist作為可發(fā)布文件。在最后把一些可執(zhí)行文件可以放在bin目錄中。此時目錄結(jié)構(gòu)如下圖所示：
我們需要一種辦法來確定某些任務(wù)先執(zhí)行，而有些任務(wù)后執(zhí)行，比如必須先編譯，才能執(zhí)行程序或者打包。我們在聲明目標(biāo)的時候，就在其依賴屬性中列出其依賴關(guān)系：
<target name="compile" depends="init" >
<target name="archive" depends="compile" >
<target name="clean" depends="init">
如果一個目標(biāo)依賴與多個其他目標(biāo)，需要將它們都寫到依賴屬性中，例如：
depents=”compile,test”。在我們的構(gòu)建中，archive依賴于init和compile，但是我們不需要去寫，因?yàn)閏ompile已經(jīng)依賴于init了。即：Ant的依賴關(guān)系是傳遞的，但不是自反的。
如果在執(zhí)行過程中兩個目標(biāo)共享同一個目標(biāo)，則先導(dǎo)目標(biāo)只被執(zhí)行一次。
可以通過指定目標(biāo)來運(yùn)行構(gòu)建：
例如執(zhí)行完ant后，可以執(zhí)行ant clean來清理構(gòu)建：
ant等價于ant archive
ant init
ant clean
ant compile
ant archive
ant clean archive
當(dāng)構(gòu)建完成一次以后，再次執(zhí)行構(gòu)建會發(fā)生什么呢？
第二次執(zhí)行構(gòu)建時只花了2s，相比第一次的4s。并且沒有任何一個目標(biāo)表示做了任何工作。
原因如下：所有的任務(wù)都檢查了它們的依賴關(guān)系：
<mkdir>沒有創(chuàng)建目錄因?yàn)橐呀?jīng)存在
<javac>比較了源文件和類文件的時間戳
<jar>比較了要被加入文件與已經(jīng)存在文件的時間
只有更新的時候才進(jìn)行任務(wù)執(zhí)行。
Ant如何處理命令行上的多個目標(biāo)？
執(zhí)行ant compile archive會怎么樣？
先實(shí)驗(yàn)一下：
Ant依次執(zhí)行每個目標(biāo)和其依賴目標(biāo)，即Ant的執(zhí)行順序是init compile init compile archive，雖然這樣看起來增加了額外的工作，但是通過上面的執(zhí)行過程就會發(fā)現(xiàn)，由于其依賴性檢查的阻止，第二次的init和compile并未真正的執(zhí)行，執(zhí)行時間與直接執(zhí)行archive的時間是一樣的。
運(yùn)行程序：
普通執(zhí)行該類的方法是：
java ?Ccp build/class com.neusoft.test.AntTest args1 args2
而我們使用Ant的任務(wù)來執(zhí)行它僅僅需要增加一個任務(wù)，好處在于：
讓用于執(zhí)行的目標(biāo)依賴與編譯的目標(biāo)，確保運(yùn)行最新版本
易于傳遞復(fù)雜參數(shù)
設(shè)置classpath更方便
在Ant自身的JVM中運(yùn)行，載入更快
增加一個新的目標(biāo)：
<target name="execute" depends="compile">
<java classname="com.neusoft.test.AntTest"
classpath="build/classes">
<arg value="a"/>
<arg value="b"/>
<arg file="."/>
</java>
</target>
最后一個參數(shù)是file=”.”，表示傳入的參數(shù)是一個目錄，為文件絕對路徑。
運(yùn)行該目標(biāo)，輸出如下：
Ant命令行選項：
請參閱相關(guān)手冊進(jìn)行查詢相關(guān)選項的功能。
當(dāng)有多個構(gòu)建文件時，可以指定構(gòu)建文件：
ant ?Cbuildfile build.xml compile
來表示執(zhí)行build.xml這個構(gòu)建文件中的compile目標(biāo)。
控制提供的信息量：
ant ?Cquiet:安靜模式，不給出任何輸出。
ant ?Cemacs:簡單模式，不顯示任務(wù)名稱。
ant ?Cprojecthelp:獲取項目信息。
最終的構(gòu)建文件，添加了description屬性。
<?xml version="1.0" ?>
<project name="secondbuild" default="execute" >
<description>Compiles and runs a simple program</description>
<target name="init">
<mkdir dir="build/classes" />
<mkdir dir="dist" />
</target>
<target name="compile" depends="init"
description="Compiles the source code">
<javac srcdir="src" destdir="build/classes"/>
</target>
<target name="archive" depends="compile"
description="Creates the JAR file">
<jar destfile="dist/project.jar" basedir="build/classes"/>
</target>
<target name="clean" depends="init"
description="Removes the temporary directories used">
<delete dir="build" />
<delete dir="dist" />
</target>
<target name="execute" depends="compile"
description="Runs the program">
<echo level="warning" message="running" />
<java classname="org.example.antbook.lesson1.Main"
classpath="build/classes">
<arg value="a"/>
<arg value="b"/>
<arg file="."/>
</java>
</target>