1. 程式人生 > >ant 入門級詳解

ant 入門級詳解

轉載的地址(也是轉載,未找到原文地址)】:https://www.cnblogs.com/jsfx/p/6233645.html

1,什麼是ant
ant是構建工具
2,什麼是構建
概念到處可查到,形象來說,你要把程式碼從某個地方拿來,編譯,再拷貝到某個地方去等等操作,當然不僅與此,但是主要用來幹這個
3,ant的好處
跨平臺   --因為ant是使用java實現的,所以它跨平臺
使用簡單--與ant的兄弟make比起來
語法清晰--同樣是和make相比
功能強大--ant能做的事情很多,可能你用了很久,你仍然不知道它能有多少功能。當你自己開發一些ant外掛的時候,你會發現它更多的功能。
4,ant的兄弟make
ant做的很多事情,大部分是曾經有一個叫make的所做的,不過物件不同,make更多應用於c/c++ ,ant更多應用於Java。當然這不是一定的,但大部分人如此。
一,構建ant環境
要使用ant首先要構建一個ant環境,步驟很簡單:
1),安裝jdk,設定JAVA_HOME ,PATH ,CLASS_PATH(這些應該是看這篇文章的人應該知道的)
2),下載ant 地址http://www.apache.org/

找一個你喜歡的版本,或者乾脆最新的版本
3),解壓ant 你得到的是一個壓縮包,解壓縮它,並把它放在一個儘量簡單的目錄,例如D:\ant-1.6雖然你不一 定要這麼做,但這麼做是有好處的。
4),設定ANT_HOME PATH中新增ANT_HOME目錄下的bin目錄
5),測試一下你的設定,開始-->執行-->cmd進入命令列-->鍵入 ant 回車,如果看到
Buildfile: build.xml does not exist!
Build failed
那麼恭喜你你已經完成ant的設定
二,體驗ant
就像每個語言都有HelloWorld一樣,一個最簡單的應用能讓人感受一下Ant
1,首先你要知道你要幹什麼,我現在想做的事情是:
編寫一些程式
編譯它們
把它打包成jar包
把他們放在應該放置的地方
執行它們
這裡為了簡單起見只寫一個程式,就是HelloWorld.java程式程式碼如下:
package test.ant;
public class HelloWorld{
public static void main(String[] args){
   System.out.println("Hello world1");
}
};
2,為了達到上邊的目的,你可以手動的用javac 、copy 、jar、java來完成,但是考慮一下如果你有成百上千個類,在多次除錯,部署的時候,一次次的javac 、copy、jar、
java那將是一份辛苦的工作。現在看看ant怎麼優雅的完成它們。
要執行ant需要有一個build.xml雖然不一定要叫這個名字,但是建議你這麼做
下邊就是一個完整的build.xml,然後我們來詳細的解釋每一句
<?xml version="1.0" encoding="UTF-8" ?>
<project name="HelloWorld" default="run" basedir=".">
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<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">
   <jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
<target name="run" depends="build">
   <java classname="test.ant.HelloWorld" classpath="${hello_jar}"/>
</target>
<target name="clean">
   <delete dir="${dest}" />
   <delete file="${hello_jar}" />
</target>
<target name="rerun" depends="clean,run">
   <ant target="clean" />
   <ant target="run" />
</target>
</project>
解釋:
<?xml version="1.0" encoding="UTF-8" ?>
build.xml中的第一句話,沒有實際的意義
<project name="HelloWorld" default="run" basedir=".">
</project>
ant的所有內容必須包含在這個裡邊,name是你給它取的名字,basedir故名思意就是工作的根目錄 .代表當前目錄。default代表預設要做的事情。
<property name="src" value="src"/>
類似程式中的變數,為什麼這麼做想一下變數的作用
<target name="compile" depends="init">
   <javac srcdir="${src}" destdir="${dest}"/>
