Ant的buildfile是用XML寫(xiě)的。每個(gè)buildfile含有一個(gè)project。
buildfile中每個(gè)task元素可以有一個(gè)id屬性，可以用這個(gè)id值引用指定的任務(wù)。這個(gè)值必須是唯一的。（詳情請參考下面的Task小節）
Projectsproject有下面的屬性：
| Attribute | Description | Required |
| name | 項目名稱(chēng). | No |
| default | 當沒(méi)有指定target時(shí)使用的缺省target | Yes |
| basedir | 用于計算所有其他路徑的基路徑。該屬性可以被basedir property覆蓋。當覆蓋時(shí)，該屬性被忽略。如果屬性和basedir property都沒(méi)有設定，就使用buildfile文件的父目錄。 | No |
項目的描述以一個(gè)頂級的<description>元素的形式出現（參看description小節）。
一個(gè)項目可以定義一個(gè)或多個(gè)target。一個(gè)target是一系列你想要執行的。執行Ant時(shí)，你可以選擇執行那個(gè)target。當沒(méi)有給定target時(shí)，使用project的default屬性所確定的target。
Targets
一個(gè)target可以依賴(lài)于其他的target。例如，你可能會(huì )有一個(gè)target用于編譯程序，一個(gè)target用于生成可執行文件。你在生成可執行文件之前必須先編譯通過(guò)，所以生成可執行文件的target依賴(lài)于編譯target。Ant會(huì )處理這種依賴(lài)關(guān)系。
然而，應當注意到，Ant的depends屬性只指定了target應該被執行的順序－如果被依賴(lài)的target無(wú)法運行，這種depends對于指定了依賴(lài)關(guān)系的target就沒(méi)有影響。
Ant會(huì )依照depends屬性中target出現的順序（從左到右）依次執行每個(gè)target。然而，要記住的是只要某個(gè)target依賴(lài)于一個(gè)target，后者就會(huì )被先執行。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
假定我們要執行target D。從它的依賴(lài)屬性來(lái)看，你可能認為先執行C，然后B，最后A被執行。錯了，C依賴(lài)于B，B依賴(lài)于A(yíng)，所以先執行A，然后B，然后C，最后D被執行。
一個(gè)target只能被執行一次，即時(shí)有多個(gè)target依賴(lài)于它（看上面的例子）。
如果（或如果不）某些屬性被設定，才執行某個(gè)target。這樣，允許根據系統的狀態(tài)（java version, OS, 命令行屬性定義等等）來(lái)更好地控制build的過(guò)程。要想讓一個(gè)target這樣做，你就應該在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ì )被執行。
可選的description屬性可用來(lái)提供關(guān)于target的一行描述，這些描述可由-projecthelp命令行選項輸出。
將你的tstamp task在一個(gè)所謂的初始化target是很好的做法，其他的target依賴(lài)這個(gè)初始化target。要確保初始化target是出現在其他target依賴(lài)表中的第一個(gè)target。在本手冊中大多數的初始化target的名字是"init"。
target有下面的屬性：
| Attribute | Description | Required |
| name | target的名字 | Yes |
| depends | 用逗號分隔的target的名字列表，也就是依賴(lài)表。 | No |
| if | 執行target所需要設定的屬性名。 | No |
| unless | 執行target需要清除設定的屬性名。 | No |
| description | 關(guān)于target功能的簡(jiǎn)短描述。 | No |
Tasks
一個(gè)task是一段可執行的代碼。
一個(gè)task可以有多個(gè)屬性（如果你愿意的話(huà)，可以將其稱(chēng)之為變量）。屬性只可能包含對property的引用。這些引用會(huì )在task執行前被解析。
下面是Task的一般構造形式：
<name attribute1="value1" attribute2="value2" ... />
這里name是task的名字，attributeN是屬性名，valueN是屬性值。
有一套內置的（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的唯一標識符。通過(guò)這個(gè)標識符，你可以在腳本中引用相應的task。例如，在腳本中你可以這樣：
<script ... >
task1.setFoo("bar");
</script>
設定某個(gè)task實(shí)例的foo屬性。在另一個(gè)task中（用java編寫(xiě)），你可以利用下面的語(yǔ)句存取相應的實(shí)例。
project.getReference("task1").
注意1：如果task1還沒(méi)有運行，就不會(huì )被生效（例如：不設定屬性），如果你在隨后配置它，你所作的一切都會(huì )被覆蓋。
注意2：未來(lái)的Ant版本可能不會(huì )兼容這里所提的屬性，因為很有可能根本沒(méi)有task實(shí)例，只有proxies。
Properties
一個(gè)project可以有很多的properties?？梢栽赽uildfile中用property task來(lái)設定，或在A(yíng)nt之外設定。一個(gè)property有一個(gè)名字和一個(gè)值。property可用于task的屬性值。這是通過(guò)將屬性名放在"${"和"}"之間并放在屬性值的位置來(lái)實(shí)現的。例如如果有一個(gè)property builddir的值是"build"，這個(gè)property就可用于屬性值：${builddir}/classes。這個(gè)值就可被解析為build/classes。
內置屬性
如果你使用了<property> task 定義了所有的系統屬性，Ant允許你使用這些屬性。例如，${os.name}對應操作系統的名字。
要想得到系統屬性的列表可參考the Javadoc of System.getProperties。
除了Java的系統屬性，Ant還定義了一些自己的內置屬性： basedir project基目錄的絕對路徑 (與<project>的basedir屬性一樣)。ant.file buildfile的絕對路徑。ant.version Ant的版本。ant.project.name 當前執行的project的名字；由<project>的name屬性設定.ant.java.version Ant檢測到的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>Token Filters
一個(gè)project可以有很多tokens，這些tokens在文件拷貝時(shí)會(huì )被自動(dòng)擴展，這要求在支持這一行為的task中選擇過(guò)濾拷貝功能。這一功能可用filter task在buildfile中設定。
既然這很可能是一個(gè)有危害的行為，文件中的tokens必須采取@token@的形式，這里token是filter task中設定的token名。這種token語(yǔ)法與其他build系統執行類(lèi)似filtering的語(yǔ)法相同，而且與大多數的編程和腳本語(yǔ)言以及文檔系統并不沖突，
注意：如果在一個(gè)文件中發(fā)現了一個(gè)@token@形式的token，但沒(méi)有filter與這個(gè)token關(guān)連，則不會(huì )發(fā)生任何事；因此，沒(méi)有轉義方法－但只要你為token選擇合適的名字，就不會(huì )產(chǎn)生問(wèn)題。
警告：如果你在拷貝binary文件時(shí)打開(kāi)filtering功能，你有可能破壞文件。這個(gè)功能只針對文本文件。
Path-like Structures
你可以用":"和";"作為分隔符，指定類(lèi)似PATH和CLASSPATH的引用。Ant會(huì )把分隔符轉換為當前系統所用的分隔符。
當需要指定類(lèi)似路徑的值時(shí)，可以使用嵌套元素。一般的形式是
<classpath><pathelement path="${classpath}"/><pathelement location="lib/helper.jar"/></classpath>location屬性指定了相對于project基目錄的一個(gè)文件和目錄，而path屬性接受逗號或分號分隔的一個(gè)位置列表。path屬性一般用作預定義的路徑－－其他情況下，應該用多個(gè)location屬性。
為簡(jiǎn)潔起見(jiàn)，classpath標簽支持自己的path和location屬性。所以：
<classpath><pathelement path="${classpath}"/></classpath>可以被簡(jiǎn)寫(xiě)作：
<classpath path="${classpath}"/>也可通過(guò)<fileset>元素指定路徑。構成一個(gè)fileset的多個(gè)文件加入path-like structure的順序是未定的。
<classpath><pathelement path="${classpath}"/><fileset dir="lib"><include name="**/*.jar"/></fileset><pathelement location="classes"/></classpath>上面的例子構造了一個(gè)路徑值包括：${classpath}的路徑，跟著(zhù)lib目錄下的所有jar文件，接著(zhù)是classes目錄。
如果你想在多個(gè)task中使用相同的path-like structure，你可以用<path>元素定義他們（與target同級），然后通過(guò)id屬性引用－－參考Referencs例子。
path-like structure可能包括對另一個(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ě)法對于<path>也是有效的，如：
<path id="tests.path"><path refid="base.path"/><pathelement location="testclasses"/></path>
可寫(xiě)成：
<path id="base.path" path="${classpath}"/>命令行變量
有些task可接受參數，并將其傳遞給另一個(gè)進(jìn)程。為了能在變量中包含空格字符，可使用嵌套的arg元素。
| Attribute | Description | Required |
| value | 一個(gè)命令行變量；可包含空格字符。 | 只能用一個(gè) |
| line | 空格分隔的命令行變量列表。 |
| file | 作為命令行變量的文件名；會(huì )被文件的絕對名替代。 |
| path | 一個(gè)作為單個(gè)命令行變量的path-like的字符串；或作為分隔符，Ant會(huì )將其轉變?yōu)樘囟ㄆ脚_的分隔符。 |
例子
<arg value="-l -a"/>
是一個(gè)含有空格的單個(gè)的命令行變量。
<arg line="-l -a"/>
是兩個(gè)空格分隔的命令行變量。
<arg path="/dir;/dir2:\dir3"/>
是一個(gè)命令行變量，其值在DOS系統上為\dir;\dir2;\dir3；在Unix系統上為/dir:/dir2:/dir3 。
References
buildfile元素的id屬性可用來(lái)引用這些元素。如果你需要一遍遍的復制相同的XML代碼塊，這一屬性就很有用－－如多次使用<classpath>結構。
下面的例子：
<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)型的引用。
