ant使用指南详细入门教程

一、概述

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

开发环境：
复制代码 代码如下:
System：Windows
JDK：1.6+
IDE：eclipse
ant：1.9.1

二、优点

ant 是Apache软件基金会JAKARTA目录中的一个子项目，它有以下的优点：
1、跨平台性：Ant是纯Java语言编写的，所以具有很好的跨平台性。
2、操作简单：Ant是由一个内置任务和可选任务组成的，用ant任务就像是在dos中写命令行一样。Ant运行时需要一个XML文件(构建文件)。 Ant通过调用target树，就可以执行各种task。每个task实现了特定接口对象。
3、维护简单、可读性好、集成简单：由于Ant构建文件 时XML格式的文件，所以很容易维护和书写，而且结构很清晰。Ant可以集成到开发环境中。由于Ant的跨平台性和操作简单的特点，它很容易集成到一些开发环境中去。

三、安装和配置

1、下载ant，http://mirror.esocc.com/apache//ant/binaries/apache-ant-1.9.1-bin.zip

2、解压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 FilesJavajdk1.5.0_05 （没有jdk去官方下载一个）
C:Program FilesJavajdk1.5.0
作用：告诉系统JVM在什么地方

(2)，右击我的电脑，选属性，高级，环境变量
(3)，在系统变量栏点新建，出现新建系统变量对话框，在变量名中填上JAVA_HOME ,变量值：C:Program FilesJavajdk1.5.0_05
(4)，确定后在系统变量(S)栏再新建一个环境变量CLASSPATH,变量值：.;%JAVA_HOME%libdt.jar;%JAVA_HOME%libtools.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_HOMEbinjava.exe存在

2、没有配置ANT_HOEM 或配置错误，并且ANT_HOMEbinant.bat存在

3、检查你的环境变量的path变量中，有木有配置...;%ANT_HOME%bin;...

%PATH%=...maybe-other-entries...;%ANT_HOME%bin;...maybe-other-entries...

五、ant的运行时环境

ant在运行命令的时候，有时候会出现一些公园的jar库。这些库会存在于每个ant工程中，那么这个时候我们可以把这个jar包放到ant_homelib目录中作为全局的库使用。

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

如果你只是临时要添加lib，又不想把lib添加到当前ant工程中。你可以在运行ant程序的时候指定依赖的lib参数。

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

六、ant命令

语法元素说明如下：
-help
显示描述ant 命令及其选项的帮助信息
-projecthelp
显示包含在构建文件中的、所有用户编写的帮助文档。即为各个中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 属性文件优先

复制代码 代码如下:

   
   
   
   
       
   
   
   
       
           
       
   

注意：
● 所有构建文件都要有元素，而且至少有一个 元素。
● 对于 元素的default 属性并不一定需要默认值。
● 构建文件并不一定要被命名为build.xml。不过build.xml 是ant 要搜索的默认文件名。
● 每个构建文件只能有一个 元素。

在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 元素，否则会发生错误。在每个 project 元素下，可包含多个 target 元素。接下来向读者展示一下 project 元素的各属性。
● name 属性：用于指定 project 元素的名称。
● default 属性：用于指定 project 默认执行时所执行的 target 的名称。
● basedir 属性：用于指定基路径的位置。该属性没有指定时，使用 Ant 的构件文件的附目录作为基准目录。
复制代码 代码如下:


   
       
   

从上例可以看出，在这里定义了default 属性的值为print-dir，即当运行ant 命令时，如果没有指明执行的target，则将执行默认的target（print-dir）。此外，还定义了basedir 属性的值为 “.” ，.表示当前目录，进入当前目录后运行ant 命令，得一下结果：

2、target节点元素

target为ant的基本执行单元或是任务，它可以包含一个或多个具体的单元/任务。多个target 可以存在相互依赖关系。它有如下属性：
● name 属性：指定 target 元素的名称，这个属性在一个 project 元素中是唯一的。我们可以通过指定 target 元素的名称来指定某个 target 。
● depends 属性：用于描述 target 之间的依赖关系，若与多个 target 存在依赖关系时，需要以“,”间隔。 Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target ，被依赖的target 会先执行。
● if 属性：用于验证指定的属性是存在，若不存在，所在 target 将不会被执行。
● unless 属性：该属性的功能与 if 属性的功能正好相反，它也用于验证指定的属性是否存在，若不存在，所在 target 将会被执行。
● description 属性：该属性是关于 target 功能的简短描述和说明。
示例：
复制代码 代码如下:


   
       
   
   
       
            a depend example!
       
       
   


