ANT不完全總結(jié)

1、ANT不完全總結(jié)ANT不完全總結(jié) 好久沒(méi)有用Ant了，最近讓MyEclipse、JBuilder2008逼的重回Ant上了。手生了，寫(xiě)了一個(gè)腳本后，重新總結(jié)下。參考了官方的文檔和網(wǎng)上一些資料。 一、ANT的介紹Ant的全名是"Another Neat Tool"，是由James Duncan Davidson在Make工具無(wú)法滿(mǎn)足他的需求下所撰寫(xiě)出來(lái)的構(gòu)建（build）工具。 Ant用Java編寫(xiě)，服務(wù)于Java。 二、ANT的安裝配置1、獲取ANT 2、安裝ANTset ANT_HOME=c:antset JAVA_HOM

2、E=c:jdk-.05set PATH=%PATH%;%ANT_HOME%bin 三、使用ANTAnt的build腳本是一個(gè)XML文件，稱(chēng)為Buildfile，每個(gè)Buildfile包含一個(gè)project和若干個(gè)target元素，每個(gè)target又可以包含若干個(gè)task元素，每個(gè)task元素可以有一個(gè)id屬性。當(dāng)然id屬性必須在整個(gè)文檔中是唯一的。結(jié)構(gòu)如下： <project/>   <target/>      <task/>   

3、60;  <task/>   </target>   <target>      <task/>   </target></project>  1、project有三個(gè)屬性，這些屬性都不是必須的。比如：<project name="testwebant" basedir="." default="all">屬性說(shuō)明

4、如下：name：指定項(xiàng)目的名字。basedir：指定項(xiàng)目根路徑，用于計(jì)算所有其他路徑的基路徑。該屬性可以被basedir property覆蓋。當(dāng)覆蓋時(shí)，該屬性被忽略。如果屬性和basedir property都沒(méi)有設(shè)定，就使用buildfile文件的父目錄。default：指定當(dāng)沒(méi)有指定執(zhí)行目標(biāo)時(shí)，所要執(zhí)行的目標(biāo)。 2、target 一個(gè)target可以依賴(lài)于其他的target。例如，你可能會(huì)有一個(gè)target用于編譯程序，一個(gè)target用于生成可執(zhí)行文件。你在生成可執(zhí)行文件之前必須先編譯通過(guò)，所以生成可執(zhí)行文件的target依賴(lài)于編譯target。Ant會(huì)處理這種依賴(lài)

5、關(guān)系。 Ant會(huì)依照depends屬性中target出現(xiàn)的順序（從左到右）依次執(zhí)行每個(gè)target。然而，要記住的是只要某個(gè)target依賴(lài)于一個(gè)target，后者就會(huì)被先執(zhí)行。<target name="A"/><target name="B" depends="A"/><target name="C" depends="B"/><target name="D" depends="C,B,A"/>

6、假定我們要執(zhí)行target D。從它的依賴(lài)屬性來(lái)看，你可能認(rèn)為先執(zhí)行C，然后B，最后A被執(zhí)行。錯(cuò)了，C依賴(lài)于B，B依賴(lài)于A，所以先執(zhí)行A，然后B，然后C，最后D被執(zhí)行。 一個(gè)target只能被執(zhí)行一次，即時(shí)有多個(gè)target依賴(lài)于它。 如果（或如果不）某些屬性被設(shè)定，才執(zhí)行某個(gè)target。這樣，允許根據(jù)系統(tǒng)的狀態(tài)（java version, OS, 命令行屬性定義等等）來(lái)更好地控制build的過(guò)程。要想讓一個(gè)target這樣做，你就應(yīng)該在target元素中，加入if（或unless）屬性，帶上target因該有所判斷的屬性。例如：<target name="

7、;build-module-A" if="module-A-present"/><target name="build-own-fake-module-A" unless="module-A-present"/>如果沒(méi)有if或unless屬性，target總會(huì)被執(zhí)行。 可選的description屬性可用來(lái)提供關(guān)于target的一行描述，這些描述可由-projecthelp命令行選項(xiàng)輸出。 target有下面的屬性，僅僅name屬性是必須的。：name： target的名字。depend

8、s： 用逗號(hào)分隔的target的名字列表，也就是依賴(lài)表。if 執(zhí)行target所需要設(shè)定的屬性名。unless 執(zhí)行target需要清除設(shè)定的屬性名。description 關(guān)于target功能的簡(jiǎn)短描述。 3、tasktask不是一個(gè)Buildfile的元素，是一個(gè)泛稱(chēng)。 一個(gè)task是一段可執(zhí)行的代碼。 一個(gè)task可以有多個(gè)屬性（如果你愿意的話，可以將其稱(chēng)之為變量）。屬性只可能包含對(duì)property的引用。這些引用會(huì)在task執(zhí)行前被解析。 下面是Task的一般構(gòu)造形式：<name attribute1="value1"

