Ant脚本简介与基础知识

转载请注明原文地址：http://www.cnblogs.com/ygj0930/p/6624003.html

一：Ant是什么

Ant相当于Linux环境下的shell脚本，只不过是用xml文档来编写的。我们知道，在linux环境中，可以通过编写shell脚本，封装一系列繁琐而日常需要经常重复的操作。在需要进行这些操作时，只需运行这个脚本就可以批处理这些操作了。Ant脚本也是一样，只不过它一般是为了方便Java项目的编译、运行、测试、打包等工作服务的。

我们知道，日常开发工作中，一个项目除了编码外，还需单元测试、集成测试、系统测试，测试过程中可能会不断修改代码，然后再测试。这样重复而繁琐的过程是十分耗时间的。在程序编译、测试通过后，还需要打包导出，如果之后需要改变了代码，那么这些工作又要重新再做。Ant的产生，就是为了把我们从这些重复而琐碎的工作中解放出来。

二：Ant能干什么

Ant脚本，通过一个xml文件来制定一系列文件的创建删除任务、编译任务、运行任务、测试任务、打包任务等。我们可以通过ant指令执行这个xml脚本，来批处理这些任务，这样就可以实现“一键”完成编码后的编译、运行、测试、打包导出等工作，使我们可以更加专注于代码的编写与质量。

三：Ant的使用

1：安装配置

下载地址：http://ant.apache.org/

安装：解压得到 apache-ant文件夹，这个就是Ant的安装目录了，复制到你想安置的地方即可。

配置：与设置Java运行环境类型:在系统环境变量中添加：ANT_HOME= XX:\XX\apache-ant （apache-ant所在路径）

在Path环境变量值后面加上：XX:\XX\apache-ant\bin （apache-ant\bin所在路径）

打开cmd，输入 ant ，如果出现以下结果则说明Ant配置成功：



2：编写Ant脚本

一个Ant脚本即可完成至少一个项目的编译、运行、测试、打包等工作。Ant脚本同一命名：build.xml

脚本内容：

1）project 节点：一个脚本相当于一个project，用一个project来统领脚本中的众多操作命令。用这个project对象来指向脚本本身的基本属性。

project 元素是 Ant 构件文件的根元素， Ant 构件文件至少应该包含一个 project 元素，否则会发生错误。

● name 属性：用于指定 project 元素的名称。

● default 属性：用于指定 project 默认执行时所执行的 target 的名称。

● basedir 属性：用于指定基路径的位置。该属性没有指定时，使用 build.xml的目录作为基准目录。

2）property节点：属性节点，相当于Ant脚本中的变量，通过属性值来携带具体内容。在每个任务中通过 ${属性名} 访问其属性值，从而获取内容。

Ant 提供了一些内置的属性，它能得到的系统属性的列表与 Java 文档中 System.getProperties() 方法得到的属性一致。Ant 还提供了一些它自己的内置属性：

basedir： project 基目录的绝对路径；

ant.file： buildfile的绝对路径；

ant.version： Ant 的版本信息；

ant.project.name： 当前指定的project的名字；

ant.java.version： Ant 检测到的JDK版本 。

3）target节点：任务节点。一个target可以制定一个或内嵌更多任务。

target为ant的基本执行单元，它可以包含一个或多个具体的单元/任务。多个target 可以存在相互依赖关系，target的执行顺序可以有两种方式控制：一种是依赖，depends属性，AdependsB，则B先执行；另一种就是内嵌：在target A中通过 <ant target="B">命令执行B任务。

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

● depends 属性：用于描述 target 之间的依赖关系，Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target ，被依赖的target 会先执行。

● if 属性：用于验证指定的属性是存在，若存在，所在 target 才会被执行。

● unless 属性：该属性的功能与 if 属性的功能正好相反，若不存在，所在 target 将会被执行。

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

4）copy命令

copy主要用来对文件和目录的复制功能。

5）delete命令

对文件或目录进行删除。

6） mkdir 命令

创建目录。

7）move 命令

移动文件或目录，

8）echo 命令

在控制台输出信息。它包括 message 、 file 、 append 和 level 四个属性。

9）jar 命令标签：打包成jar包并导出

● destfile：打包导出的JAR路径名，即：导出jar包到哪里。

● basedir：被打包的文件，一般是编译通过的文件。

● includes表示被归档的文件类型。

● exchudes表示被排除的文件类型。

● compress表示是否压缩。

(打包命令标签还有war、tgz，解压包命令uzip)

10）javac 命令标签：编译标签

该标签用于编译一个或一组java文件。

● srcdir表示源程序的目录。

● destdir表示class文件的输出目录。

● include表示被编译的文件的模式。

● excludes表示被排除的文件的模式。

● classpath表示所使用的类路径。

● debug表示包含的调试信息。

● optimize表示是否使用优化。

● verbose 表示提供详细的输出信息。

● fileonerror表示当碰到错误就自动停止。

11）java 命令标签：运行标签

该标签用来执行编译生成的.class文件。

● classname 表示将执行的类名。

● jar表示包含该类的JAR文件名。

● classpath所表示用到的类路径。

● fork表示在一个新的虚拟机中运行该类。

● failonerror表示当出现错误时自动停止。

● output 表示输出文件。

● append表示追加或者覆盖默认文件。

12）arg 参数标签：可以用于定义测试用例，向运行程序进行输入，观察输出

通过<arg>元素向其传递命令行参数。

● values 是一个命令参数。

● file 表示一个参数的文件名。

● line 表示用空格分隔的多个参数列表。

● pathref 引用的path（使用path元素节点定义path）的id

● prefix 前缀

● suffix 后缀

13）path节点：表示一个路径

path元素用来表示一个类路径，不过它还可以用于表示其他的路径。

● location 表示一个文件或目录。Ant在内部将此扩展为一个绝对路径。

● refid 是对当前构建文件中某处定义的一个path的引用。

● path表示一个文件或路径名列表。

3：脚本基本结构解析

<?xml version="1.0" encoding="UTF-8"?>

<!--创建project-->
<project default="默认执行的target" basedir=".">

<!--创建属性标签：携带数据，在下面的target中使用-->
<property name="XX"  XX="xx" />

<!--创建任务-->
<target name="任务名" depends="依赖哪个任务">
<命令标签  属性=“属性值：指明命令执行的具体内容”/>
</target>
</project>

4：执行脚本

ant：在当前目录下的build.xml运行Ant，执行默认的target。
ant -buildfile build-test.xml：在当前目录下的build-test.xml运行Ant，执行默认的target。
ant -buildfile build-test.xml targetName：在当前目录下的build-test.xml运行Ant，根据任务名执行一个target。
ant -buildfile build-test.xml -D属性=属性值 targetName：在当前目录下的build-test.xml运行Ant，根据任务名执行一个target并指定其某属性为某值。