ant

内容：

－. Ant简介
二．Ant的安装及配置
三：用ant管理项目
四：小技巧

 

本文描述了ant的基本语法及其如何应用于项目的管理
－. Ant简介
可能有许多读者并不了解什么是ant，以及如何使用它。但只要你是用过linux，你应该知道make为何物，当我们编译linux内核及一些软件的源程序时，我们经常需要在控制台下输入make。Make其实就是一个项目管理工具，而ant所实现的功能与make差不多。Ant是apache软件基金会jakarta项目中的一个子项目，由于是基于java编写的，因此具有很好的跨平台性。Ant由一些内置任务（task）和可选择的任务组成（当然你还可以编写自己的任务），使用Make时，你需要写一个Makefile文件，而用ant时则需要写一个build.xml文件。由于采用xml的语法，所以build.xml文件很容易书写和维护，且结构很清晰，而不像Makefile文件有那么多的限制（例如在tab符号前有一个空格的话，命令就不会执行）。Ant的优点远不止这些，它还很容易的集成到一些开发环境中（例如visual age,jbuilder,netbeans）。

二．Ant的安装及配置
安装
Ant目前的版本是1.3，首先到http://jakarta.apache.org/ant/index.html下载ant最新版本1.3，解压到C:/ant(window操作系统) 或者/usr/local/ant（linux操作系统），由于我们要用到xmlc ，而ant1.3中并没有包含它，所以我们需要David.Li为ant写的xmlc任务。具体url为http://www.digitalsesame.com/enhydra/EnhydraAnt20001213.tar.gz。将下载后的文件中的ant.jar替换掉ant1.3中ant.jar.这样ant的版本变为1.2.

2．设置路径
(1):windows98操作系统
编辑C:\enhydra\.bashrc,加入下面三行

export ANT_HOME=/ant
export JAVA_HOME=/jdk-1.2.2
export PATH=${PATH}:${ANT_HOME}/bin

(2):Linux操作系统
编辑/etc/profile或者 用户目录下的.bashrc文件，加入下面三行

export ANT_HOME=/usr/local/ant
export JAVA_HOME=/usr/local/jdk-1.2.2
export PATH=${PATH}:${ANT_HOME}/bin

三：用ant管理项目
1：基本的文件目录结构 解压到任意目录，我们可以看到目录树结构如下
├─bin
├─docs
│ ├─ant2
│ ├─api
│ │ └─org
│ │ └─apache
│ │ └─tools
│ │ ├─ant
│ │ │ ├─taskdefs
│ │ │ │ ├─compilers
│ │ │ │ └─optional
│ │ │ │ ├─clearcase
│ │ │ │ ├─depend
│ │ │ │ │ └─constantpool
│ │ │ │ ├─dotnet
│ │ │ │ ├─ejb
│ │ │ │ ├─ide
│ │ │ │ ├─javacc
│ │ │ │ ├─jlink
│ │ │ │ ├─jsp
│ │ │ │ ├─junit
│ │ │ │ ├─metamata
│ │ │ │ ├─net
│ │ │ │ ├─perforce
│ │ │ │ ├─scm
│ │ │ │ ├─sound
│ │ │ │ └─vss
│ │ │ ├─types
│ │ │ └─util
│ │ │ └─regexp
│ │ ├─mail
│ │ └─tar
│ └─manual
│ ├─CoreTasks
│ ├─CoreTypes
│ ├─Integration
│ └─OptionalTasks
└─lib

 

 

在这个目录树结构中，与传统的项目不同的是，我们用build.xml取代了Makefile，在讲述这个build.xml文件前，我们先了解一个基本的 build.xml文件的结构。

2：build.xml的基本书写规范
下面我们就来讲述这个文件的书写方法，下面是这个文件的全部内容
1.<?xml version="1.0"?>
2.<project name="MyProject" default="dist" basedir=".">
3.<property name="dist" value="dist"/>
4.<target name="init">
5.<mkdir dir="${dist}"/>
6.</target>
7.</project>

 

为了方便说明，我们为每一行加了行号，第一行是xml文件的基本要素，第二行说明这是一个项目，第七行说明项目的结束 ，在第二行中，name="MyProject"说明此项目的名称，这个属性可有可无。basedir="."说明基本目录，此属性可有可无。default="dist"说明项目的缺省目标(target)是什么，这个属性必须有。所谓目标(target)就是一系列任务(task)组成的一个集合。每个任务(task)的书写方法如下：
<任务名 属性1＝"属性1的值" 属性2＝"属性2的值" ....... />

 