</target>
把你想做的每一件事情寫成一個target ,它有一個名字,depends是它所依賴的target,在執行這個target 例如這裡的compile之前ant會先檢查init是否曾經被執行過,如果執行
過則直接直接執行compile,如果沒有則會先執行它依賴的target例如這裡的init,然後在執行這個target
如我們的計劃
編譯:
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${dest}"/>
</target>
做jar包:
<target name="build" depends="compile">
<jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
執行:
<target name="run" depends="build">
<java classname="test.ant.HelloWorld" classpath="${hello_jar}"/>
</target>
為了不用拷貝,我們可以在最開始定義好目標資料夾,這樣ant直接把結果就放在目標資料夾中了
新建資料夾:
<target name="init">
<mkdir dir="${dest}"/>
</target>
為了更多一點的功能體現,又加入了兩個target
刪除生成的檔案
<target name="clean">
<delete dir="${dest}" />
<delete file="${hello_jar}" />
</target>
再次執行,這裡顯示瞭如何在一個target裡邊呼叫其他的target
<target name="rerun" depends="clean,run">
<ant target="clean" />
<ant target="run" />
</target>
好了,解釋完成了,下邊檢驗一下你的ant吧
新建一個src的資料夾,然後把HelloWorld.java按照包目錄放進去
做好build.xml檔案
在命令列下鍵入ant ,你會發現一個個任務都完成了。每次更改完程式碼只需要再次鍵入ant
有的時候我們可能並不想執行程式,只想執行這些步驟中的某一兩個步驟,例如我只想重新部署而不想執行,鍵入
ant build
ant中的每一個任務都可以這樣呼叫ant + target name
好了,這樣一個簡單的ant任務完成了。


一,什麼時候使用ant
也許你聽到別人說起ant,一時衝動準備學習一下ant,當你看完了上邊的第一個例項,也許你感覺ant真好,也許你感覺ant不過如此,得出這些結論都不能說錯,雖然ant很好用,
但並不是在任何情況下都是最好的選擇,例如windows上有更多更簡單,更容易使用的工具,比如eclipse+myeclipse eclipse+wtp等等,無論是編譯,部署,執行使用起來比ant更
容易,方便但有些情況則是ant發揮的好地方:
1,伺服器上部署的時候
當你的程式開發完成,部署人員要部署在伺服器上的時候,總不能因為因為安裝一個程式就配置一個eclipse+myeclipse吧,ant在這個時候是個很好的選擇,因為它小巧,容易配
置,你帶著你寫好的build.xml到任何一臺伺服器上,只需要做簡單的修改(一些設定,例如目錄),然後一兩個命令完成,這難道不是一件美好的事情嗎。
2,linux上,很多時候是這樣的,程式開發是在windows下,但是程式要在linux或者unix上執行,在linux或者
在unix(特別是unix上)部署是個麻煩的事情,這個時候ant的特點又出來了,因為ant是跨平臺的,你在build.xml可以在大多數作業系統上使用,基本不需要修改。
3,當伺服器維護者不懂程式設計的時候
很多人都有過這樣的經歷,使用你們程式的人,並不懂得寫程式。你得程式因為版本更新,因為修正bug需要一次又一次得重新部署。這個時候你會發現教一個人是如此得困難。但
是有ant後,你只需要告訴他,輸入ant xxx等一兩個命令,一切ok.
以上是我遇到得一些情況。
看完以上得情況,好好考慮一下,你是否需要使用ant,如果是繼續。

