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

          posted on 2007-08-19 05:05 前方的路 閱讀(638) 評論(1)  編輯  收藏 所屬分類: Java技術(shù)

          評論:
          # re: Apache Ant使用指南 2011-07-27 19:18 | 創(chuàng)新捕手
          頂一下,寫的不錯  回復(fù)  更多評論
            
          主站蜘蛛池模板: 津南区| 马尔康县| 望都县| 贵定县| 广饶县| 巴东县| 墨脱县| 秀山| 阿克苏市| 乐东| 梁河县| 曲麻莱县| 科技| 大邑县| 海伦市| 柞水县| 武城县| 紫阳县| 界首市| 谢通门县| 梨树县| 开平市| 中阳县| 田林县| 龙里县| 女性| 南汇区| 淅川县| 南宁市| 商丘市| 资溪县| 宜昌市| 会理县| 新宁县| 梁平县| 广昌县| 福海县| 平安县| 莱阳市| 赤城县| 安塞县|