該構(gòu)建過(guò)程如下：
系統(tǒng)初始化1、編譯 2、生成JAVADOC 4、打包 5、上傳到FTP，其中后兩步結(jié)合到一起叫部署。
執(zhí)行時(shí)輸出如下：
> 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í)使用命令行參數(shù)以傳入一個(gè)屬性文件，屬性文件中包含連接FTP服務(wù)器使用的服務(wù)器名，用戶名，用戶密碼來(lái)給特性使用。
這個(gè)例子很好的展示了Ant的一些基本要素：目標(biāo)依賴、特性的使用、編譯、文檔生成、JAR打包（tar,Zip,WAR,EAR等），最后是部署。
Ant的簡(jiǎn)單任務(wù)(<mkdir>)都是由Java類(lèi)庫(kù)來(lái)實(shí)現(xiàn)相應(yīng)的功能。而一些復(fù)雜的任務(wù)<ftp>、<junit>還需要第三方庫(kù)的支持。
Ant 的一個(gè)強(qiáng)大之處：它總能工作。只要正確的指定構(gòu)建文件，Ant就能計(jì)算出目標(biāo)的依賴性，并且按照正確的順序調(diào)用目標(biāo)。目標(biāo)通過(guò)任務(wù)按序執(zhí)行，而任務(wù)自身處 理其文件依賴性以及實(shí)際的操作來(lái)完成工作。因?yàn)槊總€(gè)任務(wù)通常都是在高層陳述，所以一兩行XML語(yǔ)句經(jīng)常就已經(jīng)足夠描述任務(wù)的內(nèi)容。
4. 下載并安裝Ant
使用Ant前提條件，系統(tǒng)中已經(jīng)安裝JDK以及Ant。在文檔編寫(xiě)之時(shí)，Ant的最新版本是Ant 1.7,但是為了穩(wěn)定性，本文檔使用版本為Ant 1.6.5.
其次，解壓縮文件，放到指定的系統(tǒng)目錄中，例如C:\Ant。
再次，將其添加到path，以便從命令行使用。(一些IDE，例如Eclipse可以不需要設(shè)置path,而通過(guò)IDE相關(guān)設(shè)置將Ant添加到path中。)
再次，設(shè)置一些環(huán)境變量指向JDK以及ANT。
最后，添加需要的可選庫(kù)。
在Windows安裝過(guò)程（以筆者的安裝過(guò)程為例）
下載apache-ant-1.6.5-bin.zip到本地硬盤(pán)，解壓縮之后將文件夾命名為Ant,放在C:\Ant中。這個(gè)目錄就是Ant主目錄。
應(yīng)該將主目錄中的bin目錄添加到path屬性中，這樣就可以在命令行中調(diào)用ant命令，ANT_HOME是批處理文件所在目錄的上級(jí)目錄。最好明確設(shè)定。
現(xiàn)在許多工具已經(jīng)集成了特定版本的Ant，一些操作系統(tǒng)甚至默認(rèn)的已經(jīng)安裝了Ant。所以，你的系統(tǒng)中可能已經(jīng)安裝了Ant。
首先可以通過(guò)運(yùn)行以下命令：
ant -version
和
ant -diagnostics
來(lái)確定。我們推薦您不設(shè)置CLASSPATH來(lái)運(yùn)行Ant命令。如果任何版本的Ant可以從CLASSPATH加載 ，這時(shí)就會(huì)由于加載了不兼容的類(lèi)而產(chǎn)生許多錯(cuò)誤。
一些其他問(wèn)題請(qǐng)參閱Ant的FAQ設(shè)置。
正常情況下，執(zhí)行ant ?Cversion即可顯示Ant版本，則說(shuō)明安裝配制成功：
5. 運(yùn)行第一個(gè)構(gòu)建文件：
首先創(chuàng)建一個(gè)Java工程，名為AntProject，工程中源文件和目標(biāo)文件是分開(kāi)的，分別為文件夾src和bin,然后創(chuàng)建一個(gè)Java類(lèi)文件，類(lèi)名為
com.neusoft.test.AntTest，只是為了測(cè)試，所以類(lèi)的內(nèi)容很簡(jiǎn)單：
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]);
}
}
}
然后我們?cè)诠こ痰穆窂较旅娼⒁粋€(gè)構(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)建文件說(shuō)明如下圖：
關(guān)于XML的知識(shí)，請(qǐng)參考其他書(shū)籍，這里不做介紹。
以上創(chuàng)建完成后，目錄結(jié)構(gòu)如下圖：
Ant 構(gòu)建文件總是有一個(gè)<project>元素做為根元素，它有兩個(gè)屬性，name和default，<target>元素 是<project>元素的子元素，可以有多個(gè)，它有兩個(gè)屬性，name和depends，<target>元素包含的元素就是 一些任務(wù)元素。
<target>可以由命令行進(jìn)行顯示的調(diào)用，也可以在內(nèi)部使用如可以直接調(diào)用ant init、ant compile等。如果不寫(xiě)參數(shù)，則默認(rèn)的build文件是build.xml，默認(rèn)的目標(biāo)是<project>的default屬性定義的目標(biāo)。目標(biāo)的名稱(chēng)是唯一的，可以是任意字符串。
下面我們先運(yùn)行一下這個(gè)Ant構(gòu)建，再講解其他的內(nèi)容，進(jìn)入工程目錄，執(zhí)行
ant
這里就相當(dāng)于執(zhí)行默認(rèn)的目標(biāo)，也就是<project name="structured" default="archive" >中的archive目標(biāo)。
這里說(shuō)明了首先初始化創(chuàng)建兩個(gè)目錄，然后編譯了一個(gè)JAVA文件，然后進(jìn)行了打包的操作。
這里講解一下如果構(gòu)建失敗了怎么辦？
首 先有可能是XML語(yǔ)法書(shū)寫(xiě)不正確(將<target>寫(xiě)成<targe>)，或者在任務(wù)執(zhí)行過(guò)程中出現(xiàn)了錯(cuò)誤(.java文件中 包含編譯錯(cuò)誤)，或者任務(wù)名稱(chēng)書(shū)寫(xiě)錯(cuò)誤(將<javac>寫(xiě)成<javacc>)等等，這些都不是Ant的錯(cuò)誤，不需要填寫(xiě) Bug Report。寫(xiě)XML時(shí)一定要細(xì)心，一些IDE已經(jīng)有驗(yàn)證功能，可以很好的防止書(shū)寫(xiě)的錯(cuò)誤。
出現(xiàn)錯(cuò)誤時(shí)，可以使用
ant ?Cverbose
或者
ant ?Cdebug來(lái)獲取更加詳細(xì)的構(gòu)建信息，以解決問(wèn)題。
下圖是使用ant ?Cverbose時(shí)的輸出，使用ant ?Cdebug將獲取比這更詳細(xì)的信息，這里就不舉例了。
本例中直接使用了軟件工程中的構(gòu)建結(jié)構(gòu)，使用src作為源文件目錄，build/class作為中間生成文件，以dist作為可發(fā)布文件。在最后把一些可執(zhí)行文件可以放在bin目錄中。此時(shí)目錄結(jié)構(gòu)如下圖所示：
我們需要一種辦法來(lái)確定某些任務(wù)先執(zhí)行，而有些任務(wù)后執(zhí)行，比如必須先編譯，才能執(zhí)行程序或者打包。我們?cè)诼暶髂繕?biāo)的時(shí)候，就在其依賴屬性中列出其依賴關(guān)系：
<target name="compile" depends="init" >
<target name="archive" depends="compile" >
<target name="clean" depends="init">
如果一個(gè)目標(biāo)依賴與多個(gè)其他目標(biāo)，需要將它們都寫(xiě)到依賴屬性中，例如：
depents=”compile,test”。在我們的構(gòu)建中，archive依賴于init和compile，但是我們不需要去寫(xiě)，因?yàn)閏ompile已經(jīng)依賴于init了。即：Ant的依賴關(guān)系是傳遞的，但不是自反的。
如果在執(zhí)行過(guò)程中兩個(gè)目標(biāo)共享同一個(gè)目標(biāo)，則先導(dǎo)目標(biāo)只被執(zhí)行一次。
可以通過(guò)指定目標(biāo)來(lái)運(yùn)行構(gòu)建：
例如執(zhí)行完ant后，可以執(zhí)行ant clean來(lái)清理構(gòu)建：
ant等價(jià)于ant archive
ant init
ant clean
ant compile
ant archive
ant clean archive
當(dāng)構(gòu)建完成一次以后，再次執(zhí)行構(gòu)建會(huì)發(fā)生什么呢？
第二次執(zhí)行構(gòu)建時(shí)只花了2s，相比第一次的4s。并且沒(méi)有任何一個(gè)目標(biāo)表示做了任何工作。
原因如下：所有的任務(wù)都檢查了它們的依賴關(guān)系：
<mkdir>沒(méi)有創(chuàng)建目錄因?yàn)橐呀?jīng)存在
<javac>比較了源文件和類(lèi)文件的時(shí)間戳
<jar>比較了要被加入文件與已經(jīng)存在文件的時(shí)間
只有更新的時(shí)候才進(jìn)行任務(wù)執(zhí)行。
Ant如何處理命令行上的多個(gè)目標(biāo)？
執(zhí)行ant compile archive會(huì)怎么樣？
先實(shí)驗(yàn)一下：
Ant依次執(zhí)行每個(gè)目標(biāo)和其依賴目標(biāo)，即Ant的執(zhí)行順序是init compile init compile archive，雖然這樣看起來(lái)增加了額外的工作，但是通過(guò)上面的執(zhí)行過(guò)程就會(huì)發(fā)現(xiàn)，由于其依賴性檢查的阻止，第二次的init和compile并未真正的執(zhí)行，執(zhí)行時(shí)間與直接執(zhí)行archive的時(shí)間是一樣的。
運(yùn)行程序：
普通執(zhí)行該類(lèi)的方法是：
java ?Ccp build/class com.neusoft.test.AntTest args1 args2
而我們使用Ant的任務(wù)來(lái)執(zhí)行它僅僅需要增加一個(gè)任務(wù)，好處在于：
讓用于執(zhí)行的目標(biāo)依賴與編譯的目標(biāo)，確保運(yùn)行最新版本
易于傳遞復(fù)雜參數(shù)
設(shè)置classpath更方便
在Ant自身的JVM中運(yùn)行，載入更快
增加一個(gè)新的目標(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>
最后一個(gè)參數(shù)是file=”.”，表示傳入的參數(shù)是一個(gè)目錄，為文件絕對(duì)路徑。
運(yùn)行該目標(biāo)，輸出如下：
Ant命令行選項(xiàng)：
請(qǐng)參閱相關(guān)手冊(cè)進(jìn)行查詢相關(guān)選項(xiàng)的功能。
當(dāng)有多個(gè)構(gòu)建文件時(shí)，可以指定構(gòu)建文件：
ant ?Cbuildfile build.xml compile
來(lái)表示執(zhí)行build.xml這個(gè)構(gòu)建文件中的compile目標(biāo)。
控制提供的信息量：
ant ?Cquiet:安靜模式，不給出任何輸出。
ant ?Cemacs:簡(jiǎn)單模式，不顯示任務(wù)名稱(chēng)。
ant ?Cprojecthelp:獲取項(xiàng)目信息。
最終的構(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"&
