|
1 Ant是什么？ Apache Ant 是一個(gè)基于 Java的生成工具。 生成工具在軟件開(kāi)發(fā)中用來(lái)將源代碼和其他輸入文件轉(zhuǎn)換為可執(zhí)行文件的形式（也有可能轉(zhuǎn)換為可安裝的產(chǎn)品映像形式）。隨著應(yīng)用程序的生成過(guò)程變得更加復(fù)雜，確保在每次生成期間都使用精確相同的生成步驟，同時(shí)實(shí)現(xiàn)盡可能多的自動(dòng)化，以便及時(shí)產(chǎn)生一致的生成版本 2 下載、安裝Ant 安裝Ant 下載.zip文件，解壓縮到c:\ant1.3(后面引用為%ANT_HOME%) 2.1 在你運(yùn)行Ant之前需要做一些配置工作。 • 將bin目錄加入PATH環(huán)境變量。 • 設(shè)定ANT_HOME環(huán)境變量，指向你安裝Ant的目錄。在一些OS上，Ant的腳本可以猜測(cè)ANT_HOME（Unix和Windos NT/2000）－但最好不要依賴這一特性。 • 可選地，設(shè)定JAVA_HOME環(huán)境變量（參考下面的高級(jí)小節(jié)），該變量應(yīng)該指向你安裝JDK的目錄。 注意：不要將Ant的ant.jar文件放到JDK/JRE的lib/ext目錄下。Ant是個(gè)應(yīng)用程序，而lib/ext目錄是為JDK擴(kuò)展使用的（如JCE，JSSE擴(kuò)展）。而且通過(guò)擴(kuò)展裝入的類(lèi)會(huì)有安全方面的限制。 2.2 運(yùn)行Ant 運(yùn)行Ant非常簡(jiǎn)單，當(dāng)你正確地安裝Ant后，只要輸入ant就可以了。 沒(méi)有指定任何參數(shù)時(shí)，Ant會(huì)在當(dāng)前目錄下查詢build.xml文件。如果找到了就用該文件作為buildfile。如果你用 -find 選項(xiàng)。Ant就會(huì)在上級(jí)目錄中尋找buildfile，直至到達(dá)文件系統(tǒng)的根。要想讓Ant使用其他的buildfile，可以用參數(shù) -buildfile file，這里file指定了你想使用的buildfile。 可以指定執(zhí)行一個(gè)或多個(gè)target。當(dāng)省略target時(shí)，Ant使用標(biāo)簽<project>的default屬性所指定的target。 命令行選項(xiàng)總結(jié)： ant [options] [target [target2 [target3] ...]] Options: -help print this message -projecthelp print project help information -version print the version information and exit -quiet be extra quiet -verbose be extra verbose -debug print debugging information -emacs produce logging information without adornments -logfile file use given file for log output -logger classname the class that is to perform logging -listener classname add an instance of class as a project listener -buildfile file use specified buildfile -find file search for buildfile towards the root of the filesystem and use the first one found -Dproperty=value set property to value 例子 ant 使用當(dāng)前目錄下的build.xml運(yùn)行Ant，執(zhí)行缺省的target。 ant -buildfile test.xml 使用當(dāng)前目錄下的test.xml運(yùn)行Ant，執(zhí)行缺省的target。 ant -buildfile test.xml dist 使用當(dāng)前目錄下的test.xml運(yùn)行Ant，執(zhí)行一個(gè)叫做dist的target。 ant -buildfile test.xml -Dbuild=build/classes dist 使用當(dāng)前目錄下的test.xml運(yùn)行Ant，執(zhí)行一個(gè)叫做dist的target，并設(shè)定build屬性的值為build/classes。 3 編寫(xiě)build.xml Ant的buildfile是用XML寫(xiě)的。每個(gè)buildfile含有一個(gè)project。 buildfile中每個(gè)task元素可以有一個(gè)id屬性，可以用這個(gè)id值引用指定的任務(wù)。這個(gè)值必須是唯一的。（詳情請(qǐng)參考下面的Task小節(jié)） 3.1 Projects project有下面的屬性： Attribute Description Required name 項(xiàng)目名稱. No default 當(dāng)沒(méi)有指定target時(shí)使用的缺省target Yes basedir 用于計(jì)算所有其他路徑的基路徑。該屬性可以被basedir property覆蓋。當(dāng)覆蓋時(shí)，該屬性被忽略。如果屬性和basedir property都沒(méi)有設(shè)定，就使用buildfile文件的父目錄。 No 項(xiàng)目的描述以一個(gè)頂級(jí)的<description>元素的形式出現(xiàn)（參看description小節(jié)）。 一個(gè)項(xiàng)目可以定義一個(gè)或多個(gè)target。一個(gè)target是一系列你想要執(zhí)行的。執(zhí)行Ant時(shí)，你可以選擇執(zhí)行那個(gè)target。當(dāng)沒(méi)有給定target時(shí)，使用project的default屬性所確定的target。 3.2 Targets 一個(gè)target可以依賴于其他的target。例如，你可能會(huì)有一個(gè)target用于編譯程序，一個(gè)target用于生成可執(zhí)行文件。你在生成可執(zhí)行文件之前必須先編譯通過(guò)，所以生成可執(zhí)行文件的target依賴于編譯target。Ant會(huì)處理這種依賴關(guān)系。 然而，應(yīng)當(dāng)注意到，Ant的depends屬性只指定了target應(yīng)該被執(zhí)行的順序－如果被依賴的target無(wú)法運(yùn)行，這種depends對(duì)于指定了依賴關(guān)系的target就沒(méi)有影響。 Ant會(huì)依照depends屬性中target出現(xiàn)的順序（從左到右）依次執(zhí)行每個(gè)target。然而，要記住的是只要某個(gè)target依賴于一個(gè)target，后者就會(huì)被先執(zhí)行。 <target name="A"/> <target name="B" depends="A"/> <target name="C" depends="B"/> <target name="D" depends="C,B,A"/> 假定我們要執(zhí)行target D。從它的依賴屬性來(lái)看，你可能認(rèn)為先執(zhí)行C，然后B，最后A被執(zhí)行。錯(cuò)了，C依賴于B，B依賴于A，所以先執(zhí)行A，然后B，然后C，最后D被執(zhí)行。 一個(gè)target只能被執(zhí)行一次，即時(shí)有多個(gè)target依賴于它（看上面的例子）。 如果（或如果不）某些屬性被設(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="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)輸出。 將你的tstamp task在一個(gè)所謂的初始化target是很好的做法，其他的target依賴這個(gè)初始化target。要確保初始化target是出現(xiàn)在其他target依賴表中的第一個(gè)target。在本手冊(cè)中大多數(shù)的初始化target的名字是"init"。 target有下面的屬性： Attribute Description Required name target的名字 Yes depends 用逗號(hào)分隔的target的名字列表，也就是依賴表。 No if 執(zhí)行target所需要設(shè)定的屬性名。 No unless 執(zhí)行target需要清除設(shè)定的屬性名。 No description 關(guān)于target功能的簡(jiǎn)短描述。 No 3.3 Tasks 一個(gè)task是一段可執(zhí)行的代碼。 一個(gè)task可以有多個(gè)屬性（如果你愿意的話，可以將其稱之為變量）。屬性只可能包含對(duì)property的引用。這些引用會(huì)在task執(zhí)行前被解析。 下面是Task的一般構(gòu)造形式： <name attribute1="value1" 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。例如，在腳本中你可以這樣： <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。 3.4 Properties 一個(gè)project可以有很多的properties?？梢栽赽uildfile中用property task來(lái)設(shè)定，或在Ant之外設(shè)定。一個(gè)property有一個(gè)名字和一個(gè)值。property可用于task的屬性值。這是通過(guò)將屬性名放在"${"和"}"之間并放在屬性值的位置來(lái)實(shí)現(xiàn)的。例如如果有一個(gè)property builddir的值是"build"，這個(gè)property就可用于屬性值：${builddir}/classes。這個(gè)值就可被解析為build/classes。 內(nèi)置屬性 如果你使用了<property> task 定義了所有的系統(tǒng)屬性，Ant允許你使用這些屬性。例如，${os.name}對(duì)應(yīng)操作系統(tǒng)的名字。 要想得到系統(tǒng)屬性的列表可參考the Javadoc of System.getProperties。 除了Java的系統(tǒng)屬性，Ant還定義了一些自己的內(nèi)置屬性： basedir project基目錄的絕對(duì)路徑 (與<project>的basedir屬性一樣)。 ant.file buildfile的絕對(duì)路徑。 ant.version Ant的版本。 ant.project.name 當(dāng)前執(zhí)行的project的名字；由<project>的name屬性設(shè)定. ant.java.version Ant檢測(cè)到的JVM的版本； 目前的值有"1.1", "1.2", "1.3" and "1.4". 例子 <project name="MyProject" default="dist" basedir="."> <!-- set global properties for this build --> <property name="src" value="."/> <property name="build" value="build"/> <property name="dist" value="dist"/> <target name="init"> <!-- Create the time stamp --> <tstamp/> <!-- Create the build directory structure used by compile --> <mkdir dir="${build}"/> </target> <target name="compile" depends="init"> <!-- Compile the java code from ${src} into ${build} --> <javac srcdir="${src}" destdir="${build}"/> </target> <target name="dist" depends="compile"> <!-- Create the distribution directory --> <mkdir dir="${dist}/lib"/> <!-- Put everything in ${build} into the MyProject-${DSTAMP}.jar file --> <jar jarfile="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}"/> </target> <target name="clean"> <!-- Delete the ${build} and ${dist} directory trees --> <delete dir="${build}"/> <delete dir="${dist}"/> </target> </project> 3.5 Path-like Structures 你可以用":"和";"作為分隔符，指定類(lèi)似PATH和CLASSPATH的引用。Ant會(huì)把分隔符轉(zhuǎn)換為當(dāng)前系統(tǒng)所用的分隔符。 當(dāng)需要指定類(lèi)似路徑的值時(shí)，可以使用嵌套元素。一般的形式是 <classpath> <pathelement path="${classpath}"/> <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}"/> </classpath> 可以被簡(jiǎn)寫(xiě)作： <classpath path="${classpath}"/> 也可通過(guò)<fileset>元素指定路徑。構(gòu)成一個(gè)fileset的多個(gè)文件加入path-like structure的順序是未定的。 <classpath> <pathelement path="${classpath}"/> <fileset dir="lib"> <include name="**/*.jar"/> </fileset> <pathelement location="classes"/> </classpath> 上面的例子構(gòu)造了一個(gè)路徑值包括：${classpath}的路徑，跟著lib目錄下的所有jar文件，接著是classes目錄。 如果你想在多個(gè)task中使用相同的path-like structure，你可以用<path>元素定義他們（與target同級(jí)），然后通過(guò)id屬性引用－－參考Referencs例子。 path-like structure可能包括對(duì)另一個(gè)path-like structurede的引用（通過(guò)嵌套<path>元素）： <path id="base.path"> <pathelement path="${classpath}"/> <fileset dir="lib"> <include name="**/*.jar"/> </fileset> <pathelement location="classes"/> </path> <path id="tests.path"> <path refid="base.path"/> <pathelement location="testclasses"/> </path> 前面所提的關(guān)于<classpath>的簡(jiǎn)潔寫(xiě)法對(duì)于<path>也是有效的，如： <path id="tests.path"> <path refid="base.path"/> <pathelement location="testclasses"/> </path> 可寫(xiě)成： <path id="base.path" path="${classpath}"/> 命令行變量 有些task可接受參數(shù)，并將其傳遞給另一個(gè)進(jìn)程。為了能在變量中包含空格字符，可使用嵌套的arg元素。 Attribute Description Required value 一個(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"/> 是兩個(gè)空格分隔的命令行變量。 <arg path="/dir;/dir2:\dir3"/> 是一個(gè)命令行變量，其值在DOS系統(tǒng)上為\dir;\dir2;\dir3；在Unix系統(tǒng)上為/dir:/dir2:/dir3 。 References buildfile元素的id屬性可用來(lái)引用這些元素。如果你需要一遍遍的復(fù)制相同的XML代碼塊，這一屬性就很有用－－如多次使用<classpath>結(jié)構(gòu)。 下面的例子： <project ... > <target ... > <rmic ...> <classpath> <pathelement location="lib/"/> <pathelement path="${java.class.path}/"/> <pathelement path="${additional.path}"/> </classpath> </rmic> </target> <target ... > <javac ...> <classpath> <pathelement location="lib/"/> <pathelement path="${java.class.path}/"/> <pathelement path="${additional.path}"/> </classpath> </javac> </target> </project> 可以寫(xiě)成如下形式： <project ... > <path id="project.class.path"> <pathelement location="lib/"/> <pathelement path="${java.class.path}/"/> <pathelement path="${additional.path}"/> </path> <target ... > <rmic ...> <classpath refid="project.class.path"/> </rmic> </target> <target ... > <javac ...> <classpath refid="project.class.path"/> </javac> </target> </project> 所有使用PatternSets, FileSets 或 path-like structures嵌套元素的task也接受這種類(lèi)型的引用。 |
|
|
來(lái)自： raydian > 《我的圖書(shū)館》
