?

l ???????? Ant 工程 (project) 中由若干個構(gòu)建目標(biāo) (target) 組成，構(gòu)建目標(biāo)是一組相關(guān)任務(wù) (Tasks) 的集合，如編譯文件、創(chuàng)建目錄、打包等，構(gòu)建目標(biāo)之間可以建立依賴關(guān)系，構(gòu)建目標(biāo)執(zhí)行之前必須先執(zhí)行所有所依賴的構(gòu)建目標(biāo)。 Ant 工程通過 project 的 default 屬性指定默認(rèn)的構(gòu)建目標(biāo)名稱。構(gòu)建目標(biāo)的 XML 元素為 target ，其可用的屬性為：

?

?

l ???????? 構(gòu)建任務(wù) (Tasks) 是構(gòu)建目標(biāo) (target) 的基本組成部分，是 Ant 構(gòu)建的基本執(zhí)行單元。 Ant 中存在很多內(nèi)建的構(gòu)建任務(wù)，如下表所示：

?

?

Ant 除了核心任務(wù) (Core Tasks) 之外還可以使用可選任務(wù)，但使用可選任務(wù)時需要額外的 jar 庫文件的支持，這些庫文件需要存放在 Ant 的 lib 目錄下。有了這些可選任務(wù) Ant 可以做更多的事情，如 ftp 、編譯 .Net 工程，使用 ClearCase 等。

?

?

l ???????? 工程屬性 (properties) 是除了構(gòu)建目標(biāo) (target) 、構(gòu)建任務(wù) (tasks) 之外的另一個 Ant 支柱，工程屬性其實是一個名稱 - 值對，可以在構(gòu)建任務(wù)的 XML 元素中使用，使用方式為： ${property-name} 。工程屬性的 XML 元素為 property ，其可用的 XML 屬性為：

?

?

l ???????? Ant 的內(nèi)建屬性：

ant.file

Contains the absolute path of the build file

ant.java.version

Contains the JVM version Ant is using (can hold only 1.1, 1.2, 1.3, 1.4 and [as of Ant 1.6] 1.5)

ant.project.name

Holds the name of the project that is executing (set with the name attribute of project)

ant.version

Contains the version of Ant running

basedir

Holds the absolute path of the project's base directory (set with the basedir attribute of project)

l ???????? Ant 的運(yùn)行： ant [options] [target [target2 [target3] ...]] ，在 options 中可以指定要執(zhí)行的構(gòu)建文件，默認(rèn)為 build.xml ，如果構(gòu)建文件為 project.xml ，則相應(yīng)用 ant 命令為 : ant –f project.xml ， target 可以指定多個，之間用空格分隔，如果未指定則使用構(gòu)建文件中的默認(rèn)目標(biāo)。

?

?

?

?

?

?

?

?

?

?

?

?

第二章： Using Properties and Types

l ???????? Condition 任務(wù)用于控制其他任務(wù)的執(zhí)行：在 Condition 任務(wù)中設(shè)置屬性值，而在其他任務(wù)中根據(jù)這些屬性值的內(nèi)容決定是否執(zhí)行，如：

<condition property="all.set">

??? ????<and>

????? ????? <available file="file1.java"/>

????? ???????<available file="file2.java"/>

??? ????</and>

</condition>

這個任務(wù)用于判斷 file1.java 和 file2.java 是否存在，如果都存在，則設(shè)置 all.set 屬性為 true ，否則為 false;

除了示例中出現(xiàn)的 condition 和 and 條件任務(wù)外還有 available 、 or 、 equals 等其他條件任務(wù)。

l ???????? 在任務(wù)中添加 if 或 unless 可以決定任務(wù)是否執(zhí)行，繼上例：

														<target name="buildModule" if="all.set"/>
												

														
																??????? . . .
												

														</target>
												

這個任務(wù)當(dāng) all.set 為 true 時執(zhí)行，否則不執(zhí)行。

l ???????? fail 任務(wù)用于中斷構(gòu)建，如：

														
																<fail message="Could not find all files." unless="all.set" />
														
												

當(dāng) all.set 為 false 時中斷構(gòu)建，并輸出 ” Could not find all files.”

l ???????? 從文件裝入屬性： <property file="build.properties" />

l ???????? 將文件內(nèi)容作為單個屬性裝入：

<loadfile property="message" srcFile="message.txt"/>

l ???????? 屬性可以設(shè)置多次，后頁的屬性會覆蓋前頁的屬性值。

l ???????? 通過命令行設(shè)置屬性值：使用 -D 選項

ant -Dmessage="Compiling and compressing"

l ???????? 使用環(huán)境變量作為屬性值，如：

<property environment="env" />

