ant备忘录

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