从以下结果后可以看到，我们运行的是名为 print的target ，由于它依赖于version这个target任务，所以 version将首先被执行，同时因为系统配置了JDK，所以 ant.java.version 属性存在，执行了version，输出信息："[echo] Java Version: 1.6 "，version执行完毕后，接着执行 print，因为docs不存在，而unless属性是在不存在时进入所在target 的，由此可知 print得以执行，输出信息："[echo] The base dir is:D:WorkspaceAntExamplebuild"。

3、property属性节点元素

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

property 元素可用作 task 的属性值。在 task 中是通过将属性名放在${属性名}之间，并放在 task 属性值的位置来实现的。
Ant 提供了一些内置的属性，它能得到的系统属性的列表与 Java 文档中 System.getProperties() 方法得到的属性一致，这些系统属性可参考 sun 网站的说明。同时， Ant 还提供了一些它自己的内置属性，如下：
basedir： project 基目录的绝对路径；  
ant.file： buildfile的绝对路径，上例中ant.file值为D:WorkspaceAntExamplebuild；
ant.version： Ant 的版本信息，本文为1.8.1 ；
ant.project.name： 当前指定的project的名字，即前文说到的project的name属性值；
ant.java.version： Ant 检测到的JDK版本，本文为 1.6 。

举例说明如下：
复制代码 代码如下:

   
   
   
       
   


上例中用户设置了名为name 和age的两个属性，这两个属性设置后，在下文中可以通过 ${name} 和 ${age} 分别取得这两个属性值。

4、copy命令

copy主要用来对文件和目录的复制功能。举例如下：
● 复制单个文件：
复制代码 代码如下:


● 对文件目录进行复制：
复制代码 代码如下:

   


● 将文件复制到另外的目录：
复制代码 代码如下:


5、delete命令

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

● 删除某个文件：
复制代码 代码如下:


● 删除某个目录：   
复制代码 代码如下:


● 删除所有的jar文件或空目录：
复制代码 代码如下:

      
       
   
   
   
   

 

   

16、patternset 类型

fileset 是对文件的分组，而patternset是对模式的分组，他们是紧密相关的概念。

支持4个属性：includes、excludex、includexfile、excludesfile，这些与fileset相同。

patternset 还允许以下嵌套元素：include,exclude,includefile 和 excludesfile.

示例
复制代码 代码如下:


 

 
 

 
 
 
 
 
 
   
   
 

 


 

 

 

18、path类型

path元素用来表示一个类路径，不过它还可以用于表示其他的路径。在用作几个属性时，路经中的各项用分号或冒号隔开。在构建的时候，此分隔符将代替当前平台中所有的路径分隔符，其拥有的属性如下。
● location 表示一个文件或目录。Ant在内部将此扩展为一个绝对路径。
● refid 是对当前构建文件中某处定义的一个path的引用。
● path表示一个文件或路径名列表。

示例
复制代码 代码如下:

   
   
   

 

   
       
   

八、ant编译打包、运行工程
复制代码 代码如下:



   
   
   
   
   
   
   
   
       
       
       
       
   
   
   
   
       
       
   
   
   
   
       
       
           
           
               
               
           
       
       
       
       
           
             
               
             
       
       
       
           
               
                   
                   
               
           
       
       
       
       
       
       
       
       
       
       
       
   
   
   
   
       
   
   
   
   
       
       
       
   
   
   
                      pattern="HH:mm:ss"
               offset="10" unit="minute"/>
   
   
   
   
       
       
       
   


要说的的东西基本上就那么多，ant还有很多内容没有提到，有兴趣的可以自己去研究研究。ant不难，你用它就像是在docs控制台输入命令行一样，只不过ant是将命令行转换为xml的脚本信息，可以进行重复的运行。在一定情况下，提高了效率和重复的工作。