ant 使用指南

一、概述ant 是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java 环境中的软件开发。

在实际软件开发中，有很多地方可以用到ant。

开发环境：System：WindowsJDK：1.6+IDE：eclipseant：1.9.1Email：hoojo_@Blog：/IBM_hoojo/二、优点ant 是Apache软件基金会JAKARTA目录中的一个子项目，它有以下的优点：1、跨平台性：Ant是纯Java语言编写的，所以具有很好的跨平台性。

2、操作简单：Ant是由一个内置任务和可选任务组成的，用ant任务就像是在dos中写命令行一样。

Ant运行时需要一个XML文件(构建文件)。

Ant通过调用target树，就可以执行各种task。

每个task实现了特定接口对象。

3、维护简单、可读性好、集成简单：由于Ant构建文件时XML格式的文件，所以很容易维护和书写，而且结构很清晰。

Ant可以集成到开发环境中。

由于Ant的跨平台性和操作简单的特点，它很容易集成到一些开发环境中去。

三、安装和配置1、下载ant，/apache//ant/binaries/apache-ant-1.9.1-bin.zip2、解压zip压缩包，将压缩包放置你要放置的目录。

我这里放置在D:\apache-ant-1.9.1，目录结构如下：bin是ant的程序运行入口，如果没有配置ANT_HOME的情况下，可以通过bin目录中的bat 程序进行运行build任务。

如：在cmd中运行ant.bat就可以执行程序，当然你选择要当前目录中存在一个build.xml （build.xml是默认的ant执行文件，当然你可以指定其他文件）etc目录中存放的都是一些xsl的输出模板，创建一个加强的导出各种任务的XML输出，使你的build文件摆脱过时的警告lib目录中存放的是ant程序需要依赖的jar包manual目录是ant程序的帮助文档3、在我的电脑–>右键属性–>高级系统配置->环境变量中配置ant新建系统变量ANT_HOME = D:\apache-ant-1.9.1这样环境变量就配置好了，但前提你需要配置jdk的环境变量。

如果你没有配置jdk的环境变量，那么请你先配置好jdk变量。

jdk环境配置方法如下：(1)，安装JDk到其默认目录：C:\Program Files\Java\jdk1.5.0_05 （没有jdk去官方下载一个）C:\Program Files\Java\jdk1.5.0作用：告诉系统JVM在什么地方(2)，右击我的电脑，选属性，高级，环境变量(3)，在系统变量栏点新建，出现新建系统变量对话框，在变量名中填上JAVA_HOME ,变量值：C:\Program Files\Java\jdk1.5.0_05(4)，确定后在系统变量(S)栏再新建一个环境变量CLASSPATH,变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（开头的dot和;不能少）(5)，确定后在系统变量(S)栏查找并选中变量为Path的选项，点编辑在变量值(V)的末尾添加：%JAVA_HOME%\bin如果没有找到PATH变量，自己新建一个！如果你不想每次运行都要cmd到class所在目录然后执行java命令，可以把所有的class文件放到统一的目录组织下，然后将此目录也追加到CLASSPATH下。

测试代码如下：public class Test {public static void main(String[] args) {System.out.println("Hello World!");}}用记事本编辑后存为Test.java（文件名与类名相同）文件，打开命令行窗口，cd到文件所在目录下:javac Test.java //编译命令java Test //执行程序如果输出为：Hello World! OK,配置完毕，否则，重新检查。

四、测试ant在启动，运行cmd的dos窗口中输入ant，如图：如果出现这个，那么恭喜你安装成功了！否则就失败了，检查下前面的步骤有没有错误。

上面命令会执行ant程序，ant默认执行build.xml中的任务，这里在Administrator目录中没有这个文件。

如果安装失败，你看看是否存在一些情况：1、没有配置JAVA_HOME 或配置错误，并且JAVA_HOME\bin\java.exe存在2、没有配置ANT_HOEM 或配置错误，并且ANT_HOME\bin\ant.bat存在3、检查你的环境变量的path变量中，有木有配置...;%ANT_HOME%\bin;...%PATH%=...maybe-other-entries...;%ANT_HOME%\bin;...maybe-other-entries...五、ant的运行时环境ant在运行命令的时候，有时候会出现一些公园的jar库。

这些库会存在于每个ant工程中，那么这个时候我们可以把这个jar包放到ant_home\lib目录中作为全局的库使用。

如果你不想“污染”原始的ant程序，那么你可以把jar包放在当前windows用户的目录下，具体位置应该是${user.home}/.ant/lib 下。

没有以上目录可以手动建立。

如果你只是临时要添加lib，又不想把lib添加到当前ant工程中。

你可以在运行ant程序的时候指定依赖的lib参数。

同时，你还可以在当前build工程的classpath目录中添加你的工程依赖jar包。

六、ant命令语法元素说明如下：-help显示描述ant 命令及其选项的帮助信息-projecthelp显示包含在构建文件中的、所有用户编写的帮助文档。

即为各个<target>中description 属性的文本，以及包含在<description>元素中的任何文本。

将有description 属性的目标列为主目标（Main target），没有此属性的目标则列为子目标（Subtarget）。

-version要求ant 显示其版本信息，然后退出。

-quiet抑制并非由构建文件中的echo 任务所产生的大多数消息。

-verbose显示构建过程中每个操作的详细消息。

此选项与-debug 选项只能选其一。

-debug显示Ant 和任务开发人员已经标志为调试消息的消息。

此选项与-verbose 只能选其一。

-emacs对日志消息进行格式化，使它们能够很容易地由Emacs 的shell 模式（shellmode）所解析；也就是说，打印任务事件，但并不缩排，在其之前也没有[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在命令行上定义一个特性名－值对。

-find filename指定Ant 应当处理的构建文件。

与-buildfile 选项不同，如果所指定文件在当前目录中未找到，-find 就要求Ant 在其父目录中再进行搜索。

这种搜索会继续在其祖先目录中进行，直至达到文件系统的根为止，在此如果文件还未找到，则构建失败。

-atuoproxy jdk1.5以上的可以使用代理设置-nouserlib 运行ant时不使用用户lib中的jar包-nice 设计主线程优先级-logfile 使用指定的log日志-noinput 不允许交互输入-keep-going, -k 执行不依赖于所有目标-propertyfile 加载所有属性配置文件-d 属性文件优先<project default="all"><property name="pro_a"value="a value"/><property name="pro_b"value="b value"/><path id="rt.path"><pathelement location="${java.home}/jre/lib/rt.jar"/></path><target name="all"><javac srcdir="."><classpath refid="a.path"/></javac></target></project>注意：● 所有构建文件都要有<project>元素，而且至少有一个<target>元素。

● 对于<project>元素的default 属性并不一定需要默认值。

● 构建文件并不一定要被命名为build.xml。

不过build.xml 是ant 要搜索的默认文件名。

● 每个构建文件只能有一个<project>元素。

在cmd窗口中进入到当前build.xml目录ant在当前目录下的build.xml运行Ant，执行缺省的target。

ant -buildfile build-test.xml在当前目录下的build-test.xml运行Ant，执行缺省的target。

ant -buildfile build-test.xml clean在当前目录下的build-test.xml运行Ant，执行一个叫做clean的target。

ant -buildfile build-test.xml -Dbuild=build/classes clean在当前目录下的build-test.xml运行Ant，执行一个叫做clean的target，并设定build属性的值为build/classes。

七、ant脚本：使用节点、元素和属性、命令指令1、project 节点元素project 元素是Ant 构件文件的根元素，Ant 构件文件至少应该包含一个project 元素，否则会发生错误。