target目标与任务

运行ant没有带参数的情况下，会读取project元素，并使用default属性来作为目标执行。

ant所有任务都支持的三个属性：
id，一个任务实例的唯一标识。与Reference类型一同使用。
taskname，任务实例名，将显示在日志中。
description，任务的注释。

<project>和<target>元素都不是任务。

project元素
属性
basedir基目录，工程中的所有相对路径都是基于该值。默认是构件文件所在目录。如果此属性未指定，则可以在调用 ant的时候加上特性 ant -Dbasedir=目录 target（要调用的目标名）

default必须，指定一个目标，如果ant命令未带上目标，则默认执行这个目标。

name项目的名字。用于建立文档。在ant -projecthelp时也会显示这个名字。

它可以嵌套子元素：
0-N个description为工程建立一个描述。在ant -projecthelp的时候会显示这个描述。
0-N个filelist元素 定义工程范围的filelist
0-N个fileset元素 定义工程范围的fileset
0-N个filterset元素 定义工程范围的filterset
0-N个mapper元素
0-N个path元素
0-N个property元素
1-N个target元素
0-N个taskdef元素


target元素
属性
depends此目标的依赖目标，用逗号分割。列出的目标会在此目标前执行。
description目标的描述。
if指定一个特性名，只有在设置了特性才会执行。
name必须，目标的名字
unless指定一个特性名，未设置特性，才执行。

目标可以包含DataType和任务。

ant任务
ant任务会基于另一个构件文件的一个目标调用ant。可以为工程定义多个构件文件。不同的ant版本，工程间调用时，特性的传递方式也不同。1.1版本，新工程可以见到调用工程的特性。如果两个工程都定义同一个特性，那么调用工程的特性优先。

属性：
antfile要调用的构件文件名字，默认是build.xml
dir新工程的基目录。antfile属性会相对这个目录来寻找。默认是当前目录。
inheritall控制特性如何由当前工程传递到新工程。默认是true。表示当前工程的特性在新工程可用。false，当前工程定义的特性不会传递到新工程，除非他们在ant命令行定义（这时候是用户特性，而不是构件特性了）。
output文件名，输出会写至这个文件。
target新工程要调用的文件名。如果忽略，会调用新工程的默认目标
可以嵌套
0-N个property元素，将一个特性传递到新工程
<ant antfile="email/build.xml">
<property name="test" value="test_value" />
</ant>

antcall任务
调用当前构件文件的一个目标
通过使用嵌套<param>元素将特性传递到新目标。antcall会使用当前构件文件，并新建一个实例，然后才调用这个目标。
属性：
inheritall和ant类似
target必须，要调用的目标

嵌套0-N个param元素
将一个特性传递给新的构件过程。param元素和property类似。属性也相同。

antstructure任务
为ant创建一个xml dtd。它使用java反射为所有任务确定可允许的属性和内容。因为ant任务并未指出所需要的属性，所以生成的DTD属性是#IMPLIED(表示可选)
属性
output必须，生成的DTD文件的文件名

apply任务
执行一个系统命令。execon任务已经被废除。与exec任务不同，此任务需要嵌套fileset来指定一个或多个文件和目录作为命令的参数
属性
dest由命令所生成的任何目标文件的目标目录。
dir命令的工作目录
executable必须，要执行的命令名，不包括命令参数
failonerror如果为true，若命令返回非0值，则构件失败。默认是false
newenvironment，如果是true，则不将现有环境变量传递至新过程。默认是false
os此任务可应用的操作系统列表，它会System.getProperty("os.name")来获取系统，并与之比较。在列表中了才会执行
output一个文件，命令输出既要重定向到这个文件
outputproperty存储命令输出的特性的名字
parallel如果为true，则命令仅执行一次，将所有文件传递为参数。如果为false，此命令为各个文件分别执行依次。默认是false。
skipemptyfilesets如果为true，当未找到源文件，或者源文件比目标文件新，则不执行命令。默认是false。
timeout终止命令之前所等待的豪秒数，如果未指定，无限期等待。
type确定无格式文件或目标的名字是否发送至命令。可允许的值可以是file,dir或both。默认是file
vmlauncher指定是否试图使用jvm的内置命令启动程序，而不是一个antRUN脚本，默认是true。
如果指定了一个嵌套的<mapper>元素，dest就必须。

