Ant学习

简单的说，Ant是一个基于Java，并且主要用于Java工程的构建工具。Ant本意是Another Neat Tool，也就是另一种整洁的工具，取首字符就是Ant。

构建工具就是为了减少重复工作而产生的。

1. Ant的一些核心概念：

XML：构建文件是以XML文件来描述的，采用XML格式有很多好。这里就不一一列举。

陈述式语法：构建文件短小精悍，且易于理解。

每个构建文件包含一个工程（project）。

每个工程包含若干个目标（target）。

目标可以依赖于其他的目标（depends）。

目标包含任务（task）。

易于使用Java语言增加新的任务--易于扩展（自定义）。

 

2. Ant结构

Ant的结构如下图所示：

构建文件的概念视图：工程包含一个目标的集合。在每个目标里是任务的声明，它们是对Ant用于构建目标的行为说明。目标生成一个依赖关系图表来声明该目标的依赖关系。当执行一个目标时，必须先执行它们依赖的目标。

 

例子：一个典型的构建文件：

<?xml version="1.0" ?> <project name="OurProject" default="deploy"> <target name="init"> <mkdir dir="build/classes" /> <mkdir dir="dist" /> </target> <target name="compile" depends="init"> <javac srcdir="src" destdir="build/classes" /> </target> <target name="doc" depends="init"> <javadoc destdir="build/classes" sourcepath="src" packagenames="org.*" /> </target> <target name="deploy" depends="compile,doc"> <jar destfile="dist/project.jar" basedir="build/classes" /> <ftp server="" userid="" password=""> <fileset dir="dist" /> </ftp> </target> </project>

该构建过程如下：

系统初始化、编译、生成Javadoc、打包、上传到FTP，其中后两步结合到一起叫部署。

执行时输出如下：

>ant -propertyfile ftp.properties Buildfile: build.xml init: [mkdir] Created dir: /home/ant/Projects/OurProject/build/classes [mkdir] Created dir: /home/ant/Proejcts/OurProject/dist compile: [javac] Compiling 1 source file to /home/ant/Projects/OurProject/build/classes doc: [javadoc] Generating Javadoc [javadoc] Javadoc execution [javadoc] Loading source files for package org.example.antbook.lesson1... [javadoc] Constructing Javadoc information... [javadoc] Building tree for all the packages and classes... [javadoc] Building index for all the packages and classes... [javadoc] Building index for all classes... deploy: [jar] Building jar: /home/ant/Projects/OurProject/dist/project.jar [ftp] sending files [ftp] 1 files sent BUILD SUCCESSFUL Total time: 5 seconds.

在执行时使用命令行参数以传入一个属性文件，属性文件中包含连接FTP服务器使用的服务器名，用户名用户密码来给特性使用。

这个例子很好的展示了Ant的一些基本要素：目标依赖、特性的使用、编译、文档生成、JAR打包(tar,Zip,WAR,EAR等)，最后是部署。

Ant的简单任务(<mkdir>)都是由Java类库来实现相应的功能。而一些复杂的任务<ftp>、<junit>还需要第三方库的支持。

Ant的一个强大之处：它总能工作。只要正确的指定构建文件，Ant就能计算出目标的依赖性，并且按照正确的顺序调用目标。目标通过任务按序执行，而任务自身处理其文件依赖性以及实际的操作来完成工作。因为每个任务通常都是在高层陈述，所以一两行XML语句经常就已经足够描述任务的内容。

3.       运行第一个构建文件：

首先创建一个Java工程，名为AntProject，工程中源文件和目标文件是分开的，分别为文件夹src和bin,然后创建一个Java类文件，类名为

com.neusoft.test.AntTest，只是为了测试，所以类的内容很简单：

package com.neusoft.test; /** *This is just a test class. */ public class AntTest{ public static void main(String[] args){ for(int i=0;i<args.length;i++){ System.out.println(args[i]); } } } 

 

然后我们在工程的路径下面建立一个构建文件build.xml，内容如下：

<?xml version="1.0" ?> <project name="structured" default="archive" > <target name="init"> <mkdir dir="build/classes" /> <mkdir dir="dist" /> </target> <target name="compile" depends="init" > <javac srcdir="src" destdir="build/classes"/> </target> <target name="archive" depends="compile" > <jar destfile="dist/project.jar" basedir="build/classes" /> </target> <target name="clean" depends="init"> <delete dir="build" /> <delete dir="dist" /> </target> </project>

Ant构建文件总是有一个<project>元素做为根元素，它有两个属性，name和 default，<target>元素是<project>元素的子元素，可以有多个，它有两个属性，name和 depends，<target>元素包含的元素就是一些任务元素。

<target> 可以由命令行进行显示的调用，也可以在内部使用如可以直接调用ant init、ant compile等。如果不写参数，则默认的build文件是build.xml，默认的目标是<project>的default属性定义的目标。目标的名称是唯一的，可以是任意字符串。

 

下面我们先运行一下这个Ant构建，再讲解其他的内容，进入工程目录，执行

ant

这里就相当于执行默认的目标，也就是<project name="structured" default="archive" >中的archive目标。

出现错误时，可以使用

ant ?Cverbose

或者

ant ?Cdebug来获取更加详细的构建信息，以解决问题。

运行程序：

普通执行该类的方法是：

java ?Ccp build/class com.neusoft.test.AntTest args1 args2

而我们使用Ant的任务来执行它仅仅需要增加一个任务，好处在于：

让用于执行的目标依赖与编译的目标，确保运行最新版本

易于传递复杂参数

设置classpath更方便

在Ant自身的JVM中运行，载入更快

增加一个新的目标：

<target name="execute" depends="compile"> <java classname="com.neusoft.test.AntTest" classpath="build/classes"> <arg value="a"/> <arg value="b"/> <arg file="."/> </java> </target>  

最后一个参数是file=”.”，表示传入的参数是一个目录，为文件绝对路径。

当有多个构建文件时，可以指定构建文件：

ant -buildfile build.xml compile

来表示执行build.xml这个构建文件中的compile目标。 

控制提供的信息量：

ant -quiet:安静模式，不给出任何输出。 

ant -emacs:简单模式，不显示任务名称。

      最终的构建文件，添加了description属性。

<?xml version="1.0" ?> <project name="secondbuild" default="execute" > <description>Compiles and runs a simple program</description> <target name="init"> <mkdir dir="build/classes" /> <mkdir dir="dist" /> </target> <target name="compile" depends="init" description="Compiles the source code"> <javac srcdir="src" destdir="build/classes"/> </target> <target name="archive" depends="compile" description="Creates the JAR file"> <jar destfile="dist/project.jar" basedir="build/classes"/> </target> <target name="clean" depends="init" description="Removes the temporary directories used"> <delete dir="build" /> <delete dir="dist" /> </target> <target name="execute" depends="compile" description="Runs the program"> <echo level="warning" message="running" /> <java classname="org.example.antbook.lesson1.Main" classpath="build/classes"> <arg value="a"/> <arg value="b"/> <arg file="."/> </java> </target> </project>