1. 从命令行调用ant的语法:
ant [option [option...]] [target [target...]] option := {-help |-projecthelp |-version |-quiet |-verbose |-debug |-emacs |-logfile filename |-logger classname |-listener classname |-buildfile filename |-Dproperty=value |-find filename}
语法元素说明如下:
-help
显示描述Ant命令及其选项的帮助信息
-projecthelp
显示包含在构建文件中的、所有用户编写的帮助文档。即为各个<target>中description属性的文本,以及包含在<description>元素中的任何文本。将有description属性的目标列为主目标("Main targets"),没有此属性的目标列为子目标("Subtargets")。
-version
要求ant显示其版本信息,然后退出。
-quiet
抑制并非由构建文件中的echo任务所产生的大多数消息。
-verbose
显示构建过程中每个操作的详细消息。此选项与-debug选项只能选其一。
-debug
显示ant和任务开发人员已经标志为调试消息的消息。此选项与-verbose只能选其一。
-emacs
对日志消息进行格式化,使它们能够很容易地由Emacs的shell模式所解析;也就是说,打印任务事件,但并不缩排,在其前也没有[taskname]。
-logfile filename
将日志输出重定向到指定文件
-logger classname
指定一个类来处理ant的日志记录。所指定的类必须实现了org.apache.tools.ant.BuildLogger接口。
-listener classname
为ant声明一个监听类,并增加到其监听者列表中。在ant与IDE或其他Java程序集成时,此选项非常有用。必须将所指定的监听类编写为可以处理ant的构建消息接发。
-buildfile filename
指定ant需要处理的构建文件。默认的构建文件为build.xml。
-Dproperty=value
在命令行上定义一个property-value对。
-find filename
指定ant应当处理的构建文件。与-buildfile选项不同,如果所指定文件在当前目录中未找到,-find就要求ant在其父目录中再进行搜索。这种搜索会继续在其祖先目录中进行,知道达到文件系统的根为止,在此如果文件还未找到,则构建失败。
2. build.xml的构成
有位于不同层次上的三种xml元素,自上而下分别是:
- project
- target
- task
此外还有用来表示数据的xml元素,称作data element,分两类:
- property
- DataType