進一步學習一個稍微複雜一點點的ant
在實際的工作過程中可能會出現以下一些情況,一個專案分成很多個模組,每個小組或者部門負責一個模組,為了測試,他們自己寫了一個build.xml,而你負責把這些模組組合到
一起使用,寫一個build.xml
這個時候你有兩種選擇:
1,自己重新寫一個build.xml ,這將是一個麻煩的事情
2,儘量利用他們已經寫好的build.xml,減少自己的工作
舉個例子:
假設你下邊有三個小組,每個小組負責一個部分,他們分別有一個src 和一個寫好的build.xml
這個時候你拿到他們的src,你需要做的是建立三個資料夾src1 ,src2, src3分別把他們的src和build.xml放進去,然後寫一個build.xml
<?xml version="1.0" encoding="UTF-8" ?>
<project name="main" default="build" basedir=".">
<property name="bin" value="${basedir}\bin" />
<property name="src1" value="${basedir}\src1" />
<property name="src2" value="${basedir}\src2" />
<property name="src3" value="${basedir}\src3" />
<target name="init">
   <mkdir dir="${bin}" />
</target>
<target name="run">
   <ant dir="${src1}" target="run" />
   <ant dir="${src2}" target="run" />
   <ant dir="${src3}" target="run" />
</target>
<target name="clean">
   <ant dir="${src1}" target="clean" />
   <ant dir="${src2}" target="clean" />
   <ant dir="${src3}" target="clean" />
</target>
<target name="build" depends="init,call">
   <copy todir="${bin}">
    <fileset dir="${src1}">
     <include name="*.jar" />
    </fileset>
    <fileset dir="${src2}">
     <include name="*.jar" />
    </fileset>
    <fileset dir="${src3}">
     <include name="*.jar" />
    </fileset>
   </copy>
</target>
<target name="rebuild" depends="build,clean">
   <ant target="clean" />
   <ant target="build" />
</target>
</project>
ok你的任務完成了。

ok,上邊你完成了任務,但是你是否有些感觸呢,在那些build.xml中,大多數是重複的,而且更改一次目錄需要更改不少東西。是否能讓工作做的更好一點呢,答案是肯定的。
引入兩個東西:
1,propery
2,xml include
這兩個東西都有一個功能,就是能把build.xml中<propery />中的內容分離出來,共同使用
除此之外它們各有特點:
propery的特點是維護簡單,只需要簡單的鍵值對,因為並不是所有人都喜歡xml的格式
xml include的特點是不單可以提取出屬性來,連target也可以。
還是以前的例子:
例如我們想把src1 src2 src3這三個屬性從xml中提出來,可以新建一個檔案叫all.properties
裡邊的內容
src1=D:\\study\\ant\\src1
src2=D:\\study\\ant\\src2
src3=D:\\study\\ant\\src3
然後你的build.xml檔案可以這樣寫,別人只需要更改配置檔案,而不許要更改你的build.xml檔案了
<?xml version="1.0" encoding="UTF-8" ?>
<project name="main" default="build" basedir=".">
<property file="all.properties" />
<property name="bin" value="${basedir}\bin" />
<target name="init">
   <mkdir dir="${bin}" />
</target>
<target name="run">
   <ant dir="${src1}" target="run" />
   <ant dir="${src2}" target="run" />
   <ant dir="${src3}" target="run" />
</target>
<target name="clean">
   <ant dir="${src1}" target="clean" />
   <ant dir="${src2}" target="clean" />
   <ant dir="${src3}" target="clean" />
</target>
<target name="build" depends="init,call">
   <copy todir="${bin}">
    <fileset dir="${src1}">
     <include name="*.jar" />
    </fileset>
    <fileset dir="${src2}">
     <include name="*.jar" />
    </fileset>
    <fileset dir="${src3}">
     <include name="*.jar" />
    </fileset>
   </copy>
</target>
<target name="rebuild" depends="build,clean">
   <ant target="clean" />
   <ant target="build" />
</target>
<target name="test">
   <ant dir="${src1}" target="test" />
   <ant dir="${src2}" target="test" />
   <ant dir="${src3}" target="test" />
