shenh062326

Ant是什么？
Ant是一種基于Java和XML的build工具.

1 編寫build.xml

Ant的buildfile是用XML寫的.每個buildfile含有一個project.

buildfile中每個task元素可以有一個id屬性,可以用這個id值引用指定的任務.這個值是唯一的.（詳情請參考下面的Task小節）

1.1 Projects

project有下面的屬性：

將你的tstamp task在一個所謂的初始化target是很好的做法,其他的target依賴這個初始化target.要確保初始化target是出現在其他target依賴表中的第一個target.在本手冊中大多數的初始化target的名字是"init".

target有下面的屬性：

Attribute	Description	Required
name	target的名字	Yes
depends	用逗號分隔的target的名字列表,也就是依賴表.	No
if	執行target所需要設定的屬性名.	No
unless	執行target需要清除設定的屬性名.	No
description	關于target功能的簡短描述.	No

1.3 Tasks

一個task是一段可執行的代碼.

一個task可以有多個屬性（如果你愿意的話,可以將其稱之為變量）.屬性只可能包含對property的引用.這些引用會在task執行前被解析.

下面是Task的一般構造形式：
<name attribute1="value1" attribute2="value2" ... />
這里name是task的名字,attributeN是屬性名,valueN是屬性值.

有一套內置的（built-in）task,以及一些可選task,但你也可以編寫自己的task.

所有的task都有一個task名字屬性.Ant用屬性值來產生日志信息.

可以給task賦一個id屬性：
<taskname id="taskID" ... />
這里taskname是task的名字,而taskID是這個task的唯一標識符.通過這個標識符,你可以在腳本中引用相應的task.例如,在腳本中你可以這樣：
<script ... >
task1.setFoo("bar");
</script>
設定某個task實例的foo屬性.在另一個task中（用java編寫）,你可以利用下面的語句存取相應的實例.
project.getReference("task1").
注意1：如果task1還沒有運行,就不會被生效（例如：不設定屬性）,如果你在隨后配置它,你所作的一切都會被覆蓋.

注意2：未來的Ant版本可能不會兼容這里所提的屬性,很有可能根本沒有task實例,只有proxies.

1.4 Properties

一個project可以有很多的properties.可以在buildfile中用 property task來設定,或在Ant之外設定.一個property有一個名字和一個值.property可用于task的屬性值.這是通過將屬性名放在"${" 和"}"之間并放在屬性值的位置來實現的.例如如果有一個property builddir的值是"build",這個property就可用于屬性值：${builddir}/classes.這個值就可被解析為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>

1.5 Path-like Structures
你可以用":"和";"作為分隔符,指定類似PATH和CLASSPATH的引用.Ant會把分隔符轉換為當前系統所用的分隔符.

當需要指定類似路徑的值時,可以使用嵌套元素.一般的形式是
<classpath>
<pathelement path="${classpath}"/>
<pathelement location="lib/helper.jar"/>
</classpath>
location屬性指定了相對于project基目錄的一個文件和目錄,而path屬性接受逗號或分號分隔的一個位置列表.path屬性一般用作預定義的路徑－－其他情況下,應該用多個location屬性.

為簡潔起見,classpath標簽支持自己的path和location屬性.：
<classpath>
<pathelement path="${classpath}"/>
</classpath>
可以被簡寫作：
<classpath path="${classpath}"/>
也可通過<fileset>元素指定路徑.構成一個fileset的多個文件加入path-like structure的順序是未定的.

<classpath>
<pathelement path="${classpath}"/>
<fileset dir="lib">
<include name="**/*.jar"/>
</fileset>
<pathelement location="classes"/>
</classpath>
上面的例子構造了一個路徑值包括：${classpath}的路徑,跟著lib目錄下的所有jar文件,接著是classes目錄.

如果你想在多個task中使用相同的path-like structure,你可以用<path>元素定義他們（與target同級）,然后通過id屬性引用－－參考Referencs例子.

path-like structure可能包括對另一個path-like structurede的引用（通過嵌套<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>
前面所提的關于<classpath>的簡潔寫法對于<path>也是有效的,如：
<path id="tests.path">
<path refid="base.path"/>
<pathelement location="testclasses"/>
</path>
可寫成：
<path id="base.path" path="${classpath}"/>
命令行變量

有些task可接受參數,并將其傳遞給另一個進程.為了能在變量中包含空格字符,可使用嵌套的arg元素.
Attribute Description Required
value 一個命令行變量；可包含空格字符. 只能用一個
line 空格分隔的命令行變量列表.
file 作為命令行變量的文件名；會被文件的絕對名替代.
path 一個作為單個命令行變量的path-like的字符串；或作為分隔符,Ant會將其轉變為特定平臺的分隔符.

例子
<arg value="-l -a"/>
是一個含有空格的單個的命令行變量.
<arg line="-l -a"/>
是兩個空格分隔的命令行變量.
<arg path="/dir;/dir2:dir3"/>
是一個命令行變量,其值在DOS系統上為dir;dir2;dir3；在Unix系統上為/dir:/dir2:/dir3 .

References

buildfile元素的id屬性可用來引用這些元素.如果你需要一遍遍的復制相同的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>
可以寫成如下形式：
<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也接受這種類型的引用.

http://www.linux521.com/2009/java/200904/1760.html