可以嵌套子元素
0-N个arg元素，命令行参数
0-N个env元素，指定环境变量
0-N个fileset元素，指定哪些文件和目录要作为参数传递至命令。除非指定了srcfile元素，否则文件将追加到命令行末尾。
0-N个mapper元素，如果定义，则将目标文件的时间戳和源文件时间戳比较。
0-N个srcfile元素，如果存在，则对由fileset元素指定的文件要置于命令行何处加以控制。srcfile没有任何属性。需要置于合适的arg元素之间。
0-N个targetfile元素，此元素仅在apply元素设置了一个mapper元素和destdir属性才可用。没有任何属性。用于标记命令行上目标文件的位置。和srcfile元素相同。
<?xml version="1.0" encoding="utf-8"?>
<project name="DataType 测试" default="run" basedir=".">
<filelist id="needFiles" dir="." files="1.txt, 2.txt, 3.txt" />
<filelist id="moreFiles" dir="." files="4.txt" />
<target name="run">
<tstamp>
<format property="starttime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="开始时间：${starttime}" />

<apply executable="dir" vmlauncher="false">
<fileset dir=".">
<include name="build.xml" />
</fileset>
</apply>

<tstamp>
<format property="endtime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="结束时间：${endtime}" />
</target>
</project>
结果
D:\source\liyixing\ant>ant
Buildfile: D:\source\liyixing\ant\build.xml

run:
[echo] 开始时间：2011-05-16 11:27:00
[apply] 驱动器 D 中的卷是 IT
[apply] 卷的序列号是 D0EA-6307
[apply]
[apply] D:\source\liyixing\ant 的目录
[apply]
[apply] 2011-05-16 11:26 2,205 build.xml
[apply] 1 个文件 2,205 字节
[apply] 0 个目录 92,811,255,808 可用字节
[echo] 结束时间：2011-05-16 11:27:01

BUILD SUCCESSFUL
Total time: 0 seconds

加上output属性，output="a.txt"结果
D:\source\liyixing\ant>ant
Buildfile: D:\source\liyixing\ant\build.xml

run:
[echo] 开始时间：2011-05-16 11:30:36
[echo] 结束时间：2011-05-16 11:30:36

BUILD SUCCESSFUL
Total time: 0 seconds

dir命令的结果打印在了a.txt。打开a.txt可以看到结果。

available
available如果某资源可用，则有条件的设置一个特性。资源可以是一个类，文件，目录或者java系统资源。如果资源存在，此特性设置为true，或者设置为value属性设置的值。否则不设置特性。
部分任务不列出。

fail抛出一个异常（BuildException）并终止当前构建。message指定执行此任务时显示的消息。
属性
message要显示的消息。

jar
创建一个jar文件
属性
basedir 要增加到jar文件中的文件的基目录
compress 如果为true，则解压jar文件。默认是true
defaultexcludes 是否使用默认排除模式。默认是true
encoding 指定jar文件的文件名编码默认是utf-8.
excludes要排除的文件模式列表。逗号分隔
excludesfile 每行一个要排除的列表
includes 要包含的文件模式列表，逗号分隔
includesfile 每行包括一个要包含的文件模式。
jarfile 要创建的jar文件的文件名
manifest 清单文件的文件名。如果没有指定的话，ant会生成一个新的清单，里面会添加ant的版本号。
update如果为true，则发生修改时更新现有jar文件。而不是重新生成。
whenempty未找到输入文件的错做。默认是create。合法值是 fail 终止构建。 skip不创建jar文件 create创建一个空的jar文件。
可以嵌套
0-N个attribute元素。每个元素都是一个键值对。对于清单文件中未命名的段中。清单中各段使用空行分隔。使用section创建清单段。
属性：
name属性名
value属性值
0-N个patternset元素（exclude，incude，patternset，excludesfile，includesfile）代替其属性。

0-N个fileset元素，指定包括在jar文件中的文件和目录。
0-N个metainf元素，定义一个fileset，其中包含要放到jar的META-INF目录下面的文件。如果set中有MANIFEST.MF文件，那么会把这个文件和jar中的MANIFEST.MF合并。
0-N个section元素，每个元素定义一个清单段。每个section可以包含attribute。
属性：
name，段明。
0-N个zipfileset。

<?xml version="1.0" encoding="utf-8"?>
<project name="DataType 测试" default="run" basedir=".">
<filelist id="needFiles" dir="." files="1.txt, 2.txt, 3.txt" />
<filelist id="moreFiles" dir="." files="4.txt" />
<target name="run">
<tstamp>
<format property="starttime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="开始时间：${starttime}" />

<jar jarfile="build/test.jar" basedir="src" includes="**/*.java">
<manifest>
<attribute name="Version" value="3.2" />

<section name="test1">
<attribute name="test1-1" value="test1-1" />
</section>

<section name="test2">
<attribute name="os" value="windows" />
</section>
</manifest>
</jar>

<tstamp>
<format property="endtime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="结束时间：${endtime}" />
</target>
</project>
生成的jar的清单文件内容
Manifest-Version: 1.0
Ant-Version: Apache Ant 1.8.2
Created-By: 1.6.0_22-b04 (Sun Microsystems Inc.)
Version: 3.2

Name: test1
test1-1: test1-1

Name: test2
os: windows


