1．構建ant環境
要使用ant首先要構建一個ant環境，步驟很簡單：
1)安裝jdk，設置JAVA_HOME ,PATH ,CLASS_PATH。
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"時的結果：
當default="clean"時的結果：
當default="rerun"時的結果：
posted on 2007-08-19 05:05
前方的路 閱讀(636)
評論(1) 編輯 收藏 所屬分類:
Java技術