加上這句以后可以使用如下方式獲取環(huán)境變量 JAVA_HOME 的值：

${env.JAVA_HOME} ，其他環(huán)境變量也通過類似方式獲得。

l ???????? fileset 用于指定文件集，并設(shè)置到屬性中用于其他任務(wù)的構(gòu)建，如文件復(fù)制、編譯等， fileset 的示例如下：

<fileset dir="${source}">

??? <include name="**/*.java"/>

??? <exclude name="**/*test*"/>

</fileset>

include 用于包含文件， exclude 用于排除文件，通配符 ** 表示當(dāng)前目錄或當(dāng)前目錄下的所有子目錄。除了使用 include 和 exclude 之外還可以使用 filename 來指定加入文件集的特定文件，如：

<fileset dir="${source}">

??? <filename name="**/*.java"/>

??? <filename name="test.cpp"/>

</fileset>

l ???????? 使用 fileset 的示例 :

<copy todir="../dest">

??? <fileset dir="src">

??????? <exclude name="**/*.java"/>

??? </fileset>

</copy>

這個任務(wù)將 fileset 中的文件復(fù)制到 ../dest 目錄下

l ???????? 相對于 fileset 還可以使用 dirset 表示目錄集，使用與 fileset 類同。

?

?

?

?

?

?

?

?

?

?

第三章： Building Java Code

l ???????? javac 任務(wù)用于編譯 java 源代碼，如：

<javac srcdir="${src}"

??? debug="on"

??? destdir="${bin}"

??? classpath="common.jar"

/>

l ???????? input 任務(wù)可接收用戶輸入，如：

<target name="init">

??? <input

??????? message="Deleting bin directory OK?"

??????? validargs="y,n"

??????? addproperty="do.delete"

??? />

??? <condition property="do.abort">

??????? <equals arg1="n" arg2="${do.delete}"/>

? ??</condition>

??? <fail if="do.abort">Build aborted.</fail>

??? <delete dir="${output}" />

??? <mkdir dir="${output}" />

</target>

l ???????? 在同一構(gòu)建文件中可以使用 antcall 任務(wù)執(zhí)行另一個構(gòu)建任務(wù)，并可指定構(gòu)建參數(shù)作為構(gòu)建屬性，如：

<target name="main" depends="init, compile, compress">

?? <antcall target="displayMessage">

?????? <param name="msg" value="${message}"/>

?? </antcall>

</target>

<target name="displayMessage">

??? <echo message="msg=${msg}"/>

</target>

在本例中 main 任務(wù)調(diào)用了 displayMessage 任務(wù)，并設(shè)置 msg 參數(shù)作為調(diào)用屬性，在 displayMessage 任務(wù)中可以通過 ${msg} 獲取該屬性值。

l ???????? 使用 ant 任務(wù)執(zhí)行另一 Ant 構(gòu)建文件，如：

<ant antfile="subproject/subbuild.xml">

??? <property name="parameter" value="4096"/>

??? <property file="config/subproject/build.properties"/>

</ant>

本例中執(zhí)行了另一以 subproject/subbuild.xml 為構(gòu)建文件的 Ant 構(gòu)建，將指定了構(gòu)建的屬性值，除此之外還可指定構(gòu)建目標(biāo)等其他選項。

l ???????? 使用 import 導(dǎo)入其他構(gòu)建文件的內(nèi)容，如：

<import file="shared.xml"/>

l ???????? 使用 javadoc 任務(wù)創(chuàng)建 java 文檔，如：

<javadoc

???? sourcefiles="${src}/Project.java"

???? destdir="${docs}"

???? author="true"

???? version="true"

???? use="true"

???? windowtitle="Project API">

???? <doctitle><![CDATA[<h1>Project API</h1>]]></doctitle>