第三行定义了一些属性（property），以便后面使用，这非常类似于编程中定义的全局变量。从第四行开始定义目标(target)，name="init"指明了此目标的名称，name属性在定义目标时必须有，当然定义目标时还有其他一些属性可选，例如depends，unless，具体请参考ant的文档。第五行开始定义此目标内的任务，其中mkdir时ant的内部任务名，dir是此任务的属性，其值为${dist}。此任务就是创建一个目录。其中${dist}是获取dist属性的值（就是我们在第三行定义的）。如上就是一个基本的build.xml文件的写法。你可以在命令行上输入 ant -buildfile build.xml

看一下你的当前目录下是否多了一个dist目录。如果出错，则可能是你没有把ant配置好，参见前面讲的安装及配置，看一下哪儿出了错。

3：build.xml文件
build.xml文件如下，其中有的注释和无关的代码删掉了，且做了一下小小的改动
1：<?xml version="1.0"?>
2： <project default="app" basedir=".">
3：<!-- 加入 xmlc 任务-->
4：<taskdef name="xmlc"classname="org.apache.tools.ant.taskdefs.optional.enhydra.Xmlc"/>
5：<!-- =================================================================== -->
6：<!-- 设置编译的类路径 -->
7：<!-- =================================================================== -->
8：<path id="build.classpath">
9：<pathelement path="${build.classes}"/>
10：</path>

11：<!-- =================================================================== -->
12：<!-- 初始化基本属性 -->
13：<!-- =================================================================== -->
14：<target name="init">
15：<!-- Set up application info -->
16：<property name="app.Name" value="AntDemo"/>
17：<property name="app.name" value="antDemo"/>
18：<property name="app.version" value="0.0.1"/>
19：<property name="app.year" value="2000"/>

20：<!-- source code and document info -->
21：<property name="src.dir" value="."/>
22：<property name="doc.dir" value="./doc"/>
23：<property name="lib.dir" value="./lib"/>

24：<!-- package to be javadocs -->
25：<property name="packages" value="antDemo.*"/>

26：<!-- build info -->
27：<property name="build.dir" value="ant.build"/>
28：<property name="build.classes" value="${build.dir}/classes"/>
29：<property name="build.lib" value="${build.dir}/lib"/>
30：<property name="build.javadocs" value="${build.dir}/javadocs"/>
31：<property name="build.xmlc.dir" value="${build.dir}/xmlcout/"/>
32：<property name="build.debug" value="on"/>

33：<property name="dist.dir" value="./${app.name}-${app.version}"/>
34： </target>

35：<!-- =================================================================== -->
36：<!-- 创建要存放编译厚的文件的目录 -->
37：<!-- =================================================================== -->
38：<target name="prepare" depends="init">
39：<mkdir dir="${build.dir}"/>
40：</target>

41：<!-- =================================================================== -->
42：<!-- 用XMLC工具编译 html文件-->
43：<!-- =================================================================== -->
44：<target name="xmlc" depends="prepare">
45：<mkdir dir="${build.xmlc.dir}"/>
46：<xmlc srcdir="${src.dir}"
47：sourceout="${build.xmlc.dir}"
48：includes="**/*.html">
49：<!-- element name is same as command line parameter -->

50：<warnings param1="false"/>
51：<generate param1="both"/>
52：<html_encoding param1="gb2312"/>
53：<!-- the old arg element is still supported -->
54：<arg name="ssi"/>
55：<arg name="keep"/>
56：<!-- prefixmap do package name mapping -->
57：<prefixmap old="antDemo.presentation.html" new="antDemo.presentation"/>
58：</xmlc>
59：</target>

60：<!-- =================================================================== -->
61：<!-- 编译 -->
62：<!-- =================================================================== -->
63：<target name="compile" depends="xmlc,prepare">
64：<mkdir dir="${build.classes}"/>

65：<!-- compile XMLC generated java -->
66：<javac srcdir="${build.xmlc.dir}"
67：destdir="${build.classes}"
68：classpathref="build.classpath"
69：debug="${build.debug}"/>

70：<!-- compile java codes -->
71：<javac srcdir="${src.dir}"
72：destdir="${build.classes}"
73：classpathref="build.classpath"
74：debug="${build.debug}"
75：includes="${app.name}/**"
76：/>
77：</target>

