天天看點

ANT的安裝/配置筆記(轉)

内容摘要:

ant是一個基于JAVA的自動化腳本引擎,腳本格式為XML。除了做JAVA編譯相關任務外,ANT還可以通過插件實作很多應用的調用。

ANT的基本概念:

ANT的安裝:解包,設定路徑

ANT的使用:最好的學習隻不過是一個簡單實用的例子起步……

ANT的基本概念:Java的Makefile

當一個代碼項目大了以後,每次重新編譯,打包,測試等都會變得非常複雜而且重複,是以c語言中有make腳本來幫助這些工作的批量完成。在Java 中應用是平台無關性的,當然不會用平台相關的make腳本來完成這些批處理任務了,ANT本身就是這樣一個流程腳本引擎,用于自動化調用程式完成項目的編譯,打包,測試等。除了基于JAVA是平台無關的外,腳本的格式是基于XML的,比make腳本來說還要好維護一些。

每個ant腳本(預設叫build.xml)中設定了一系列任務(target):比如對于一個一般的項目可能需要有以下任務。

任務1:usage 列印本腳本的幫助資訊(預設)

任務2:clean <-- init 清空初始化環境

任務3:javadoc <-- build <-- init 生成JAVADOC

任務4:jar <-- build <-- init 生成JAR

任務5:all <-- jar + javadoc <-- build <-- init 完成以上所有任務:jar javadoc

而多個任務之間往往又包含了一定了依賴關系:比如把整個應用打包任務(jar)的這個依賴于編譯任務(build),而編譯任務又依賴于整個環境初始化任務(init)等。

注:我看到很多項目的ant腳本中的命名基本上都是一緻的,比如:編譯一般叫build或者compile;打包一般叫jar或war;生成文檔一般命名為javadoc或javadocs;執行全部任務all。在每個任務的中,ANT會根據配置調用一些外部應用并配以相應參數執行。雖然ANT可調用的外部應用種類非常豐富,但其實最常用的就2,3個:比如javac javadoc jar等。

ANT的安裝

解包後在系統可執行路徑中加入指向ant的bin的路徑就可以了,比如可以在GNU/Linux上把以下配置加入/etc/profile中:

export ANT_HOME=/home/ant

export JAVA_HOME=/usr/java/j2sdk1.4.1

export PATH=$PATH:$JAVA_HOME/bin:$ANT_HOME/bin

這樣執行ant 後,如果不指定配置檔案ant會預設找build.xml這個配置檔案,并根據配置檔案執行任務,預設的任務設定可以指向最常用的任務,比如: build,或指向列印幫助資訊:usage,告訴使用者有那些腳本選項可以使用。

ANT的使用

最好的學習過程就是看懂那些open source項目中的build.xml腳本,然後根據自己的需要簡化成一個更簡單的,ANT和APACHE上很多非常工程派的項目:簡單易用,而且适應性非常強,因為這些項目的建立往往來源于開發人員日常最直接的需求。

以下是的一個WebLucene應用的例子:修改自JDOM的build.xml:

<project default="usage" basedir=".">

<!-- =================================================================== -->

<!-- Initialization target -->

<!-- =================================================================== -->

<target name="init">

<tstamp/>

<property file="${basedir}/build.properties" />

<property name="Name" value="ProjectFullName"/>

<property name="name" value="project_name"/>

<property name="version" value="0.2"/>

<property name="year" value="2003"/>

<echo message="----------- ${Name} ${version} [${year}] ------------"/>

<property name="debug" value="off"/>

<property name="optimize" value="on"/>

<property name="deprecation" value="on"/>

<property name="src.dir" value="./src/WEB-INF/src"/>

<property name="lib.dir" value="./src/WEB-INF/lib"/>

<property name="packages" value="com.chedong.*,org.apache.lucene.*"/>

<property name="build.src" value="./src/WEB-INF/build"/>

<property name="build.dest" value="./src/WEB-INF/classes"/>

<property name="build.javadocs" value="./src/doc"/>

<path id="classpath">

<pathelement path="${jsdk_jar}"/>

<fileset dir="${lib.dir}">

<include name="***.class"/>

</delete>

</target>

</project>

<!-- End of file -->

預設任務:usage 列印幫助文檔,告訴有那些任務選項:可用的有build, jar, javadoc和clean.

初始化環境變量:init

所有任務都基于一些基本環境變量的設定初始化完成,是後續其他任務的基礎,在環境初始化過程中,有2點比較可以友善設定:

1 除了使用卻預設的property設定了JAVA源路徑和輸出路徑外,引用了一個外部的build.properties檔案中的設定,

<property file="${basedir}/build.properties" />

這樣大部分簡單配置使用者隻要會看懂build.properties就可以了,畢竟XML比起key value的屬性檔案還是要可讀性差一些。用build.properties也可以友善其他使用者從編譯的細節中解放出來。

2 CLASSPATH設定:使用了其中的:

<path id="classpath">

<pathelement path="${jsdk_jar}"/>

<fileset dir="${lib.dir}">

<include name="***.class"/>

</delete>

</target>

TODO:

更多任務/擴充:(樣例)

測試任務:JUnit測試

代碼風格檢查任務:CheckStyle,Jalopy等

郵件警報任務:可以把以上這些任務的輸出警告發送到制定的使用者清單中,這個任務可以設定每天自動運作。

參考資料:

Jakarta ANT:

http://ant.apache.org