ant [options] [target [target2 [target3] ...]]
Options:
-help, -h print this message
-projecthelp, -p print project help information
-----------------------显示当前build.xml的主要任务
-version print the version information and exit
-diagnostics print information that might be helpful to
diagnose or report problems.
-----------------------诊断当前Ant的所有的配置
-quiet, -q be extra quiet
-verbose, -v be extra verbose
-debug, -d print debugging information
-emacs, -e produce logging information without adornments
-lib <path> specifies a path to search for jars and classes
-logfile <file> use given file for log
-l <file> ''
-logger <classname> the class which is to perform logging
-listener <classname> add an instance of class as a project listener
-noinput do not allow interactive input
-buildfile <file> use given buildfile
-file <file> ''
-f <file> ''
-D<property>=<value> use value for given property
-keep-going, -k execute all targets that do not depend
on failed target(s)
-propertyfile <name> load all properties from file with -D
properties taking precedence
-inputhandler <class> the class which will handle input requests
-find <file> (s)earch for buildfile towards the root of
-s <file> the filesystem and use it
-nice number A niceness value for the main thread:
1 (lowest) to 10 (highest); 5 is the default
-nouserlib Run ant without using the jar files from
${user.home}/.ant/lib
-noclasspath Run ant without using CLASSPATH
-autoproxy Java1.5+: use the OS proxy settings
-main <class> override Ant's normal entry point
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
C:\>ant -help\-h 获取ant的帮助信息(ps:斜杠\在此处的意思为或 表明
-help和-h的意义一样 后者为前者的缩写,以下命令类
同)
C:\>ant -projecthelp\-p 列出build.xml中的所有目标任务
C:\>ant -version 获取当前ant的版本信息
C:\>ant -diagnostics 诊断当前ant项目的运行环境、依赖库等信息
C:\>ant -debug\-d 显示ant执行调式的信息、详细的log信息
C:\>ant -lib<path> 指定一个类库所在的位置(jar文件位置),让ant工具可以
使用这些文类件。path类型指定类库文件
C:\>ant -logfile<file> 使ant输出到一个指定文件当中,而不是输出到运行ant
的终端的标准输出设备上 可以和-listener、-logger一
起使用
C:\>ant -quiet\-q 隐藏ant执行的提示输出信息。
C:\>ant -verbose\-v 显示ant执行的详细信息,包括操作系统和java环境等信
息
C:\>ant -buildfile<file>没有指定任何参数时,ant会在当前目录下查询build.xml
文件,如果找到了就用该文件作为buildfile,要想让ant
使用其他的buildfile,就
用该参数指定要使用的buildfile
C:\>ant -D<property>=<value> 用户设定一些变量,这些变量可以在target中直
接引用,或覆盖已设定的属性值
C:\>ant -find<file>\-s<file> 查找构建文件,并执行找到的构建文件ant中的
系统属性(用${}来获取属性值 例如${os.name})
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
系统属性 类似${os.name}使用
os.name: 操作系统的名称
basedir: 项目引用的根路径
ant.home: Ant工具的根目录位置
ant.file: 构建文件的绝对路径
ant.version: Ant的版本信息
ant.java.version:Ant检测到的JVM版本
ant.project.name:当前执行的项目名称及信息
java.version: Java的版本信息
java.home: Java的根目录位置
java.class.path:Java类库的文件位置
line.separator: 换行符(用可能是不可见字符)
user.home: 用户的home目录,在Linux和UNIX中经常用到
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
1、<project>标签
每个构建文件都对应于一个项目,但是大型项目经常包含大量的子项目,每一个
子项目都可以有自己的构建文件。
每个构建文件对应一个项目,project标签是构建文件的跟标签,它可以有多个内
在属性,各个属性的含义分别如下所示:
-----default 表示默认的执行目标,这个属性不是必须的。
可以在执行时指定任务,ant compile (target_name包
含run、jar、javac、java),但是既没有默认也没有指
定,则执行成功,但是没有任务执行(也就是执行是空)。
-----basedir 表示项目的基准路径,也不是必须的,默认是当前路径。
-----name 表示项目名称,可选。
-----description 表示项目的描述(或者是对这个标签的作用进行表述)。
2、<target>标签
一个项目标签下可以有一个或多个target标签,一个target标签可以依赖其他
target标签,target所有属性如下所示:
-----name 表示这个标签的名字,这个属性是必须的。
-----depends 表示依赖的目标。
-----if 表示仅当属性设置时才执行。
-----unless 表示当属性没有设置时才执行。
-----description 表示项目的描述(或者是对这个标签的作用进行表述)。
这个地方如果加上描述,则用ant -projecthelp列出目
标认为时,加desc的target则在Main target中,没有描
述信息在Other target中。
Main target :
java
Other target:
clean
compile
javac
run
Default target:
run
Ant的depends属性指定了target的执行顺序,Ant会依照depends属性中target
标签出现顺序依次执行每个target,在执行之前首先执行它所依赖的target标
签,例如:项目中的名为run的target的depends属性compile,而名为compile
的target的depends属性是init,所以这几个target标签的执行顺序是init—》
compile—》run。一个target只能被执行一次,即使有多个target依赖于它。
如果没有if或unless属性,target总会被执行。
3、<mkdir>标签
该标签用户创建一个目录,它有一个属性dir用户指定所创建的目录
其代码如下:
-----<mkdir dir="目录名"/>
4、<jar>标签
该标签用来生成一个JAR包,其属性如下:
-----jarfile 表示生产JAR文件名。
-----basedir 表示被归档的目录。
-----includes 表示别归档的文件模式。
-----exchudes 表示被排除的文件模式。
5、<javac标签>
该标签用于编译一个或一组java文件,其属性如下:
-----srcdir 表示java源程序的目录。
-----destdir 表示class文件的输出目录。
-----includes 表示别归档的文件模式。
-----exchudes 表示被排除的文件模式。
-----debug 表示包含的调试信息。
-----optimize 表示是否使用优化。
-----classpath 表示所使用的类路径。
-----verbose 表示提供详细的输出信息。
-----fileonerror 表示当碰到错误就自动停止
6、<java>标签
该标签用来执行编译生成的.class文件,其属性如下:
-----classname 表示将执行的类名。
-----jar 表示包含该类的JAR文件名。
-----classpath 所表示用到的类路径。
-----fork 表示在一个新的虚拟机中运行该类。
-----failonerror 表示当出现错误时自动停止。
-----output 表示输出文件。
-----append 表示追加或者覆盖默认文件。
7、<delete>标签
该标签用于删除一个文件或一组文件,其属性如下:
-----file 表示要删除的文件。
-----dir 表示要删除的目录。
-----includeEmptyDirs 表示指定是否要删除空目录,默认值是删除。
-----failonerror 表示指定当碰到错误是否停止,默认值是自动停止。
-----verbose 表示指定是否列出所删除的文件,默认值为不列出。
8、<copy>标签
该标签用于文件或文件集的拷贝,其属性如下:
-----file 表示源文件。
-----tofile 表示目标文件。
-----todir 表示目标目录。
-----overwrite 表示指定是否覆盖目标文件,默认值是不覆盖。
-----includeEmptyDirs 表示制定是否拷贝空目录,默认值为拷贝。
-----failonerror 表示指定如目标没有发现是否自动停止,默认值是停止。
-----verbose 表示制定是否显示详细信息,默认值不显示。
9、<war>标签
该标签用来生成一个WAR包,其属性如下:
-----destfile 表示生产JAR文件名。
-----dir 表示被归档的文件目录。
-----includes 表示别归档的文件模式。
-----exchudes 表示被排除的文件模式。
10、<echo>标签
该标签用来在控制台输出信息,其输入如下:
-----message表示输入的内容。
11、<exec>执行文件:
<exec executable="${base.dir}/email.bat" >
</exec>
<exec executable="cmd" dir="D:\" failοnerrοr="true">
<arg line="/c del 1.bat" />
</exec>
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
Ant的数据类型
在构建文件中为了标识文件或文件组,经常需要使用数据类型。数据类型包含在
org.apache.tool.ant.types包中。简单介绍构建文件中一些常用的数据类型。
1、argument 类型
由Ant构建文件调用的程序,可以通过<arg>元素向其传递命令行参数,如apply,exec
和java任务均可接受嵌套<arg>元素,可以为各自的过程调用指定参数。以下是<arg>
的所有属性:values 是一个命令参数,如果参数有空格,但又想将它作为单独一个值,
则使用此属性。
-----file 表示一个参数的文件名。在构建文件中,此文件名相对于当前的工
作目录。
-----line 表示用空格分隔的多个参数列表。
-----path 表示路径。
2、ervironment 类型
由Ant构建文件调用的外部命令或程序,<env>元素制定了哪些环境变量要传递给正在
执行的系统命令,<env>元素可以接受以下属性:
-----file 表示环境变量值得文件名。此文件名要被转换位一个绝对路径。
-----path 表示环境变量的路径。Ant会将它转换为一个本地约定。
-----value 表示环境变量的一个直接变量。
-----key 表示环境变量名。
注意:file、path或value只能取一个。
3、filelist类型
Filelist是一个支持命名的文件列表的数据类型,包含在一个filelist类型中的
文件不一定是存在的文件。以下是其所有的属性:
-----dir 是用于计算绝对文件名的目录。
-----files 是用逗号分隔的文件名列表。
-----refid 是对某处定义的一个<filelist>的引用。
注意:dir和files都是必要的,除非指定了refid(这种情况下,dir和files都不允许
使用)。
4.fileset类型
Fileset 数据类型定义了一组文件,并通常表示为<fileset>元素。不过,许多ant任
务构建成了隐式的fileset,这说明他们支持所有的fileset属性和嵌套元素。以下为
fileset 的属性列表。
-----dir表示fileset 的基目录。
-----casesensitive 的值如果为false,那么匹配文件名时,fileset不是区分
大小写的,其默认值为true.
-----defaultexcludes 用来确定是否使用默认的排除模式,默认为true。
-----excludes 是用逗号分隔的需要派出的文件模式列表。
-----excludesfile 表示每行包含一个排除模式的文件的文件名。
-----includes 是用逗号分隔的,需要包含的文件模式列表。
-----includesfile 表示每行包括一个包含模式的文件名。
5.patternset 类型 Fileset 是对文件的分组,而patternset是对模式的分组,他们
是紧密相关的概念。
<patternset>支持4个属性:includes excludex includexfile 和 excludesfile,与
fileset相同。Patternset 还允许以下嵌套元素:include,exclude,includefile 和
excludesfile.
6.filterset 类型
Filterset定义了一组过滤器,这些过滤器将在文件移动或复制时完成文件的文本替换。
主要属性如下:
-----begintoken 表示嵌套过滤器所搜索的记号,这是标识其开始的字符串。
-----endtoken 表示嵌套过滤器所搜索的记号这是标识其结束的字符串。
-----id 是过滤器的唯一标志符。
-----refid 是对构建文件中某处定义一个过滤器的引用。
7.Path类型Path元素用来表示一个类路径,不过它还可以用于表示其他的路径。在用作
多个属性时,路径中的各项用分号或冒号隔开。在构建的时候,此分隔符将代替当前平
台中所有的路径分隔符,其拥有的属性如下:
-----location 表示一个文件或目录。Ant在内部将此扩展为一个绝对路径。
-----refid 是对当前构建文件中某处定义的一个path的引用。
-----path 表示一个文件或路径名列表。
8.mapper类型Mapper类型定义了一组输入文件和一组输出文件间的关系,其属性如下:
-----classname 表示实现mapper类的类名。当内置mapper不满足要求时,
用于创建定制mapper.
-----classpath 表示查找一个定制mapper时所用的类型路径。
-----classpathref 是对某处定义的一个类路径的引用。
-----from 属性的含义取决于所用的mapper.
-----to 属性的含义取决于所用的mapper.
-----type 属性的取值为identity,flatten glob merge regexp
其中之一,它定义了要是用的内置mapper的类型。
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
<mkdir dir="build/classes"/>
-----------------------------------------------------------
<copy file="myfile.txt" tofile="mycopy.txt"/>
-----------------------------------------------------------
<copy file="myfile.txt" todir="../some/other/dir"/>
-----------------------------------------------------------
<copy todir="../new/dir">
<fileset dir="src_dir"/>
</copy>
-----------------------------------------------------------
<copy todir="../dest/dir">
<fileset dir="src_dir">
<include name="**/*.java"/>
<exclude name="**/Test.java"/>
</fileset>
</copy>
-----------------------------------------------------------
<copy todir="../dest/dir">
<fileset dir="src_dir" excludes="**/*.java"/>
</copy>
-----------------------------------------------------------
<copy todir="../backup/dir">
<fileset dir="src_dir"/>
<mapper type="glob" from="*" to="*.bak"/>
</copy>
-----------------------------------------------------------
拷贝一组文件到指定目录下,替换其中的 @ @ 标签内容
<copy todir="../backup/dir">
<fileset dir="src_dir"/>
<filterset>
<filter token="TITLE" value="Foo Bar"/>
</filterset>
</copy>
-----------------------------------------------------------
<delete file="/lib/ant.jar"/>
-----------------------------------------------------------
<delete>
<fileset dir="." includes="**/*.bak"/>
</delete>
-----------------------------------------------------------
<delete includeEmptyDirs="true">
<fileset dir="build"/>
</delete>
-----------------------------------------------------------
<move file="file.orig" tofile="file.moved"/>
-----------------------------------------------------------
<move todir="new/dir/to/move/to">
<fileset dir="src/dir"/>
</move>
-----------------------------------------------------------
<move todir="some/new/dir">
<fileset dir="my/src/dir">
<include name="**/*.jar"/>
<exclude name="**/ant.jar"/>
</fileset>
</move>
-----------------------------------------------------------
-----------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
------------------------------------------------------------------------
杂七杂八
复制:
<?xml version="1.0" encoding="UTF-8" ?>
<project name="fileset" > <!--定义文件集-->
<fileset dir="src"
includes="**/*.java"
id="source.fileset" />
<target name="copy">
<!--定义目标,复制,并且backup是自动创建的,
refid[--reference id]
-->
<copy todir="backup">
<fileset refid="source.fileset" />
</copy>
</target>
</project>
属性设置:
ant -Dstruts.jar=/home/ant/newstruts/struts.jar
文件中 ${structs.jar}
JDK javac命令,ant javac版本
javac -classpath
<classpath>
<pathelement location="lib/some.jar;lib/other.jar" />
<!--可以是一个文件-->
<pathelement path="lib/classes" /><!--可以是一个文件列表-->
</classpath>
javac -sourcepath
<src path="src" />
或者 srcdir="src"
javac -d
destdir="build/classes"
-g debug="yes"
-g:none debug="no"
-verbose verbose="true"
fileset的casesensitive="false"来取消大小写的限制
映射,用来做一组任务
1、他们不做具体的动作(比如编译、拷贝、移动文件,等等)
2、但是可以跟<uptodate>,<move>,<copy>,<apply>一起合
作去处理别的其他任务
内置的映射类型:
identity,faltten,merge,glob,regexp,package,uppackage
所有映射区分大小写
<mapper type="identity">
等同映射,目标文件和源文件的名字一样
<mapper type="identity">
扁平映射,目标文件和源文件名字一致,但是把原来源文件
的文件夹去除
<mapper type="merge" to="jsp.zip" />
时间戳比较合并映射,目标文件都是同一个,都是由to属性指定
无法出现效果,jsp.zip出错
<mapper type="glob" from="*.jsp" to="*.jsp.bak" />
全局映射,from模式中用*指代的部由to模式中的内容替代,
只对匹配from模式的文件进行操作
from="C*.jsp" to="A*.jsp.bak"
C--->A 替换
*--->* 不考虑
.jsp--->.jsp.bak 替换
<mapper type="package" from="*.jsp" to="bak-*.java" />
包映射,将包的/转换成.的文件
<mapper type="package" from="bak*.jsp" to="*.java" />
解包映射,将包的.转换成/的文件
property设置属性
1、name/value属性
2、name/location属性
3、通过从一个属性文件中导入一组属性,这个文件的名字可能类似
于build.properties
4、通过加载环境变量作为参数
参考: http://blog.csdn.net/yangdayin/article/details/7681567
http://xiyang.09.blog.163.com/blog/static/59827615201221354537366/