ant教程
1,什么是ant
ant是構(gòu)建工具
2,什么是構(gòu)建
概念到處可查到,形象來(lái)說(shuō),你要把代碼從某個(gè)地方拿來(lái),編譯,再拷貝到某個(gè)地方去等等操作,當(dāng)然不僅與此,但是主要用來(lái)干這個(gè)
3,ant的好處
跨平臺(tái) --因?yàn)閍nt是使用java實(shí)現(xiàn)的,所以它跨平臺(tái)
使用簡(jiǎn)單--與ant的兄弟make比起來(lái)
語(yǔ)法清晰--同樣是和make相比
功能強(qiáng)大--ant能做的事情很多,可能你用了很久,你仍然不知道它能有多少功能。當(dāng)你自己開發(fā)一些ant插件的時(shí)候,你會(huì)發(fā)現(xiàn)它更多的功能。
4,ant的兄弟make
ant做的很多事情,大部分是曾經(jīng)有一個(gè)叫make的所做的,不過(guò)對(duì)象不同,make更多應(yīng)用于c/c++ ,ant更多應(yīng)用于Java。當(dāng)然這不是一定的,但大部分人如此。
一,構(gòu)建ant環(huán)境
要使用ant首先要構(gòu)建一個(gè)ant環(huán)境,步驟很簡(jiǎn)單:
1),安裝jdk,設(shè)置JAVA_HOME ,PATH ,CLASS_PATH(這些應(yīng)該是看這篇文章的人應(yīng)該知道的)
2),下載ant 地址http://www.apache.org/找一個(gè)你喜歡的版本,或者干脆最新的版本
3),解壓ant 你得到的是一個(gè)壓縮包,解壓縮它,并把它放在一個(gè)盡量簡(jiǎn)單的目錄,例如D:\ant-1.6雖然你不一 定要這么做,但這么做是有好處的。
4),設(shè)置ANT_HOME PATH中添加ANT_HOME目錄下的bin目錄
5),測(cè)試一下你的設(shè)置,開始-->運(yùn)行-->cmd進(jìn)入命令行-->鍵入 ant 回車,如果看到
Buildfile: build.xml does not exist!
Build failed
那么恭喜你你已經(jīng)完成ant的設(shè)置
二,體驗(yàn)ant
就像每個(gè)語(yǔ)言都有HelloWorld一樣,一個(gè)最簡(jiǎn)單的應(yīng)用能讓人感受一下Ant
1,首先你要知道你要干什么,我現(xiàn)在想做的事情是:
編寫一些程序
編譯它們
把它打包成jar包
把他們放在應(yīng)該放置的地方
運(yùn)行它們
這里為了簡(jiǎn)單起見(jiàn)只寫一個(gè)程序,就是HelloWorld.java程序代碼如下:
package test.ant;
public class HelloWorld{
public static void main(String[] args){
System.out.println("Hello world1");
}
};
2,為了達(dá)到上邊的目的,你可以手動(dòng)的用javac 、copy 、jar、java來(lái)完成,但是考慮一下如果你有成百上千個(gè)類,在多次調(diào)試,部署的時(shí)候,一次次的javac 、copy、jar、
java那將是一份辛苦的工作。現(xiàn)在看看ant怎么優(yōu)雅的完成它們。
要運(yùn)行ant需要有一個(gè)build.xml雖然不一定要叫這個(gè)名字,但是建議你這么做
下邊就是一個(gè)完整的build.xml,然后我們來(lái)詳細(xì)的解釋每一句
<?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中的第一句話,沒(méi)有實(shí)際的意義
<project name="HelloWorld" default="run" basedir=".">
</project>
ant的所有內(nèi)容必須包含在這個(gè)里邊,name是你給它取的名字,basedir故名思意就是工作的根目錄 .代表當(dāng)前目錄。default代表默認(rèn)要做的事情。
<property name="src" value="src"/>
類似程序中的變量,為什么這么做想一下變量的作用
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${dest}"/>
</target>
把你想做的每一件事情寫成一個(gè)target ,它有一個(gè)名字,depends是它所依賴的target,在執(zhí)行這個(gè)target 例如這里的compile之前ant會(huì)先檢查init是否曾經(jīng)被執(zhí)行過(guò),如果執(zhí)行
過(guò)則直接直接執(zhí)行compile,如果沒(méi)有則會(huì)先執(zhí)行它依賴的target例如這里的init,然后在執(zhí)行這個(gè)target
如我們的計(jì)劃
編譯:
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${dest}"/>
</target>
做jar包:
<target name="build" depends="compile">
<jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
運(yùn)行:
<target name="run" depends="build">
<java classname="test.ant.HelloWorld" classpath="${hello_jar}"/>
</target>
為了不用拷貝,我們可以在最開始定義好目標(biāo)文件夾,這樣ant直接把結(jié)果就放在目標(biāo)文件夾中了
新建文件夾:
<target name="init">
<mkdir dir="${dest}"/>
</target>
為了更多一點(diǎn)的功能體現(xiàn),又加入了兩個(gè)target
刪除生成的文件
<target name="clean">
<delete dir="${dest}" />
<delete file="${hello_jar}" />
</target>
再次運(yùn)行,這里顯示了如何在一個(gè)target里邊調(diào)用其他的target
<target name="rerun" depends="clean,run">
<ant target="clean" />
<ant target="run" />
</target>
好了,解釋完成了,下邊檢驗(yàn)一下你的ant吧
新建一個(gè)src的文件夾,然后把HelloWorld.java按照包目錄放進(jìn)去
做好build.xml文件
在命令行下鍵入ant ,你會(huì)發(fā)現(xiàn)一個(gè)個(gè)任務(wù)都完成了。每次更改完代碼只需要再次鍵入ant
有的時(shí)候我們可能并不想運(yùn)行程序,只想執(zhí)行這些步驟中的某一兩個(gè)步驟,例如我只想重新部署而不想運(yùn)行,鍵入
ant build
ant中的每一個(gè)任務(wù)都可以這樣調(diào)用ant + target name
好了,這樣一個(gè)簡(jiǎn)單的ant任務(wù)完成了。
一,什么時(shí)候使用ant
也許你聽到別人說(shuō)起ant,一時(shí)沖動(dòng)準(zhǔn)備學(xué)習(xí)一下ant,當(dāng)你看完了上邊的第一個(gè)實(shí)例,也許你感覺(jué)ant真好,也許你感覺(jué)ant不過(guò)如此,得出這些結(jié)論都不能說(shuō)錯(cuò),雖然ant很好用,
但并不是在任何情況下都是最好的選擇,例如windows上有更多更簡(jiǎn)單,更容易使用的工具,比如eclipse+myeclipse eclipse+wtp等等,無(wú)論是編譯,部署,運(yùn)行使用起來(lái)比ant更
容易,方便但有些情況則是ant發(fā)揮的好地方:
1,服務(wù)器上部署的時(shí)候
當(dāng)你的程序開發(fā)完成,部署人員要部署在服務(wù)器上的時(shí)候,總不能因?yàn)橐驗(yàn)榘惭b一個(gè)程序就配置一個(gè)eclipse+myeclipse吧,ant在這個(gè)時(shí)候是個(gè)很好的選擇,因?yàn)樗∏桑菀着?br />
置,你帶著你寫好的build.xml到任何一臺(tái)服務(wù)器上,只需要做簡(jiǎn)單的修改(一些設(shè)定,例如目錄),然后一兩個(gè)命令完成,這難道不是一件美好的事情嗎。
2,linux上,很多時(shí)候是這樣的,程序開發(fā)是在windows下,但是程序要在linux或者unix上運(yùn)行,在linux或者
在unix(特別是unix上)部署是個(gè)麻煩的事情,這個(gè)時(shí)候ant的特點(diǎn)又出來(lái)了,因?yàn)閍nt是跨平臺(tái)的,你在build.xml可以在大多數(shù)操作系統(tǒng)上使用,基本不需要修改。
3,當(dāng)服務(wù)器維護(hù)者不懂編程的時(shí)候
很多人都有過(guò)這樣的經(jīng)歷,使用你們程序的人,并不懂得寫程序。你得程序因?yàn)榘姹靖拢驗(yàn)樾拚齜ug需要一次又一次得重新部署。這個(gè)時(shí)候你會(huì)發(fā)現(xiàn)教一個(gè)人是如此得困難。但
是有ant后,你只需要告訴他,輸入ant xxx等一兩個(gè)命令,一切ok.
以上是我遇到得一些情況。
看完以上得情況,好好考慮一下,你是否需要使用ant,如果是繼續(xù)。
進(jìn)一步學(xué)習(xí)一個(gè)稍微復(fù)雜一點(diǎn)點(diǎn)的ant
在實(shí)際的工作過(guò)程中可能會(huì)出現(xiàn)以下一些情況,一個(gè)項(xiàng)目分成很多個(gè)模塊,每個(gè)小組或者部門負(fù)責(zé)一個(gè)模塊,為了測(cè)試,他們自己寫了一個(gè)build.xml,而你負(fù)責(zé)把這些模塊組合到
一起使用,寫一個(gè)build.xml
這個(gè)時(shí)候你有兩種選擇:
1,自己重新寫一個(gè)build.xml ,這將是一個(gè)麻煩的事情
2,盡量利用他們已經(jīng)寫好的build.xml,減少自己的工作
舉個(gè)例子:
假設(shè)你下邊有三個(gè)小組,每個(gè)小組負(fù)責(zé)一個(gè)部分,他們分別有一個(gè)src 和一個(gè)寫好的build.xml
這個(gè)時(shí)候你拿到他們的src,你需要做的是建立三個(gè)文件夾src1 ,src2, src3分別把他們的src和build.xml放進(jìn)去,然后寫一個(gè)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你的任務(wù)完成了。
ok,上邊你完成了任務(wù),但是你是否有些感觸呢,在那些build.xml中,大多數(shù)是重復(fù)的,而且更改一次目錄需要更改不少東西。是否能讓工作做的更好一點(diǎn)呢,答案是肯定的。
引入兩個(gè)東西:
1,propery
2,xml include
這兩個(gè)東西都有一個(gè)功能,就是能把build.xml中<propery />中的內(nèi)容分離出來(lái),共同使用
除此之外它們各有特點(diǎn):
propery的特點(diǎn)是維護(hù)簡(jiǎn)單,只需要簡(jiǎn)單的鍵值對(duì),因?yàn)椴⒉皇撬腥硕枷矚gxml的格式
xml include的特點(diǎn)是不單可以提取出屬性來(lái),連target也可以。
還是以前的例子:
例如我們想把src1 src2 src3這三個(gè)屬性從xml中提出來(lái),可以新建一個(gè)文件叫all.properties
里邊的內(nèi)容
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>
如果你自己看的話你會(huì)看到這樣一個(gè)target
<target name="test">
<ant dir="${src1}" target="test" />
<ant dir="${src2}" target="test" />
<ant dir="${src3}" target="test" />
</target>
有的時(shí)候你想給每個(gè)小組的build.xml加入幾個(gè)target,一種做法是每個(gè)里邊寫,然后在這里調(diào)用
但是有一種更好的方法。
你可以寫一個(gè)include.xml文件,內(nèi)容如下
<?xml version="1.0" encoding="UTF-8" ?>
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<target name="test" >
<ant target="run" />
</target>
然后更改你三個(gè)小組的build.xml文件,每個(gè)里邊加入如下內(nèi)容
<!--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;
變成如下的樣子
這個(gè)時(shí)候,你只要在include.xml添加propery , 添加target,三個(gè)build.xml會(huì)同時(shí)添加這些propery和target
而且不會(huì)讓三個(gè)組的build.xml變得更復(fù)雜。
<?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>
掌握了上邊的那些內(nèi)容之后,你就知道如何去寫一個(gè)好的ant,但是你會(huì)發(fā)現(xiàn)當(dāng)你真的想去做的時(shí)候,你不能馬上作出好的build.xml,因?yàn)槟阒捞俚腶nt的默認(rèn)提供的命令.這
個(gè)時(shí)候如果你想完成任務(wù),并提高自己,有很多辦法:
1,很多開源的程序都帶有build.xml,看看它們?nèi)绾螌懙?br />
2,ant的document,里邊詳細(xì)列寫了ant的各種默認(rèn)命令,及其豐富
3,google,永遠(yuǎn)不要忘記它
ok,在這之后隨著你寫的ant build越來(lái)越多,你知道的命令就越多,ant在你的手里也就越來(lái)越強(qiáng)大了。
這個(gè)是一個(gè)慢慢積累的過(guò)程。
ant的例子很好找,各種開源框架都會(huì)帶有一個(gè)build.xml仔細(xì)看看,會(huì)有很大收獲
另外一個(gè)經(jīng)常會(huì)用到的,但是在開源框架的build.xml一般沒(méi)有的是cvs
如果使用的是遠(yuǎn)程的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
因?yàn)閑clipse提供了提示功能,自動(dòng)補(bǔ)充功能,它能讓你事半功倍。
使用方法,只需要建立一個(gè)工程,然后建立一個(gè)叫build.xml的文件。然后就可以在里邊寫你的ant build了
但是時(shí)刻記住http://www.apache.org/永遠(yuǎn)能找到你需要的東西