Apache Ant入門

1.構建ant環境
要使用ant首先要構建一個ant環境,步驟很簡單:
1)安裝jdk,設置JAVA_HOME ,PATH ,CLASS_PATH。
2)下載ant 地址www.apache.org
3)解壓ant 你得到的是一個壓縮包,解壓縮它,並把它放在一個儘量簡單的目錄,例如D:\ant-1.7。
4)設置ANT_HOME PATH中添加ANT_HOME目錄下的bin目錄。
5)測試一下你的設置。開始-->運行-->cmd進入命令行-->鍵入 ant 回車,如果看到
Buildfile: build.xml does not exist!
Build failed
配置成功。
 
2.ant命令行使用舉例
1)ant
使用當前目錄下的build.xml運行Ant,執行缺省的target。
2)ant -buildfile test.xml
使用當前目錄下的test.xml運行Ant,執行缺省的target。
3)ant -buildfile test.xml dist
使用當前目錄下的test.xml運行Ant,執行一個叫做dist的target。
4)ant -buildfile test.xml -Dbuild=build/classes dist
使用當前目錄下的test.xml運行Ant,執行一個叫做dist的target,並設定build屬性的值爲build/classes。
 
3.編寫build.xml
Ant的buildfile是用XML寫的。每個buildfile含有一個project。 buildfile中每個task元素可以有一個id屬性,可以用這個id值引用指定的任務。這個值必須是唯一的。(詳情請參考下面的Task小節)
 
3.1Projects
project有下面的屬性:
Attribute
Description
Required
name
項目名稱
No
default
當沒有指定target時使用的缺省target
Yes
basedir
用於計算所有其他路徑的基路徑。該屬性可以被basedir property覆蓋。當覆蓋時,該屬性被忽略。如果屬性和basedir property都沒有設定,就使用buildfile文件的父目錄。
No
一個項目可以定義一個或多個target。一個target是一系列你想要執行的。執行Ant時,你可以選擇執行哪個target。當沒有給定target時,使用project的default屬性所確定的target。
 
3.2Targets
一個target可以依賴於其他的target。例如,你可能會有一個target用於編譯程序,一個target用於生成可執行文件。你在生成可執行文件之前必須先編譯通過,所以生成可執行文件的target依賴於編譯target。Ant會處理這種依賴關係。
然而,應當注意到,Ant的depends屬性只指定了target應該被執行的順序-如果被依賴的target無法運行,這種depends對於指定了依賴關係的target就沒有影響。
Ant會依照depends屬性中target出現的順序(從左到右)依次執行每個target。然而,要記住的是隻要某個target依賴於一個target,後者就會被先執行。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
假定我們要執行target D。從它的依賴屬性來看,你可能認爲先執行C,然後B,最後A被執行。錯了,C依賴於B,B依賴於A,所以先執行A,然後B,然後C,最後D被執行。
一個target只能被執行一次,即時有多個target依賴於它(看上面的例子)。
如果(或如果不)某些屬性被設定,才執行某個target。這樣,允許根據系統的狀態(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總會被執行。
可選的description屬性可用來提供關於target的一行描述,這些描述可由-projecthelp命令行選項輸出。
將你的tstamp task(見下文例子)作爲一個所謂的初始化target是很好的做法,其他的target依賴這個初始化target。要確保初始化target是出現在其他target依賴表中的第一個target。在本手冊中大多數的初始化target的名字是"init"。
target有下面的屬性:
Attribute
Description
Required
name
target的名字
Yes
depends
用逗號分隔的target的名字列表,也就是依賴表。
No
if
執行target所需要設定的屬性名。
No
unless
執行target需要清除設定的屬性名。
No
description
關於target功能的簡短描述。
No
 
3.3Tasks
一個task是一段可執行的代碼。 一個task可以有多個屬性(如果你願意的話,可以將其稱之爲變量)。屬性只可能包含對property的引用。這些引用會在task執行前被解析。
下面是Task的一般構造形式:
<name attribute1="value1" attribute2="value2" ... />
這裏name是task的名字,attributeN是屬性名,valueN是屬性值。 有一套內置的(built-in)task,以及一些可選task,但你也可以編寫自己的task。 所有的task都有一個task名字屬性。Ant用屬性值來產生日誌信息。
可以給task賦一個id屬性:
<taskname id="taskID" ... />
這裏taskname是task的名字,而taskID是這個task的唯一標識符。通過這個標識符,你可以在腳本中引用相應的task。例如,在腳本中你可以這樣:
<script ... >
task1.setFoo("bar");
</script>
設定某個task實例的foo屬性。在另一個task中(用java編寫),你可以利用下面的語句存取相應的實例。
project.getReference("task1").
注意1:如果task1還沒有運行,就不會被生效(例如:不設定屬性),如果你在隨後配置它,你所作的一切都會被覆蓋。
注意2:未來的Ant版本可能不會兼容這裏所提的屬性,因爲很有可能根本沒有task實例,只有proxies。
 
3.4Properties
一個project可以有很多的properties。可以在buildfile中用property task來設定,或在Ant之外設定。一個property有一個名字和一個值。property可用於task的屬性值。這是通過將屬性名放在"${"和"}"之間並放在屬性值的位置來實現的。例如如果有一個property builddir的值是"build",這個property就可用於屬性值:${builddir}/classes。這個值就可被解析爲build/classes。
內置屬性:
如果你使用了<property> task 定義了所有的系統屬性,Ant允許你使用這些屬性。例如,${os.name}對應操作系統的名字。
要想得到系統屬性的列表可參考the Javadoc of System.getProperties。
除了Java的系統屬性,Ant還定義了一些自己的內置屬性:
basedir project基目錄的絕對路徑 (與<project>的basedir屬性一樣)。
ant.file buildfile的絕對路徑。
ant.version Ant的版本。
ant.project.name 當前執行的project的名字;由<project>的name屬性設定。
ant.java.version Ant檢測到的JVM的版本; 目前的值有"1.1", "1.2", "1.3" and "1.4"。
 
4.ant中的HelloWorld
1)首先你要知道你要幹什麼,我現在想做的事情是:
-編寫一些程序
-編譯它們
-把它打包成jar包
-把他們放在應該放置的地方
-運行它們
這裏爲了簡單起見,只寫一個程序,就是HelloWorld.java程序代碼如下:
package test.ant;
public class HelloWorld{
 public static void main(String[] args){
  System.out.println("Hello world!");
 }
}
 
