| 本節內容包含了Ant的歷史簡(jiǎn)要介紹，Ant的功能以及Ant框架的介紹，并對下載安裝使用Ant進(jìn)行了示例介紹，同時(shí)通過(guò)一個(gè)Java程序講解了Ant的基本使用方法。 1. Ant簡(jiǎn)介：這里引用Ant幫助文檔中對Ant的介紹： Apache Ant是一個(gè)基于Java的構建工具。從理論上講，也是一種類(lèi)似于Make的工具，只是去除了Make工具的缺點(diǎn)。 既然已經(jīng)有了make, gnumake, nmake, jam以及其他的構件工具，為什么還要Ant呢？因為Ant的早期開(kāi)發(fā)者發(fā)現所有以上這些工具都或多或少的有一些局限性，使得在跨平臺開(kāi)發(fā)軟件成為困難。類(lèi)似于Make的工具都是傳統的基于Shell的--首先進(jìn)行依賴(lài)性檢查，然后執行命令。這意味著(zhù)你可以輕易的通過(guò)使用或者編寫(xiě)程序來(lái)擴展這些工具，以滿(mǎn)足不同的平臺。當然，這也意味著(zhù)你將局限于特定的平臺，至少可以說(shuō)局限于特定類(lèi)型的平臺，例如：Unix平臺。 同時(shí)，Make文件也有一些先天的缺陷。好多人都會(huì )遇到恐怖的tab問(wèn)題。Ant的最初開(kāi)發(fā)者多次說(shuō)“我的命令不能執行因為我在tab前面加了一個(gè)空格！”。一些工具如Jam一定程序上解決了這個(gè)問(wèn)題，但仍有其它的格式問(wèn)題。 Ant與從基于命令的那些擴展開(kāi)來(lái)的那些工具不同，Ant是由java類(lèi)擴展的。不用編寫(xiě)shell命令，而是配置基于XML的文件，形成多個(gè)任務(wù)的目標配置樹(shù)。每一個(gè)任務(wù)都是通過(guò)一個(gè)實(shí)現了一個(gè)規定接口的java類(lèi)來(lái)運行的。 ant缺少了一些直接執行shell命令的能力，如find . -name foo -exec rm {}，但它給用戶(hù)提供了跨平臺的能力，可以在任何地方工作。實(shí)際上，Ant也提供了命令execute用來(lái)執行shell命令,這就是它的任務(wù)，它允許執行基于操作系統的命令。 簡(jiǎn)單的說(shuō)，Ant是一個(gè)基于Java，并且主要用于Java工程的構建工具。Ant本意是Another Neat Tool,也就是另一種整潔的工具，取首字符就是Ant。 構建工具就是為了減少重復工作而產(chǎn)生的。 2. Ant的一些核心概念： XML:構建文件是以XML文件來(lái)描述的，采用XML格式有很多好處。這里就不一一列舉。 陳述式語(yǔ)法：構建文件短小精悍，且易于理解。 每個(gè)構建文件包含一個(gè)工程(project)。 每個(gè)工程包含若干個(gè)目標(target)。 目標可以依賴(lài)于其他的目標(depends)。 目標包含任務(wù)(task)。 易于使用Java語(yǔ)言增加新的任務(wù)---易于擴展（自定義）。 3. Ant結構： Ant的結構如下圖所示：  構建文件的概念視圖：工程包含一個(gè)目標的集合。在每個(gè)目標里是任務(wù)的聲明，它們是對Ant用于構建該目標的行為說(shuō)明。目標生成一個(gè)依賴(lài)關(guān)系圖表來(lái)聲明該目標的依賴(lài)關(guān)系。當執行一個(gè)目標時(shí)，必須先執行它們依賴(lài)的目標。 例子：一個(gè)典型的構建文件： <?xml version="1.0" ?> <project name="OurProject" default="deploy"> <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="doc" depends="init" > <javadoc destdir="build/classes" sourcepath="src" packagenames="org.*" /> </target> <target name="deploy" depends="compile,doc" > <jar destfile="dist/project.jar" basedir="build/classes"/> <ftp server="${server.name}" userid="${ftp.username}" password="${ftp.password}"> <fileset dir="dist"/> </ftp> </target> </project> 該構建過(guò)程如下： 系統初始化à編譯à生成JAVADOCà打包à上傳到FTP，其中后兩步結合到一起叫部署。 執行時(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. 在執行時(shí)使用命令行參數以傳入一個(gè)屬性文件，屬性文件中包含連接FTP服務(wù)器使用的服務(wù)器名，用戶(hù)名，用戶(hù)密碼來(lái)給特性使用。 這個(gè)例子很好的展示了Ant的一些基本要素：目標依賴(lài)、特性的使用、編譯、文檔生成、JAR打包（tar,Zip,WAR,EAR等），最后是部署。 Ant的簡(jiǎn)單任務(wù)(<mkdir>)都是由Java類(lèi)庫來(lái)實(shí)現相應的功能。而一些復雜的任務(wù)<ftp>、<junit>還需要第三方庫的支持。 Ant的一個(gè)強大之處：它總能工作。只要正確的指定構建文件，Ant就能計算出目標的依賴(lài)性，并且按照正確的順序調用目標。目標通過(guò)任務(wù)按序執行，而任務(wù)自身處理其文件依賴(lài)性以及實(shí)際的操作來(lái)完成工作。因為每個(gè)任務(wù)通常都是在高層陳述，所以一兩行XML語(yǔ)句經(jīng)常就已經(jīng)足夠描述任務(wù)的內容。 4. 下載并安裝Ant 使用Ant前提條件，系統中已經(jīng)安裝JDK以及Ant。在文檔編寫(xiě)之時(shí)，Ant的最新版本是Ant 1.7,但是為了穩定性，本文檔使用版本為Ant 1.6.5. 首先下載Ant，到apache軟件網(wǎng)站http://www.apache.org。 其次，解壓縮文件，放到指定的系統目錄中，例如C:\Ant。 再次，將其添加到path，以便從命令行使用。(一些IDE，例如Eclipse可以不需要設置path,而通過(guò)IDE相關(guān)設置將Ant添加到path中。) 再次，設置一些環(huán)境變量指向JDK以及ANT。 最后，添加需要的可選庫。 在Windows安裝過(guò)程（以筆者的安裝過(guò)程為例） 下載apache-ant-1.6.5-bin.zip到本地硬盤(pán)，解壓縮之后將文件夾命名為Ant,放在C:\Ant中。這個(gè)目錄就是Ant主目錄。 應該將主目錄中的bin目錄添加到path屬性中，這樣就可以在命令行中調用ant命令，ANT_HOME是批處理文件所在目錄的上級目錄。最好明確設定。 現在許多工具已經(jīng)集成了特定版本的Ant，一些操作系統甚至默認的已經(jīng)安裝了Ant。所以，你的系統中可能已經(jīng)安裝了Ant。 首先可以通過(guò)運行以下命令： ant -version 和 ant -diagnostics 來(lái)確定。我們推薦您不設置CLASSPATH來(lái)運行Ant命令。如果任何版本的Ant可以從CLASSPATH加載 ，這時(shí)就會(huì )由于加載了不兼容的類(lèi)而產(chǎn)生許多錯誤。 一些其他問(wèn)題請參閱Ant的FAQ設置。 正常情況下，執行ant –version即可顯示Ant版本，則說(shuō)明安裝配制成功：  5. 運行第一個(gè)構建文件： 首先創(chuàng )建一個(gè)Java工程，名為AntProject，工程中源文件和目標文件是分開(kāi)的，分別為文件夾src和bin,然后創(chuàng )建一個(gè)Java類(lèi)文件，類(lèi)名為 com.neusoft.test.AntTest，只是為了測試，所以類(lè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]); } } } 然后我們在工程的路徑下面建立一個(gè)構建文件build.xml，內容如下： <?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> 構建文件說(shuō)明如下圖：  關(guān)于XML的知識，請參考其他書(shū)籍，這里不做介紹。 以上創(chuàng )建完成后，目錄結構如下圖：  Ant構建文件總是有一個(gè)<project>元素做為根元素，它有兩個(gè)屬性，name和default，<target>元素是<project>元素的子元素，可以有多個(gè)，它有兩個(gè)屬性，name和depends，<target>元素包含的元素就是一些任務(wù)元素。 <target>可以由命令行進(jìn)行顯示的調用，也可以在內部使用如可以直接調用ant init、ant compile等。如果不寫(xiě)參數，則默認的build文件是build.xml，默認的目標是<project>的default屬性定義的目標。目標的名稱(chēng)是唯一的，可以是任意字符串。 下面我們先運行一下這個(gè)Ant構建，再講解其他的內容，進(jìn)入工程目錄，執行 ant 這里就相當于執行默認的目標，也就是<project name="structured" default="archive" >中的archive目標。  這里說(shuō)明了首先初始化創(chuàng )建兩個(gè)目錄，然后編譯了一個(gè)JAVA文件，然后進(jìn)行了打包的操作。 這里講解一下如果構建失敗了怎么辦？ 首先有可能是XML語(yǔ)法書(shū)寫(xiě)不正確(將<target>寫(xiě)成<targe>)，或者在任務(wù)執行過(guò)程中出現了錯誤(.java文件中包含編譯錯誤)，或者任務(wù)名稱(chēng)書(shū)寫(xiě)錯誤(將<javac>寫(xiě)成<javacc>)等等，這些都不是Ant的錯誤，不需要填寫(xiě)Bug Report。寫(xiě)XML時(shí)一定要細心，一些IDE已經(jīng)有驗證功能，可以很好的防止書(shū)寫(xiě)的錯誤。 出現錯誤時(shí)，可以使用 ant –verbose 或者 ant –debug來(lái)獲取更加詳細的構建信息，以解決問(wèn)題。 下圖是使用ant –verbose時(shí)的輸出，使用ant –debug將獲取比這更詳細的信息，這里就不舉例了。  本例中直接使用了軟件工程中的構建結構，使用src作為源文件目錄，build/class作為中間生成文件，以dist作為可發(fā)布文件。在最后把一些可執行文件可以放在bin目錄中。此時(shí)目錄結構如下圖所示： 我們需要一種辦法來(lái)確定某些任務(wù)先執行，而有些任務(wù)后執行，比如必須先編譯，才能執行程序或者打包。我們在聲明目標的時(shí)候，就在其依賴(lài)屬性中列出其依賴(lài)關(guān)系： <target name="compile" depends="init" > <target name="archive" depends="compile" > <target name="clean" depends="init"> 如果一個(gè)目標依賴(lài)與多個(gè)其他目標，需要將它們都寫(xiě)到依賴(lài)屬性中，例如： depents=”compile,test”。在我們的構建中，archive依賴(lài)于init和compile，但是我們不需要去寫(xiě)，因為compile已經(jīng)依賴(lài)于init了。即：Ant的依賴(lài)關(guān)系是傳遞的，但不是自反的。 如果在執行過(guò)程中兩個(gè)目標共享同一個(gè)目標，則先導目標只被執行一次。 可以通過(guò)指定目標來(lái)運行構建： 例如執行完ant后，可以執行ant clean來(lái)清理構建： ant等價(jià)于ant archive ant init ant clean ant compile ant archive ant clean archive 當構建完成一次以后，再次執行構建會(huì )發(fā)生什么呢？ 第二次執行構建時(shí)只花了2s，相比第一次的4s。并且沒(méi)有任何一個(gè)目標表示做了任何工作。 原因如下：所有的任務(wù)都檢查了它們的依賴(lài)關(guān)系： <mkdir>沒(méi)有創(chuàng )建目錄因為已經(jīng)存在 <javac>比較了源文件和類(lèi)文件的時(shí)間戳 <jar>比較了要被加入文件與已經(jīng)存在文件的時(shí)間 只有更新的時(shí)候才進(jìn)行任務(wù)執行。 Ant如何處理命令行上的多個(gè)目標？ 執行ant compile archive會(huì )怎么樣？ 先實(shí)驗一下： Ant依次執行每個(gè)目標和其依賴(lài)目標，即Ant的執行順序是init compile init compile archive，雖然這樣看起來(lái)增加了額外的工作，但是通過(guò)上面的執行過(guò)程就會(huì )發(fā)現，由于其依賴(lài)性檢查的阻止，第二次的init和compile并未真正的執行，執行時(shí)間與直接執行archive的時(shí)間是一樣的。 運行程序： 普通執行該類(lèi)的方法是： java –cp build/class com.neusoft.test.AntTest args1 args2 而我們使用Ant的任務(wù)來(lái)執行它僅僅需要增加一個(gè)任務(wù)，好處在于： 讓用于執行的目標依賴(lài)與編譯的目標，確保運行最新版本 易于傳遞復雜參數 設置classpath更方便 在A(yíng)nt自身的JVM中運行，載入更快 程序返回值非9，可以終止構建 增加一個(gè)新的目標： <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è)參數是file=”.”，表示傳入的參數是一個(gè)目錄，為文件絕對路徑。 運行該目標，輸出如下： Ant命令行選項： 請參閱相關(guān)手冊進(jìn)行查詢(xún)相關(guān)選項的功能。 當有多個(gè)構建文件時(shí)，可以指定構建文件： ant –buildfile build.xml compile 來(lái)表示執行build.xml這個(gè)構建文件中的compile目標。 控制提供的信息量： ant –quiet:安靜模式，不給出任何輸出。 ant –emacs:簡(jiǎn)單模式，不顯示任務(wù)名稱(chēng)。 ant –projecthelp:獲取項目信息。 最終的構建文件，添加了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> </project> |
聯(lián)系客服