java
指定一个java类
使用ant的vm或者创建一个新的vm来执行java类。
如果代码中有System.exit()，要确保fork=true，否则ant也会退出。
属性
args，弃用，使用args元素
classname，执行的java类
classpath要使用的类路径。除非fork=true，否则会添加到ant的类路径。
classpathref 应用构建文件定义的类路径。
dir vm的工作目录。fork=true的时候，它才有效。
failonerror，如果未true，则当命令返回0值时构建失败。默认是false，fork=true的时候，它才有效。
fork 为true的时候，创建一个新的VM实例。默认false。
jar要执行的一个可执行jar文件的文件名。此jar文件必须包括一个Main-Class的清单项。而且fork必须是true。
jvm java解释器的命令名。默认是java。fork必须是true。
jvmargs，弃用使用jvmarg元素。
maxmemory 为新创建的vm分配最大内存量。fork=true才有用。
output 一个文件名，输出写到这里
classname或jar二者必选其中一个。
嵌套
0-N个arg或者jvmarg元素
指定应用的参数和虚拟机的参数。
0-N个sysproperty指定系统特性
0-N个classpath用path元素来代替classpath或者classpathref属性。
<?xml version="1.0" encoding="utf-8"?>
<project name="DataType 测试" default="run" basedir=".">
<filelist id="needFiles" dir="." files="1.txt, 2.txt, 3.txt" />
<filelist id="moreFiles" dir="." files="4.txt" />
<target name="run">
<tstamp>
<format property="starttime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="开始时间：${starttime}" />

<java classname="test.Test">
<arg value="123" />
<classpath>
<pathelement path="build" />
</classpath>
</java>

<tstamp>
<format property="endtime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="结束时间：${endtime}" />
</target>
</project>

<?xml version="1.0" encoding="utf-8"?>
<project name="DataType 测试" default="run" basedir=".">
<filelist id="needFiles" dir="." files="1.txt, 2.txt, 3.txt" />
<filelist id="moreFiles" dir="." files="4.txt" />

<path id="test.classpath">
<pathelement path="build/test.jar" />
<pathelement path="build/1.jar" />
</path>

<target name="run">
<tstamp>
<format property="starttime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="开始时间：${starttime}" />

<java classname="test.Test">
<arg value="123" />
<classpath refid="test.classpath" />
</java>

<tstamp>
<format property="endtime" pattern="yyyy-MM-dd hh:mm:ss" />
</tstamp>
<echo message="结束时间：${endtime}" />
</target>
</project>
应用其他地方定义的path

javac任务
编译，将java文件和class文件比较。如果不存在文件或者源文件比其相应的类文件更新，才会进行编译。依赖关系，ant无法发现。如父类A修改了，而子类B继承父类A，B未修改，ant只重新编译A，而不会重新编译B。会出现特殊问题。
支持多种编译器。
JDK1.1-12编译器是classic
JDK1.3/1.4是modern。
IBM Jikes编译器 jikes
Microsoft的javaSDK编译器 jvc
kopi编译器kjc
gcc的gcj编译器 gcj
Symantec编译器 sj
在其自己的JVM中运行modern或classic extJavac
属性
bootclasspath 要启动的bootstrap类路径。
bootclasspathref应用某处定义的类路径。
classpath要使用的类路径。如果fork不是true的情况下，会把它添加到ant的类路径。
classpathref 应用某处的类路径。
debug 如果是true，编译源代码会有调试信息。默认false
defaultexcludes 是否使用默认排除模式。默认true
depend 如果是true，则对于支持依赖检查的编译器（jikes和classic）启动依赖检查。默认是false。
deprecation，如果是true，显示废弃警告。默认false
destdir类文件的目标目录
encoding源文件的字符编码
excludes
excludesfile
extdirs覆盖java安装可选包的一般位置
failonerror如果true，当出现错误，构建失败。默认是true
fork 如果true，java编译器作为一个新的进程。如果设置，此属性将覆盖build.compiler特性。而ant执行JAVA_HOME/bin中实际的java可执行程序。而不是编译器的Main类。默认false
includeantruntime，如果true，则将ant运行时库包含到类路径。默认true
includejavaruntime，如果是true，则包括来自正在执行的VM的默认运行库。默认是false。
includes
includesfile
memoryinitialsize 当fork=true时工作。为vm指定内存大小。
memorymaximumsize 当fork=true时工作。为vm指定最大内存
nowarn如果是true，把-nowarn参数传递到编译器。默认false
optimize如果true，指示编译器优化代码。默认false。
source如果指定，此属性的文件将作为-source命令行参数传递给javac。
srcdir源代码的位置
target指定一个vm的版本
verbose如果未true，则编译器生成显示输出。默认是false。
除非指定了src元素，否则srcdir的属性是必须的。

可以嵌套0-N个exclude，include，patternset，excludesfile，includesfile
0-N个bootclasspath，classpath，extdirs，src