78：<!-- =================================================================== -->
79：<!-- 复制 -->
80：<!-- =================================================================== -->
81：<target name="extra" depends="init">
82：<mkdir dir="${build.classes}/${app.name}/presentation"/>
83：<copy todir="${build.classes}/${app.name}/presentation">
84：<fileset dir="${src.dir}/${app.name}/presentation">
85：<include name="**/*.gif"/>
86：<include name="**/*.jpg"/>
87：<include name="**/*.js"/>
88:<include name="**/*.css"/>
89:</fileset>
90:</copy>
91:</target>

92:<!-- =================================================================== -->
93:<!-- 创建lib目录，class文件及其他文件打包 -->
94:<!-- =================================================================== -->
95:<target name="jar" depends="extra,compile">
96:<mkdir dir="${build.lib}"/>
97:<jar jarfile="${build.lib}/${app.name}.jar" basedir="${build.classes}" />
98:</target>

99:<!-- =================================================================== -->
100:<!-- 复制应用程序的配置文件 -->
101:<!-- =================================================================== -->
102:<target name="app" depends="jar,extra">
103:<!-- do the app.conf -->
104:<copy file="${src.dir}/${app.name}/${app.Name}.conf" todir="${build.dir}"/>

105:<!-- do the multiserver.conf -->
106:<filter token="OUTPUT" value="./" />
107:<copy file="${src.dir}/${app.name}/multiserver.conf.in"
108:tofile="${build.dir}/multiserver.conf"
109:filtering="on"/>

110:<!-- do the start script -->
111:<copy file="${src.dir}/${app.name}/start" todir="${build.dir}"/>
112:<chmod file="${build.dir}/start" perm="ugo+rx"/>
113:</target>

114:</project>

 

4：build.xml详细说明
下面我们将详细讲述这个文件，同样为了方便，我加了行号，当然一些基本的东西我就不再重复了。第四行taskdef任务(task)属于ant的内部任务，它的作用是定义一个任务，其基本属性有name,classname,在定义时这两个属性都必需有。第八行开始定义一个path，它有一个属性id，通过这个id的值我们可以在后面引用这个path，参见第68行。目标(target)init(从14行到34行)定义了一些基本属性(property),主要是为了后面的target使用。在第38行，你会看到depends="init"，depends是定义一个目标时的可选属性，它的意思是如果init目标没有执行(出错或其他原因),这个目标也不会被执行。

从第46行开始定义xmlc任务，到第58行结束，中间有很多参数嵌套在其中，srcdir指定源文件目录，sourceout指定输出目录，includes属性将源文件目录中的所有html文件包括进来。*为通配符。

<warnings param1="false"/>表示取消警告，<generate param1="both"/>表示同时产生接口和实现代码，例如：一个welcome.html,它会产生两个文件：WelcomeHTMLImpl.java，WelcomeHTML.java，WelcomeHTML.java中只定义了一个接口WelcomeHTML，真正的实现在WelcomeHTMLImpl.java中。<html_encoding param1="gb2312"/>表示设置编码，由于xmlc将html文件编译为java类，即使你在html文件中已经设置了编码，在java类中也不会有作用，必须在编译时设置编码。<arg name="ssi"/> <arg name="keep"/>这两句相当于在命令行上输入-ssi -keep.其中ssi参数是在编译html文件时将定义的ssi文件包括进来，见html目录下的welcome2.html源代码中有一行:<!--#include file="welcome.ssi"-->。keep参数会保留编译html文件后产生的java文件。第57行意思是将包更名，由于html文件在antDemo/presentation/html目录下,因此产生的java类属于antDemo.presentation.html包，我们通过new属性的值将属于此包的类改为属于新的包，使用xmlc时，一般以上几个参数就足够了，要想使用更多的参数，请参见xmlc task定义的源代码 。