2)要運行ant需要有一個build.xml。
下邊就是一個完整的build.xml
<?xml version="1.0" encoding="UTF-8" ?>
<project name="HelloWorld" default="rerun" basedir=".">
 <property name="src" value="src"/>
 <property name="dest" value="classes"/>
 <property name="lib"  value="lib"/>
 <property name="hello_jar" value="hello1.jar"/>
 
 <target name="init">
  <mkdir dir="${dest}"/>
 </target>
 
 <target name="compile" depends="init">
  <javac srcdir="${src}" destdir="${dest}"/>
 </target>
 
 <target name="build" depends="compile">
  <mkdir dir="${lib}"/>
  <jar jarfile="${lib}/${hello_jar}" basedir="${dest}"/>
 </target>
 
 <target name="run" depends="build">
  <java classname="test.ant.HelloWorld" classpath="${lib}/${hello_jar}"/>
 </target>
 
 <target name="clean" depends="run">
  <delete dir="${dest}" />
 </target>
 
 <target name="rerun" >
  <ant target="run" />
 </target>
</project>
 
解釋:
<project name="HelloWorld" default="run" basedir=".">
</project> 
ant的所有內容必須包含在這個裏邊,name是你給它取的名字,basedir是工作的根目錄 .代表當前目錄。default代表默認要做的事情。
<property name="src" value="src"/>
類似程序中的變量。各個target的用途依次是:編譯(compile),做jar包(build),運行(run)。
爲了不用拷貝,我們可以在最開始定義好目標文件夾,這樣ant直接把結果就放在目標文件夾中了:新建文件夾(init)。
另外兩個target:刪除生成的文件(clean),再次運行,這裏顯示瞭如何在一個target裏邊調用其他的target(rerun)。
 
測試:
1)新建一個src的文件夾,然後把HelloWorld.java按照包目錄放進去。
2)做好build.xml文件。放在與src同級的目錄。
3)將當前目錄轉換到build.xml所在目錄。在命令行下鍵入ant,你會發現一個個任務都完成了。
當default="run"時的結果:
 run
當default="clean"時的結果:
 clean
當default="rerun"時的結果:
rerun
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章