9、attribute2="value2" . />這里name是task的名字，attributeN是屬性名，valueN是屬性值。 有一套內(nèi)置的（built-in）task，以及一些可選task，但你也可以編寫(xiě)自己的task。 所有的task都有一個(gè)task名字屬性。Ant用屬性值來(lái)產(chǎn)生日志信息。 可以給task賦一個(gè)id屬性：<taskname id="taskID" . />這里taskname是task的名字，而taskID是這個(gè)task的唯一標(biāo)識(shí)符。通過(guò)這個(gè)標(biāo)識(shí)符，你可以在腳本中引用相應(yīng)的task。

10、例如，在腳本中你可以這樣：<script . >task1.setFoo("bar");</script>設(shè)定某個(gè)task實(shí)例的foo屬性。在另一個(gè)task中（用java編寫(xiě)），你可以利用下面的語(yǔ)句存取相應(yīng)的實(shí)例。project.getReference("task1"). 注意1：如果task1還沒(méi)有運(yùn)行，就不會(huì)被生效（例如：不設(shè)定屬性），如果你在隨后配置它，你所作的一切都會(huì)被覆蓋。 注意2：未來(lái)的Ant版本可能不會(huì)兼容這里所提的屬性，因?yàn)楹苡锌赡芨緵](méi)有task實(shí)例，只有proxies。 4、Pr

11、operties一個(gè)project可以有很多的properties。可以在buildfile中用property task來(lái)設(shè)定，或在Ant之外設(shè)定。如果是在外部設(shè)定的，則可以通過(guò)下面的方式來(lái)引入properties配置文件。<property file="perties"/> 一個(gè)property有一個(gè)名字和一個(gè)值。property可用于task的屬性值。這是通過(guò)將屬性名放在"$"和""之間并放在屬性值的位置來(lái)實(shí)現(xiàn)的。例如如果有一個(gè)property builddir的值是"

12、build"，這個(gè)property就可用于屬性值：$builddir/classes。這個(gè)值就可被解析為build/classes。  Ant內(nèi)置屬性 如果你使用了<property> task 定義了所有的系統(tǒng)屬性，Ant允許你使用這些屬性。例如，$對(duì)應(yīng)操作系統(tǒng)的名字。 要想得到系統(tǒng)屬性的列表可參考the Javadoc of System.getProperties。 除了Java的系統(tǒng)屬性，Ant還定義了一些自己的內(nèi)置屬性：basedir project基目錄的絕對(duì)路徑 (與<project>

13、;的basedir屬性一樣)。ant.file buildfile的絕對(duì)路徑。ant.version Ant的版本。   例子<project name="MyProject" default="dist" basedir=".">       <!- set global properties for this build ->    <property name="src&

14、quot; value="."/>    <property name="build" value="build"/>    <property name="dist" value="dist"/>     <target name="init">        &l

15、t;!- Create the time stamp ->        <tstamp/>        <!- Create the build directory structure used by compile ->        <mkdir dir="$build"/>    <

16、;/target>     <target name="compile" depends="init">        <!- Compile the java code from $src into $build ->        <javac srcdir="$src" destdir="$build&qu

17、ot;/>    </target>     <target name="dist" depends="compile">        <!- Create the distribution directory ->        <mkdir dir="$dist/lib"/&

18、gt;        <!- Put everything in $build into the MyProject-$DSTAMP.jar file ->        <jar jarfile="$dist/lib/MyProject-$DSTAMP.jar" basedir="$build"/>    </target>  &

19、#160;  <target name="clean">        <!- Delete the $build and $dist directory trees ->        <delete dir="$build"/>        <delete dir="$dist&q

20、uot;/>    </target> </project> 4、PATH和CLASSPATH 你可以用":"和""作為分隔符，指定類(lèi)似PATH和CLASSPATH的引用。Ant會(huì)把分隔符轉(zhuǎn)換為當(dāng)前系統(tǒng)所用的分隔符。 當(dāng)需要指定類(lèi)似路徑的值時(shí)，可以使用嵌套元素。一般的形式是<classpath>   <pathelement path="$classpath"/>   &l

