Ant简介

从命令行运行 Ant





是从命令行执行的 Ant 生成任务的一些典型输出： Buildfile: build.xml init: [mkdir] Created dir: E:\tutorials\ant\example\build [mkdir] Created dir: E:\tutorials\ant\example\dist compile: [javac] Compiling 8 source files to E:\tutorials\ant\example\build dist: [jar] Building jar: E:\tutorials\ant\example\dist\example.jar BUILD SUCCESSFUL Total time: 2 seconds
Ant简介
Ant一个优秀的构建工具 Ant意思是Another Neat Tool
陈炎 itmarksman@ 南京大学软件学院 2007.4.1
Ant的基本概念——Java 的makefile

基于Java的开放源码构建工具 通过配置一个XML文件快速开发创建和部署过程 使用buildfile（如build.xml）来完成一系列操作 一个流程脚本引擎，用于自动化调用程序完成项 目的下列任务：
Ant中的属性
Ant 中的属性类似编程语言中的变量，它们都具 有名称和值。然而与通常的变量不同，一经设 置，Ant 中的属性就不可更改；它们是不可变的， 就像 Java 语言中的 String 对象。 例：<property name="metal" value="beryllium"/> 生成文件的其他部分引用属性语法：${metal} 例如：<property name="metal-database" value="${metal}.db"/>
创建 JAR 文件

在编译 Java 源文件后，使用<jar>被打包. manifest 属性允许指定一个用作该 JAR 文件 的清单的文件.
<jar destfile="package.jar" basedir="classes"> <manifest> <attribute name=―Built-By‖ value=―${}‖/> <attribute name=―Main-class‖ value="package.Main"/> </manifest> </jar>
编译源码——javac任务(1)

Javac任务
<target name=―compile‖ description="compile source"> <mkdir dir=―${dir.build}‖/> <javac srcdir=―${dir.src}‖ destdir=―${dir.build}‖> <include name=―**/*.java"/> </javac> </target> 其它有用属性：
创建和解压缩 zip 及 tar 文件



zip 文件的 Ant 任务： <zip destfile="output.zip" basedir="output"/> 创建 tar 文件： <gzip src="output.tar" zipfile="output.tar.gz"/> 解压缩和提取文件： <unzip src="output.tar.gz" dest="extractDir"/>

Ant中的DataType
DataType可以很自然的处理构建过程中的文 件和路径问题 常见的DataType: Environment环境 Fileset文件集 Patternset模式集 Filterset过录集 Path路径

定义依赖关系
生成一个项目一般需要许多步骤 —— 例如首先要编 译源代码，然后将它打包为 Java 归档文件（Java Archive File，JAR）。 每个目标的定义依据的是在它在能够执行之前必须完 成的其他所有目标。 使用 target 元素的 depends 属性来实现的。例如： <target name=―compile" depends="init"/> <target name=―package‖ depends=―compile"/> <target name=―clean" depends=―init"/>
单元测试集成到Ant中

执行test.util.ServeTest
<target name="unittest" description="run test" depends="compile"> <java fork="yes" classname="junit.textui.TestRunner" taskname="junit" failonerror="true"> <arg value="test.util.ServeTest"/> <classpath> <pathelement location="${dir.build}"/> <pathelement location="lib/myObj.jar"/> <pathelement location="lib/junit-4.0.jar"/> </classpath> </java> </target>
简单的buildfile
<?xml version="1.0"?> <project name=―myproject" default=―test" basedir="." > <target name=―test" description=― test ant."> <javac srcdir=―.‖/> <echo message=―Ant is working properly‖/> </target> </project> JAVAC：用于编译JAVA源码 ECHO: 当构建抵达这里时，它将显示该文本内容

定义依赖关系
在上面的例子中，如果让 Ant 完成 package 步骤，则依赖图如下：
init clean
compile
package
注意目标出现在生成文件中的顺序并不重要： 执行顺序是由depends 属性唯一确定的。
定义依赖关系


实际执行系列是: init ,compile,init,compile,package 错误想法是：init,compile,package
Buildfile文件

以XML文件来描述的 陈述式语法。 每个构建文件包含一个工程(project)。 每个工程包含若干个目标(target)。 目标可以依赖于其他的目标(depends)。 目标包含任务(task)。
简单的buildfile
<?xml version="1.0"?>

编译、打包、测试、调用系统命令(exec)……

优点


平台无关的 基于XML，比make脚本好维护
Ant的安装



下载Ant包并解压 将解压后bin目录加入PATH中（如F:\ant\bin） 设置 ANT_HOME 环境变量

ANT_HOME=解压目录（如F:\ant)

通过运行：ant -version确认安装是否成功。


classpath：等价于 javac 的 –classpath 选项。 debug=―true‖：指示编译器应该带调试信息编译源 文件。
编译源码——javac任务(2)

引入jar包——添加到classpath中
<target name="compile‖ description="compile source"> <mkdir dir="${dir.build}"/> <javac srcdir="${dir.src}" destdir="${dir.build}" > <include name="**/*.java"/> <classpath> <pathelement location="lib/myObj.jar"/> <pathelement location="lib/junit-4.0.jar"/> </classpath> </javac> </target>
<project name=―myproject" default=―test― basedir="." > <target name=―test" description=― test ant."> <javac srcdir=―.‖/> <echo message=―Ant is working properly‖/> </target> </project> project: 每个构建文件以project为根节点。 Name=―myproject‖ 为工程命名。 default=―ant‖ :默认执行test.ant目标