</target>
</project>
如果你自己看的話你會看到這樣一個target
<target name="test">
<ant dir="${src1}" target="test" />
<ant dir="${src2}" target="test" />
<ant dir="${src3}" target="test" />
</target>
有的時候你想給每個小組的build.xml加入幾個target,一種做法是每個裡邊寫,然後在這裡呼叫
但是有一種更好的方法。
你可以寫一個include.xml檔案,內容如下
<?xml version="1.0" encoding="UTF-8" ?>
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<target name="test" >
<ant target="run" />
</target>
然後更改你三個小組的build.xml檔案,每個裡邊加入如下內容
<!--include a xml file ,it can be common propery ,can be also a target   -->
<!DOCTYPE project [
<!ENTITY share-variable SYSTEM "file:../include.xml">
]>
&share-variable;
變成如下的樣子
這個時候,你只要在include.xml新增propery , 新增target,三個build.xml會同時新增這些propery和target
而且不會讓三個組的build.xml變得更復雜。
<?xml version="1.0" encoding="UTF-8" ?>
<!--include a xml file ,it can be common propery ,can be also a target   -->
<!DOCTYPE project [
<!ENTITY share-variable SYSTEM "file:../include.xml">
]>
<project name="HelloWorld" default="run" basedir=".">
<!--use the include   -->
&share-variable;
<!--defined the property-->
<!--via include
<property name="src" value="src"/>
<property name="dest" value="classes"/>
-->
<property name="hello_jar" value="hello1.jar"/>
<!--define the op-->
<target name="init">
   <mkdir dir="${dest}"/>
</target>
<target name="compile" depends="init">
   <javac srcdir="${src}" destdir="${dest}"/>
</target>
<target name="build" depends="compile">
   <jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
<target name="run" depends="build">
   <java classname="test.ant.HelloWorld" classpath="${hello_jar}"/>
</target>
<target name="clean">
   <delete dir="${dest}" />
   <delete file="${hello_jar}" />
</target>
<target name="rerun" depends="clean,run">
   <ant target="clean" />
   <ant target="run" />
</target>
</project>

掌握了上邊的那些內容之後,你就知道如何去寫一個好的ant,但是你會發現當你真的想去做的時候,你不能馬上作出好的build.xml,因為你知道太少的ant的預設提供的命令.這
個時候如果你想完成任務,並提高自己,有很多辦法:
1,很多開源的程式都帶有build.xml,看看它們如何寫的
2,ant的document,裡邊詳細列寫了ant的各種預設命令,及其豐富
3,google,永遠不要忘記它
ok,在這之後隨著你寫的ant build越來越多,你知道的命令就越多,ant在你的手裡也就越來越強大了。
這個是一個慢慢積累的過程。

ant的例子很好找,各種開源框架都會帶有一個build.xml仔細看看,會有很大收穫
另外一個經常會用到的,但是在開源框架的build.xml一般沒有的是cvs
如果使用的是遠端的cvs,可以這樣使用
<xml version="1.0" encoding="utf-8"?>
<project>
      <property name="cvsroot" value=":pserver:wang:@192.168.1.2:/cvsroot"/>
      <property name="basedir" value="/tmp/testant/"/>
      <property name="cvs.password" value="wang"/>
      <property name="cvs.passfile" value="${basedir}/ant.cvspass"/>
      <target name="initpass">
              <cvspass cvsroot="${cvsroot}" password="${cvs.password}" passfile="${cvs.passfile}"/>
      </target>
      <target name="checkout" depends="initpass">
              <cvs cvsroot="${cvsroot}" command="checkout" cvsrsh="ssh" package="myproject" dest="${basedir}"
               passfile="${cvs.passfile}"/>
       </target>
</project>

在eclipse裡邊先天支援ant,所以你可以在eclipse裡邊直接寫build.xml
因為eclipse提供了提示功能,自動補充功能,它能讓你事半功倍。
使用方法,只需要建立一個工程,然後建立一個叫build.xml的檔案。然後就可以在裡邊寫你的ant build了
但是時刻記住http://www.apache.org/永遠能找到你需要的東西