21、t;pathelement location="lib/helper.jar"/></classpath>location屬性指定了相對(duì)于project基目錄的一個(gè)文件和目錄，而path屬性接受逗號(hào)或分號(hào)分隔的一個(gè)位置列表。path屬性一般用作預(yù)定義的路徑其他情況下，應(yīng)該用多個(gè)location屬性。 為簡(jiǎn)潔起見(jiàn)，classpath標(biāo)簽支持自己的path和location屬性。所以：<classpath>   <pathelement path="$classpath"/></c

22、lasspath>可以被簡(jiǎn)寫(xiě)作：<classpath path="$classpath"/>也可通過(guò)<fileset>元素指定路徑。構(gòu)成一個(gè)fileset的多個(gè)文件加入path-like structure的順序是未定的。<classpath>   <pathelement path="$classpath"/>   <fileset dir="lib">      <inc

23、lude name="*/*.jar"/>   </fileset>   <pathelement location="classes"/></classpath>上面的例子構(gòu)造了一個(gè)路徑值包括：$classpath的路徑，跟著lib目錄下的所有jar文件，接著是classes目錄。 如果你想在多個(gè)task中使用相同的path-like structure，你可以用<path>元素定義他們（與target同級(jí)），然后通過(guò)id屬性引用參考Referenc

24、s例子。 path-like structure可能包括對(duì)另一個(gè)path-like structurede的引用（通過(guò)嵌套<path>元素）：<path id="base.path">   <pathelement path="$classpath"/>   <fileset dir="lib">      <include name="*/*.jar"/>

25、   </fileset>   <pathelement location="classes"/></path><path id="tests.path">   <path refid="base.path"/>   <pathelement location="testclasses"/></path> 前面所提的關(guān)于<classpat

26、h>的簡(jiǎn)潔寫(xiě)法對(duì)于<path>也是有效的，如：<path id="tests.path">   <path refid="base.path"/>   <pathelement location="testclasses"/></path>可寫(xiě)成：<path id="base.path" path="$classpath"/> 5、命令行變量 有些task可接

27、受參數(shù)，并將其傳遞給另一個(gè)進(jìn)程。為了能在變量中包含空格字符，可使用嵌套的arg元素。Attribute Description Requiredvalue 一個(gè)命令行變量；可包含空格字符。 只能用一個(gè)line 空格分隔的命令行變量列表。file 作為命令行變量的文件名；會(huì)被文件的絕對(duì)名替代。path 一個(gè)作為單個(gè)命令行變量的path-like的字符串；或作為分隔符，Ant會(huì)將其轉(zhuǎn)變?yōu)樘囟ㄆ脚_(tái)的分隔符。 例子<arg value="-l -a"/>是一個(gè)含有空格的單個(gè)的命令行變量。<arg line="-l -a"/>是兩

28、個(gè)空格分隔的命令行變量。<arg path="/dir;/dir2:dir3"/>是一個(gè)命令行變量，其值在DOS系統(tǒng)上為dir;dir2;dir3；在Unix系統(tǒng)上為/dir:/dir2:/dir3 。   6、ID引用 buildfile元素的id屬性可用來(lái)引用這些元素。如果你需要一遍遍的復(fù)制相同的XML代碼塊，這一屬性就很有用如多次使用<classpath>結(jié)構(gòu)。 下面的例子：<project . >    <target . > &

29、#160;         <rmic .>                 <classpath>                   

30、0;   <pathelement location="lib/"/>                       <pathelement path="$additional.path"/>        

31、0;        </classpath>           </rmic>    </target>    <target . >        <javac .>      

32、;      <classpath>                <pathelement location="lib/"/>                <pathelement path=&q

33、uot;$additional.path"/>            </classpath>        </javac>    </target></project>可以寫(xiě)成如下形式：<project . >        <pat

34、helement location="lib/"/>        <pathelement path="$additional.path"/>    </path>    <target . >        <rmic .>      

35、60; </rmic>    </target>    <target . >        <javac .>        </javac>    </target></project>所有使用PatternSets, FileSets 或 path-like structures

36、嵌套元素的task也接受這種類(lèi)型的引用。  四、Ant內(nèi)置的常用任務(wù) Ant中內(nèi)置的任務(wù)很多很多，要想記住每個(gè)任務(wù)幾乎異想天開(kāi)，對(duì)于開(kāi)發(fā)者來(lái)說(shuō)，我們僅僅需要知道一些常見(jiàn)的任務(wù)使用即可。對(duì)于不常用的任務(wù)，可以在使用的時(shí)候直接到里去查看使用手冊(cè)。 Ant中的任務(wù)可以為3類(lèi)。核心任務(wù)。核心任務(wù)是Ant自帶的任務(wù)?？蛇x任務(wù)。可選任務(wù)實(shí)來(lái)自第三方的任務(wù)，因此需要一個(gè)附加的JAR文件。用戶(hù)自定義的任務(wù)。用戶(hù)自定義的任務(wù)實(shí)用戶(hù)自己開(kāi)發(fā)的任務(wù)。  下面是Ant中常用的一些任務(wù)用法的簡(jiǎn)單總結(jié)： 1、<mkdir>創(chuàng)建一個(gè)目錄，如果

