Ant核心任务

Ant	基于另一个构建文件中的一个目标调用Ant从而可以将构建文件分解为多个Ant构建文件，它会实例化一个新的Ant工程。属性值可能能在新ant工程中使用、 Antfile 要调用的构建文件名，默认是build。Xml Dir 新工程所用的基目录，antfile属性相对于dir所指定的目录，默认是当前的工作目录 Inheritall 控制特性如果向新工程传递。默认是true Output 文件名，输出即要写志此文件 Target 新工程中要调用的目标名，如果忽略就调用新工程的默认目标 可以嵌套的元素 Property(传递特性) 示例 <ant antfile=”util_buildfile.xml”/> <ant dir=”dui” target=”clean”/>
Antcall	调用当前构建文件中的一个目标，通过使用嵌套<param>元素将特性传递到新目标。 Inheritall 定义特性如何传递给新目标 Target 要调用的目标的名字 可以嵌套的元素 Param(0~N) 示例 <antcall target=”cleandir”> <param name=”dir-to-clean” value=”javadocs”/> </antcall>
Antstructure	为Ant构建文件创建一个XML DTD，实用 Java反射为所有任务确定可允许的属性和内容。 Output 要生成的DTD文件的文件名 示例 <target name=”createdtd”> <antstructure output=”project.dtd”/> </target>
Apply	执行一个系统命令，需要一个嵌套的<fileset>来指定一个或多个文件和目录作为参数 Dest 由命令所生成的任何目录文件的目标目录 Dir 命令的工作目录 Executable 要执行的命令名 Failonerror 如果为true，若命令返回了非0值则构建失败 Newenvironment 如果为 true则不将现有环境变量传递至新过程 Os 此任务可应用的操作系统的列表 Output 一个文件，命令输出即要重定向到该文件 Outputproperty 存储命令输出的特性名字 Parallel 如果为true则命令仅执行一次 Skipemptyfilesets   Timeout 终止命令之前所等待的毫秒数，如果未指定就无限期等待 Type 确定无格式文件或目录的名字是否发送至命令 Vmlauncher 指定是否试图使用JVM的内置命令启动程序而不是一个antRun脚本，默认true 嵌套 Arg、env、fileset、mapper、srcfile、targetfile
Available	如果资源可用则有条件的设置一个特性，该资源可以是一个类、文件、目录或者Java系统资源。如果资源存在就设置特性为true或者置为可选的value属性所设置的值 Classname 要查找的一个Java类的类名 Classpath 在查找一个类名或资源时所用的类路径 Classpathref 在构建文件某处定义的一个类路径的引用 File 要查找的一个文件的文件名 Filepath 文件的路径 Property 当找到资源时此任务所设置的特性的名字 Resource 要查找的一个Java资源 Type 指定file属性所表示的含义，合法值为file和dir 如果未指定两种都有可能 Value 找到资源时为特性所赋的值 Classname、file、resource必取其一   嵌套内容 Classpath、filepath
Condition	如果条件为true则设置一个特性 属性 Property 如果条件为真所设置的属性名 Value 当条件为true时为属性所赋的值 内容(有且仅有一个 ，条件内部可以嵌套) Not 仅包含一个嵌套条件，否认其结果 And 任意多个条件，都为true才为true Or 任意多个条件，都为false才为false Available 相当于available，只不过忽略了property和value Uptodate 相当于uptodate任务，只不过忽略了property和value Os 如果当前操作系统为给定类型则计算为true，此元素有一个可选的family属性 Equals 如果两个String相等则计算为true
Copy	将文件和目录复制到新位置，只有不存在或有更新才被复制 属性 File 指定要复制的一个文件，使用fileset来复制多个文件 Filtering 如果为true将使用某个全局构建文件过滤器进行记号过滤，使用<filterset>指定的嵌套过滤器总是可用 Flatten 如果为true则不保留原文件的目录结构，所有文件都将复制到一个目标目录 Includeemptydirs 如果为true，则空目录也被复制 Overwrite 如果为true，即使目标文件更新也将复制文件 Preservelastmodified 如果为true则目标文件将指定为与原文件相同的最近修改时间戳。 Todir 文件将被复制到的目录 Tofile 目标文件，仅当使用file属性复制一个文件时可用 内容 Fileset (0~N) 选择要复制的文件 Filterset(0~N) 定义文件复制时用语文本替换的记号过滤器 Mapper(0~N) 定义在复制时文件名如何转换
CVS	执行 cvs命令 属性 Command Cvs命令名 Cvsroot 指定存储库所在的位置，相当于CVSEROOT环境变量 Date 此命令和应用于指定日期之前的文件 Dest 指定写出的文件置于何处，默认是工程的基目录 Error 用于记录来自CVS命令的标准错误输出的文件。 Noexec 若为true，则不对文件系统作任何修改。 Output 用于记录来自CVS Package 指定要访问的CVS模块 Passfile CVS口令文件的文件名 Port CVS同一个服务器通信所用的端口号 Quiet 若为true，CVS输出将不显示 Tag 指定一个CVS标签名
CVSPass	更新.cvspass文件相当于执行cvs login 命令 Cvsroot 执行存储库的位置，相当于CVSROOT环境变量 Passfile 指定口令文件的文件名 Password   要增加的口令
Delete	删除文件和目录 Defaultexcludes 确定是否使用默认的排出模式 Dir 待删除的目录，包括其所有文件和子目录，与file和fileset无关，删除完整的目录树 Excludes 要排除的文件模式的列表 Excludesfile 每行包括一个排除模式的文件的文件名 Failonerror 如果为true，此任务如果失败则构建过程失败 File 要删除的文件的文件名 Includeemptydirs 如果为true即使目录为空也将被删除，仅在使用嵌套fileset时才有关系 Includes 要包括的文件模式的列表 Includesfile 每行包括一个包含模式的文件的文件名 Quiet 如果为true若某个文件或目录不能被删除也不会失败，默认false Verbose 若为true则在文件删除时显示文件名字 Dir和file至少要取其一，或者要有一个嵌套fileset   内容 Patternset 0~N Fileset 0~N 选择要删除的文件
Dependset	管理文件之间的依赖关系，相对于一组源文件，如果某些目标文件更老就删除所有的这些目标文件。此任务不会完成一个按位置、逐文件的时间戳比较，它将由一组原文件中取最新的时间戳，并将它与所有目标文件中的最新时间戳进行比较。 属性无 内容 Srcfileset 0~N 此fileset中的所有文件都将与targetfileset和targetfilelist元素所指定的所有文件相比较 Srcfilelist 0~N 同上，两者至少要有一个 Targetfileset 0~N 此fileset中的所有文件都将与srcfileset和srcfilelist元素所指定的所有文件相比较，如果存在更老的文件所有的文件都将被删除。 Targetfilelist 同上，两者至少包含一个
Ear	创建ear文件，为J2EE应用的部署机制 Appxml 指定部署描述文件的位置，通常部署文件都重命名为所生成的ear文件中的META-INF/application.xml Basedir   指定基目录，由此将文件增加到EAR文件中 Compress 如果为true就压缩ear文件 Defaultexcludes 确定 是否使用默认排除模式 Earfile 指定要创建的ear文件的文件名 Encoding 指定ear文件中文件名的字符编码，默认是UTF-8 excludes   Excludesfile   Fileonly 如果为true则不创建空目录 Includes   Includesfile   Manifest 要使用的清单文件的文件名 Update  如果为true则作出修改时更新现有的ear文件而不是将其删除再从头创建，默认为false Whenempty 无文件匹配时所采取的操作。合法值是fail终止构建、skip不创建ear文件 或者create(默认) 内容 Patternset 0~N Metainf 0~1 定义一个fileset，其中包括置于ear文件的meta-inf目录中的所有文件 Fileset 0~n 指定要包括在ear文件中的文件和目录 Zipfileset
Echo	Append 如果为true则追加到一个现有文件 File 消息要写到的文件的文件名 Message 除非包含在标签内，必须有此属性 内容 文本内容 如果没有使用message属性
Exec	执行一个系统命令 Command 要执行的命令包括参数 Dir 命令的工作目录 Executable 要执行的命令名，不包括命令行参数 Failonerror 如果为true则命令返回非0时构建失败 Newenvironment   Os   Output 一个文件，命令输出既要重定向到此文件 Outputproperty  存储命令输出的一个特性的名字 Timeout   Vmlauncher   内容 Arg 0~N 每个元素指定一个命令行参数 Env 0~N 每个元素指定一个环境变量
Fail	抛出一个BuildException异常，导致当前构建失败 Message属性指定执行此任务时显示的消息 内容 文本内容
Filter	定义记号过滤器，用于在复制文件时完成文本替换 属性 Filtersfile 包括记号/值对的一个文件 Token 原文件中要替换的文本，不包括@字符 Value 要取代@token@的文本，不包括@字符
Fixcrlf	清除源文件中的特殊字符，如回车符、制表符、换行符、EOF字符 Defaultexcludes 确定是否使用默认排除模式 Destdir 调整文件置于何处，如果为指定就重写 Eof 如果处理EOF字符 Eol   Excludes   Excludesfile   Includes   Includesfile   Javafiles 如果为true表示嵌套fileset指定的一组Java文件，这样可以确保Java字符串和字符常量中的制表符不会被修改 Srcdir 包括要调整文件的目录 Tab 控制如何修改制表符，合法值是add、asis、remove Tablength 一个制表符所表示的空格数 内容 Patternset 0~N <fixcrlf srcdir=”” destdir=”” eol=”asis” tab=”remove” tablength=”4” eof=”asis” includes=”**/*.java” javafiles=”true”/>
Genkey	生成一个密钥对
Get	由某个URL获取一个文件 Dest 存储文件的文件名 Ignoreerrors 如果为true则记录错误但不终止构建 Src 要获取远程文件的URL Usetimestamp 如果为true则仅下载时间戳比本地文件新的远程文件，仅用于HTTP协议 Verbose 如果为true每获取100KB数据显示一个.，默认是false
Gunzip	展开一个GZip，只有当目标文件不存在或比源文件老时才展开此文件 Dest   Src 待解压的文件名
Gzip	创建一个GZip Src 要压缩的文件的文件名 Zipfile 要创建的文件的文件名
Jar	同ear，没有Appxml
Java	执行一个Java类，使用ANT的VM实例，如果要执行System.exit()要确保设置了fork=”true” 否则Ant将退出。 Classname 要执行的Java类的类名 Classpath 要使用的类路径，除非使用fork=”true” 否则它将增加到Ant的类路径 Classpathref 在构建文件中某处定义的一个类路径的引用 Dir VM的工作目录 Failonerrror   Fork 如果为true类将在一个新的VM实例中执行 Jar 要执行的一个可执行JAR文件的文件名，此Jar文件必须包括一个MainClass清单项而且fork必须为true Jvm Java解释器的命令名 Maxmemory 为新创建的VM分配的最大内存量，必须i使用fork=”true”才不被忽略 Output 一个文件名，输出写至此文件 内容 Arg和jvmarg 0~N 分别指定应用和JVM的命令行参数 Sysproperty 0~N 每个元素指定一个系统特性 Classpath 0~1 使用path元素 代替classpath或classpathref属性
Javac
Javadoc
Mkdir	Dir属性指定要创建的目录