Ant使用说明

 

Ant在自动构建和部署Java程序方面方便易用，而且非常灵活，通过Ant可以实现编译、运行java程序，以及打jar包、war包等功能。

 

 

一、Ant安装配置

 

1.下载安装
下载http://www.apache.org/dist/ant/binaries下的apache-ant-1.7.1-bin.zip
解压即可。

2.ant的配置
1) 在环境变量中设置ANT_HOME，值为你的安装目录ANT安装目录
2) 在环境变量中设置JAVA_HOME，值为你的jdk安装目录
3) 把ANT_HOME/bin，JAVA_HOME/bin加到你系统的path目录中去。 

3.测试是否成功
DOS输入
ant  -version回车，看到输出说明配置成功。
javac 和 java 回车，有帮助信息则说明JDK配置成功。

 

二、Ant关键元素

 

Ant 的关键元素 project 、 target 、 property 和 task 。

1.        project 元素

project 元素是 Ant 构件文件的根元素， Ant 构件文件至少应该包含一个 project 元素，否则会发生错误。在每个 project 元素下，可包含多个 target 元素。接下来向读者展示一下 project 元素的各属性。

1 ） name 属性

用于指定 project 元素的名称。

2 ） default 属性

用于指定 project 默认执行时所执行的 target 的名称。

3 ） basedir 属性

用于指定基路径的位置。该属性没有指定时，使用 Ant 的构件文件的附目录作为基准目录。

 

2.        target 元素

它为 Ant 的基本执行单元，它可以包含一个或多个具体的任务。多个 target 可以存在相互依赖关系。它有如下属性：

1 ） name 属性

指定 target 元素的名称，这个属性在一个 project 元素中是唯一的。我们可以通过指定 target 元素的名称来指定某个 target 。

2 ） depends 属性

用于描述 target 之间的依赖关系，若与多个 target 存在依赖关系时，需要以“ , ”间隔。 Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target 。被依赖的 target 会先执行。

3 ） if 属性

用于验证指定的属性是否存在，若不存在，所在 target 将不会被执行。

4 ） unless 属性

该属性的功能与 if 属性的功能正好相反，它也用于验证指定的属性是否存在，若不存在，所在 target 将会被执行。

5 ） description 属性

该属性是关于 target 功能的简短描述和说明。

3.        property 元素

该元素可看作参量或者参数的定义， project 的属性可以通过 property 元素来设定，也可在 Ant 之外设定。若要在外部引入某文件，例如 build.properties 文件，可以通过如下内容将其引入： <property file=” build.properties”/>

property 元素可用作 task 的属性值。在 task 中是通过将属性名放在“ ${ ”和“ } ”之间，并放在 task 属性值的位置来实现的。

Ant 提供了一些内置的属性，它能得到的系统属性的列表与 Java 文档中 System.getPropertis() 方法得到的属性一致，这些系统属性可参考 sun 网站的说明。

同时， Ant 还提供了一些它自己的内置属性，如下：

basedir ： project 基目录的绝对路径，该属性在讲解 project 元素时有详细说明，不再赘述；

ant.file ： buildfile 的绝对路径，如上面的各例子中， ant.file 的值为 E:"build.xml ；

ant.version ： Ant 的版本，在本文中，值为 1.7.0 ；

ant.project.name ：当前指定的 project 的名字，即前文说到的 project 的 name 属性的值；

ant.java.version ： Ant 检测到的 JDK 的版本，在上例运行结果中可看到为 1.5 。

 

 

三、Ant常用任务

在 Ant 工具中每一个任务封装了具体要执行的功能，是 Ant 工具的基本执行单位。在本小节中，主要引导读者来看下 Ant 的常用任务及其使用举例。

1.        copy 任务

该任务主要用来对文件和目录的复制功能。举例如下：

Eg1. 复制单个文件： <copy file="file.txt" tofile="copy.txt"/>

Eg2. 对文件目录进行复制：

   <copy todir="../newdir/dest_dir">

            <fileset dir="src_dir"/>

 </copy>

Eg3. 将文件复制到另外的目录：

 <copy file="file.txt" todir="../other/dir"/>

2.        delete 任务

对文件或目录进行删除，举例如下：

Eg1. 删除某个文件： <delete file="photo/amigo.jpg"/>

Eg2. 删除某个目录： <delete dir="photo"/>

Eg3. 删除所有的备份目录或空目录：

        <delete includeEmptyDirs="true">

               <fileset dir="." includes="**/*.bak"/>

        </delete>

3.        mkdir 任务

创建目录。 eg ： <mkdir dir="build"/>

4.        move 任务

移动文件或目录，举例如下：

Eg1. 移动单个文件： <move file="fromfile" tofile=”tofile”/>

Eg2. 移动单个文件到另一个目录： <move file="fromfile" todir=”movedir”/>

Eg3. 移动某个目录到另一个目录：

        <move todir="newdir">

               <fileset dir="olddir"/>

        </move>

5.        echo 任务

该任务的作用是根据日志或监控器的级别输出信息。它包括 message 、 file 、 append 和 level 四个属性，举例如下：

<echo message="Hello,Amigo" file="logs/system.log" append="true">

 

 

四、ant执行命令的详细参数
-buildfile<file>,-file<file>,-f<file> :要指定执行构件的的位置和名称。
-find<file>,-s<file>: 查找构件文件，并执行找到的构件文件。
-help,-p:显示ant的命令帮助信息。在命令行中显示ant的命令选项及简短的介绍，-h是简写。
-version:显示ant 的版本信息。
-diagnostics：显示ant项目的运行环境、依赖库等信息，为错误诊断和报告提供一些有用的帮助信息。
-quiet，-q: 隐藏ant执行的提示输出信息。命令行将不会输出具体的target的执行信息。
-verbose，-v： 显示ant执行的详细信息，包括操作系统和Java环境等信息。
-debug，-d：显示ant执行调试的信息、详细的log信息。
-lib<path>:指定一个类库所在的位置（jar文件位置），让ant工具可以使用这些类文件。path类型指定类库文件。
-logfile<file>,-l<file>:指定ant执行时日志输出文件，让日志输出到指定文件而不在命令行输出。
例如：执行 ant -f test.xml -l c:\testAntLog.log 将会百日志信息输出到c:\testAntLog.log去。
-D<property>=<value>:用于设定一些变量，这些变量可以在target中直接引用，或覆盖已设定的属性值。
例如：ant -f test.xml -D src=hello

 

五、Ant系统属性  (用${}来获取属性值 例如:${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中经常甬道。

 

 

附件包括2个ant配置实例：

build.xml 默认Ant配置文件（Application）

build.properties 默认Ant配置所引用的属性文件（Application）

svn.properties Ant和svn整合的属性文件（Application）

 

antBuild.xml 利用Ant部署Web应用（Web）

antBuild.properties利用Ant部署Web应用的属性文件（Web）