37、他的父目錄不存在，也會(huì)被同時(shí)創(chuàng)建。它有一個(gè)屬性dir用來(lái)指定所創(chuàng)建的目錄名，其代碼如下：<mkdir dir="build/classes"/>如果build不存在，也會(huì)被同時(shí)創(chuàng)建。  2、<delete>刪除文件或者目錄， 如:屬性如下:file表示要?jiǎng)h除的文件。dir表示要?jiǎng)h除的目錄。includeEmptyDirs 表示指定是否要?jiǎng)h除空目錄，默認(rèn)值是刪除。failonerror 表示指定當(dāng)碰到錯(cuò)誤是否停止，默認(rèn)值是自動(dòng)停止。verbose 表示指定是否列出所刪除的文件，默認(rèn)值為不列出。 (1). 刪除一個(gè)文件<

38、;delete file="/lib/ant.jar"/>(2). 刪除指定目錄及其子目錄<delete dir="lib"/>(3). 刪除指定的一組文件<delete>    <fileset dir="." includes="*/*.bak"/></delete>(4). 刪除指定目錄及其子目錄，包括他自己<delete includeEmptyDirs="true">  

39、  <fileset dir="build"/></delete> 3、<jar>該標(biāo)簽用來(lái)生成一個(gè)jar文件，其屬性如下。destfile 表示jar文件名。basedir  表示被歸檔的文件夾。includes 表示被歸檔的文件模式。exchudes 表示被排除的文件模式。例如：<jar destfile="helloworld.jar" basedir="build/classes">   <manifest> 

40、;  <attribute name="Main-class" value="HelloWorld"/>   </manifest></jar> 4、<javac>該標(biāo)簽用于編譯一個(gè)或一組java文件，其屬性如下。srcdir 表示源文件的目錄。destdir 表示class文件的輸出目錄。include 表示被編譯的文件的模式。excludes 表示被排除的文件的模式。classpath 表示所使用的類(lèi)路徑。debug 表示包含的調(diào)試信息。optimize 表示是否

41、使用優(yōu)化。verbose 表示提供詳細(xì)的輸出信息。fileonerror 表示當(dāng)碰到錯(cuò)誤就自動(dòng)停止。 5、<java>該標(biāo)簽用來(lái)執(zhí)行編譯生成的.class文件，其屬性如下。classname 表示將執(zhí)行的類(lèi)名。jar 表示包含該類(lèi)的JAR文件名。classpath 所表示用到的類(lèi)路徑。fork 表示在一個(gè)新的虛擬機(jī)中運(yùn)行該類(lèi)。failonerror 表示當(dāng)出現(xiàn)錯(cuò)誤時(shí)自動(dòng)停止。output 表示輸出文件。append 表示追加或者覆蓋默認(rèn)文件。例如：<java classname="HelloWorld">   <c

42、lasspath>   <pathelement path="build/classes"/>   </classpath></java>  6、<copy>該標(biāo)簽用于文件或文件集的拷貝，其屬性如下。file 表示源文件。tofile 表示目標(biāo)文件。todir 表示目標(biāo)目錄。overwrite 表示指定是否覆蓋目標(biāo)文件，默認(rèn)值是不覆蓋。includeEmptyDirs 表示制定是否拷貝空目錄，默認(rèn)值為拷貝。failonerror 表示指定如目標(biāo)沒(méi)有發(fā)現(xiàn)是否自動(dòng)停

43、止，默認(rèn)值是停止。verbose 表示制定是否顯示詳細(xì)信息，默認(rèn)值不顯示。 (1). 拷貝單個(gè)的文件：<copy file="myfile.txt" tofile="mycopy.txt"/>(2). 拷貝單個(gè)的文件到指定目錄下<copy file="myfile.txt" todir="./some/other/dir"/>(3). 拷貝一個(gè)目錄到另外一個(gè)目錄下<copy todir="./new/dir">    &

44、lt;fileset dir="src_dir"/></copy>(4). 拷貝一批文件到指定目錄下<copy todir="./dest/dir">    <fileset dir="src_dir">      <exclude name="*/*.java"/>    </fileset></copy> <copy todir="./dest/dir">    <fileset dir="src_dir" excludes="*/*.java"/></copy>(5). 拷貝一批文件到指定目錄下，將文件