???? <bottom><![CDATA[<i>Copyright &#169; 2005</i>]]></bottom>

</javadoc>

l ???????? 使用 jar 任務(wù)創(chuàng)建 jar 包，如 :

<jar destfile="${output}/Project.jar" basedir="${output}"

???? includes="*.class" >

???? <manifest>

???????? <attribute name="Author" value="${user.name}"/>

???????? <section name="Shared">

???????????? <attribute name="Title" value="Example"/>

???????????? <attribute name="Vendor" value="MegaAntCo"/>

???????? </section>

???????? <section name="Copyright">

???????????? <attribute name="Copy" value="(C) MegaAntCo 2005"/>

???????? </section>

???? </manifest>

</jar>

l ???????? 使用 buildnumber 任務(wù)讀取并創(chuàng)建構(gòu)建序號， buildnumber 從文件 ( 默認(rèn)為 build.number) 中讀取原構(gòu)建序號并存到 build.number 屬性中，在成功構(gòu)建后加 1 寫回到文件中。 Buildnumber 的 file 屬性用于指定存放構(gòu)建序號的文件。

l ???????? 使用 tstamp 任務(wù)設(shè)置時間屬性，有 3 個屬性被設(shè)置，分別為 DSTAMP ，格式為 ” yyyyMMdd” ； TSTAMP ，格式為 ”hhmm” ； TODAY ，格式為 ”MM dd yyyy” 。 Tstamp 的子任務(wù) format 可以設(shè)置時間的格式，如：

<tstamp>

?? <format property="timestamp" pattern="MM/dd/yyyy hh:mm:ss"/>

</tstamp>

?

?

?

?

第四章： Deploying Builds

l ???????? 使用 tar 任務(wù)創(chuàng)建 tar 文件，如：

<tar

???? destfile="${output}/Project.tar.gz"

???? basedir="${output}"

???? includes="*.class"

??? compression="gzip"/>

l ???????? 刪除已存在的文件： <delete file="/lib/Project.jar"/>

l ???????? 刪除已存在的目錄： <delete dir="${dist}"/>

l ???????? 創(chuàng)建目錄： <mkdir dir="${dist}"/>

l ???????? copy 任務(wù)用于復(fù)制文件或目錄。

l ???????? move 任務(wù)用于移動文件或目錄。

l ???????? 使用 ftp 發(fā)送或接收文件，如：

<ftp server="xxx.xxx.xxx.xxx" binary="true" verbose="true"

??????????? userid="${name}" password="${password}"

?????????? remotedir="/cgi-bin" action=”send” >

??? <fileset dir="${output}">

?????? <exclude name="*.java"/>

?????? <exclude name="*.class"/>

?????? <exclude name="*.txt"/>

?? </fileset>

</ftp>

ftp 的 action 包括： put, get, del, list, chmod, mkdir and rmdir

l ???????? 使用 telnet ，如：

<telnet userid="steven" password="let_me_in"

????????????????? server="xxx.xxx.xxx.xxx">

???? <read>/home/steven</read>

???? <write>ls</write>

</telnet>

l ???????? 使用 SSH ，如 :

<sshexec host="xxx.xxx.xxx.xxx"

??? username="${name}"

??? password="${password}"

??? command="touch index.html"/>

l ???????? 使用 email ，如：

<mail mailhost="smtp.isp.com" mailport="1025" subject="New Build">

??? <from address="developer@isp.com"/>

??? <replyto address="developer@isp.com"/>

??? <to address="list@xyz.com"/>

??? <message>Here is the new build.</message>

??? <fileset dir="dist">

??????? <includes name="**/*.tar.gz"/>

??? </fileset>

</mail>

l ???????? 自動構(gòu)建：可以使用 Windows 的計劃任務(wù)，或 Anthill 工具進(jìn)行自動構(gòu)建。

?

?

?

?

?

?

第六章： Getting Source Code from CVS Repositories

l ???????? 登入 (login) ：

<cvspass

?????? cvsroot=":pserver:steven@STEVE:/home/steven/repository"

??????? password="opensesame" />

l ???????? 檢出 (check out) ：

<cvs package="GreetingApp" dest="${cvs.dir}" />

l ???????? 更新 (update):

<cvs dest="${cvs.dir}" command="update"/>

l ???????? 提交 (commit):

<cvs dest="${cvs.dir}/GreetingApp"

command="commit -m 'New Version'"/>

l ???????? 創(chuàng)建更新日志 (change log) ：

<cvschangelog dir="${cvs.dir}/GreetingApp"

?????????? ???? destfile="changelog.xml" />

?

?

?

?

第七章： Executing External Programs

l ???????? 執(zhí)行 Java 代碼，如：

<java jar="${bin}/connect.jar"

??? fork="true"

??? failonerror="true"

??? maxmemory="512m"

??? >

??? <arg value="-q"/>

??? <classpath>

???? ???<pathelement location="${bin}/connect.jar"/>

??????? <pathelement path="${java.class.path}"/>

??? </classpath>

</java>

l ???????? exec 任務(wù)用于執(zhí)行系統(tǒng)命令或外部程序，如：

<exec dir="." executable="/bin/cpp.exe"

??????? failonerror="true">

??????????? <arg line="-c ${src}/*.cpp ${output}"/>

</exec>

l ???????? 用 apply 任務(wù)執(zhí)行批處理， apply 與 exec 的差別是 apply 接收 fileset ，這樣可以對多個文件或輸入執(zhí)行相同中的命令或程序。

l ???????? 用 parallel 可執(zhí)行多線程任務(wù)。