从第63行到77行，目标(target)定义了编译时的细节，编译分为两部分，分别编译xmlc产生的java类和项目中的java类(表现层，商务层，数据层中的代码）。javac这个任务中，srcdir属性指定java文件存放位置，destdir属性指定编译后的class文件存放位置，classpathref属性指定classpath，debug属性设置关闭还是打开调试信息，includes属性起一个过滤作用，它指定编译那些文件，否则javac将会编译srcdir属性指定的目录下的所有java文件。

81行到91行开始将将程序中用到的其他文件也复制到目标目录，以便下一步打包。在copy任务中，todir属性指定目标目录，至于复制那些文件，则由嵌套在copy任务中的fileset任务来指定。在fileset中，dir指定基本目录，include和exclude属性用来过滤文件，符合条件的文件将会被复制到目标目录。

95行到98行开始将程序打包，jarfile属性指定打包后的文件名，basedir指定基本目录，基本目录下的文件及子目录都会按照其本来的组织结构放到jar文件中。

102行到113行，开始复制配置文件，配置文件包括AntDemo.conf,multiserver.conf,start.其中第112行，chmod任务将start文件的属性改为对任何人可执行和可读。

通过上面的讲解，你可能看出使用ant的优越性，ant可以方便的管理一个大型的项目，当然其他的项目也可以，重要的是，你可以很容易的对它的task进行扩充。相信越来越多的人会使用ant来进行项目的管理。

四：小技巧：
由于使用ant时可能出错，而屏幕不够大的话，可能看不清，最好将编译出错信息放入一个文件中，如下这样使用ant：
ant -buildfile build.xml -logfile error.log

就会将出错信息放入error.log中，由于使用buildfile参数，因此xml文件名不一定时build.xml,可以为任意xml 文件，如project.xml

 

another one

1.Ant是什么

Apache Ant 是一个基于java的build工具，在理论上，它有点像make，但是没有make的缺陷。

为什么已经有了make，gnumake，make，jam等build工具，还要一种新的build工具呢？因为Ant的原作者无法忍受这些工具在跨平台开发时所带来的限制和不便。类似make的工具本质上都是基于shell的：它们计算依赖关系，然后执行命令。这些命令和你在命令行下执行的命令没有太大的区别。这意味着你能很容易的使用你的操作系统编写程序来扩展该工具；这也意味着你将自己限制在特定的操作系统上，至少是操作系统的类型上，例如Unix。

Makefiles也是很可恶的。任何使用过他们的人都碰到过可恶的tab问题。“我的命令不能执行是否只是因为我的tab前面有一个空格？”Ant的作者说过这句话很多次了。有的工具比如Jam能很好的处理这类问题，但是用户必须使用和记住另外一种新的格式。

Ant就不同了。与基于shell命令的扩展模式不同，Ant用Java的类来扩展。（用户）不必编写shell命令，配置文件是基于XML的，通过调用target树，可以执行各种task。每个task由一个实现特定task interface（接口）的object（对象）来运行。（如果你对Ant一点概念都没有的话，可能看不懂这一节，没有关系，后面会对target,task做详细的介绍。你如果没有太多的时间甚至可以略过这一节，然后再回来浏览一下这里的介绍，那时你就会看懂了。同样，如果你对make之类的工具不熟悉也没关系，下面的介绍根本不会用到make中的概念。）

必须承认，这样做，在构造shell命令时会失去一些特有的表达能力。如`find . -name foo -exec rm {}`，但却给了你跨平台的能力－你可以在任何地方工作。如果你真的需要执行一些shell命令，Ant有一个<exec> task，这个task允许执行特定OS上的命令。

2.安装Ant

2.1获得Ant

二进制版本（Binary Edition）

在Ant的web网页http://ant.apache.org/可以得到Ant最新的稳定的版本的信息。如果你疯狂的技术追求者（living on the edge？），你可以从http://cvs.apache.org/builds/ant/nightly/处下载到最新的版本

源码版本（Source Edition）

如果你更喜欢源码版本，你可以从 http://ant.apache.org/srcdownload.cgi处下载到最新版本的源码。同样的如果你疯狂的技术追求者，你可以通过CVS获得这些正在开发中的代码。在Jakarta网站上有有关访问CVS的详细资料。请checkout（检验）ant模块。阅读Build Ant部分关于如何使用源码构建ant，你也可以在线访问Ant CVS repository。

2.2系统需求

Ant可以使用在多种平台上,包括Linux, 商业Unix（如Solaris和HP-UX），Windows 9X 和 NT, OS/2 Warp, Novell Netware 6 以及 MacOS X。

为了构建和使用Ant，你必须有一个JAXP兼容的XML解析器在你的classpath路径中。

binary 形式的Ant包括最新版的Apache Xerces2 XML解析器。请查阅http://java.sun.com/xml/获得关于JAXP的更加详细的信息。如果你希望使用一个不同的JAXP兼容的XML解析器，你需要把xercesImpl.jar和xml-apis.jar从Ant的lib目录中删除。然后你即可以把你想要用的JAXP兼容的XML解析器放到Ant的lib目录中，也可以把jar路径加入系统的classpath变量中。

对于当前版本的Ant，你需要安装1.2或者更高版本的JDK。

注意：Microsoft(微软) JVM/JDK是不支持的。

注意2：如果只有JRE运行环境而没有JDK，会导致许多task不能执行。

2.3安装Ant

binary 形式的Ant的目录结构组成如下：
  ant
   +--- bin  // 包含了运行脚本
   |
   +--- lib  // 包含了Ant必需的jar文件
   |
   +--- docs // 包含了文档
   |      +--- ant2    // ant2需求的简述
   |      |
   |      +--- images  // html文档用到的logos
   |      |
   |      +--- manual  // Ant文档
   |
   +--- etc // 包含了xsl文件:

只有bin目录和lib目录是运行ant所必需的。选择一个目录然后把ant复制到该目录下，即可完成ant的安装，这个目录将由ANT_HOME识别。

Windows 95, Windows 98 & Windows ME 注意:
    在这些系统下，如果ANT_HOME有一个很长的文件名（比如 文件名不是被识别的格式"8.3"？？），运行ant的脚本可能回产生问题。这是由该操作系统处理“for”批处理文件命令的限制造成的。推荐使用短的文件名，比如c:Ant。
    在这些系统下，你也需要配置更多的环境空间来迎合ant运行脚本的环境变量的使用。为了达到这个目的，你必须在config.sys中增加或修正下面这行：
shell=c:command.com c: /p /e:32768

设置

在你能运行ant之前，还有一些额外的必需的设置

·在path变量中增加bin目录的路径。
·设置ANT_HOME环境变量，值为ant的安装路径。在一些操作系统上，ant封装脚本能推测ANT_HOME(Unix   dialects and Windows NT/2000)。但是最好不要依赖这些特性。
·可选择的，设置JAVA_HOME环境变量（查看后面的Advanced部分）。这必须指向JDK的安装目录。

注意：不要把Ant的ant.jar文件放到JDK/JRE的lib/ext目录下。Ant是一个应用程序，而lib/ext目录是为JDK扩展使用的（如JCE，JSSE扩展）。而且通过扩展装入的类会有安全方面的限制。

可选TASK

Ant支持一些可选task，一个可选的task一般需要一个额外的库才能工作。这些可选的task和core Ant tasks打包在一起。

每个可选task所需的外部库可参看依赖库（Library Dependencies）部分。这些外部库可以放到Ant的lib目录下，这样Ant就能自动装入，或者将其放入环境变量中。

Windows and OS/2

假设ant安装在c:ant。使用下面的命令设置环境变量。

set ANT_HOME=c:ant
set JAVA_HOME=c:jdk1.2.2
set PATH=%PATH%;%ANT_HOME%bin

Unix (bash)

假设ant安装在/usr/local/ant。使用下面的命令设置环境变量。

export ANT_HOME=/usr/local/ant
export JAVA_HOME=/usr/local/jdk-1.2.2
export PATH=${PATH}:${ANT_HOME}/bin

Unix (csh)

假设ant安装在/usr/local/ant。使用下面的命令设置环境变量。

setenv ANT_HOME /usr/local/ant
setenv JAVA_HOME /usr/local/jdk-1.2.2
set path=( $path $ANT_HOME/bin )

高级

运行ant需要用到许多变量，你至少需要下面这些：

·ant的classpath必须包含ant.jar文件和你所选择的JAXP兼容XML解析器的jar/classes文件。
·当你需要JDK的功能时（例如javac task或rmic task），对JDK1.1，JDK的classes.zip文件必须加入classpath中，对于JDK1.2或JDK1.3，tools.jar是必须的。Ant支持脚本，在bin目录中，如果设置了ANT_HOME环境变量，JDK的类会自动加载。
·当你执行特定平台的程序，例如exex task或cvs task，ant.home的属性必须指向Ant的安装目录，同样，Ant所带的脚本利用ANT_HOME环境变量自动设置该属性。

提供的ant shell脚本都支持ANT_OPTS环境变量，这个变量用于提供额外的可供选择的选项。存贮在users home 目录（能用于设置这样的选项）下的一些脚本也被读入。

构建Ant （Building Ant）

你即可以安装source形式的Ant，也可以从CVS上checkout Ant 模块来Building Ant。

安装完源码后，进入安装目录。

设定JAVA_HOME环境变量指向JDK的安装目录。要想知道怎么做请参看安装Ant部分。

确保你已下载了任何辅助jar文件，以便build你所感兴趣的task。这些jar文件可以放在CLASSPATH中，也可以放在lib目录下。参看依赖库部分可知不同的task需要那些jar文件。注意这些jar文件只是用作build Ant之用。要想运行Ant，你还要像安装Ant部分中所做的那样设定这些jar文件。

 

评论

1 楼 byebyebye3210 2008-10-24  

感谢搂主分享。。。。万分感谢！