安装
JDK 要求 1.4 及以上版本,推荐 1.7 及以上版本
确保 JAVA_HOME 已配置
- 下载二进制版压缩包、解压
- 配置
ANT_HOME
为 Ant 主目录;同时将bin
目录添加到PATH
中 - 检查安装,命令行输入
ant
,输出如下:
Buildfile: build.xml does not exist!
Build failed
使用
语法
Ant 的构建文件以 XML 文件编写。构建文件包含包含一个
project
和至少一个(默认的)target
。targets 包含 task 元素,每个 task 元素包含 id 属性以便后续使用。task 元素即是一些执行动作,整个构建则由一系列的执行动作以及必要的属性配置构成。全局属性通过property
元素配置。
- property 也是一个 task,用来设置 键值对 形式的数据,便于重用设置
- 系统属性
- Ant 内置属性
- 基本语法
1.6 之后所有 task 都可放到任何 target 外部声明;
当 task 处于 target 外部时,会在任何 target 执行之前计算
- target 基本语法
执行顺序 A -> B -> C ->D
- task 基本语法:
Ant 内置了很多常用的 task
当然用户也可以编写自己的 task
示例文件
simple example build file
以上示例包含几个 target 任务,默认任务为 dist
- init 初始化动作,创建了一个 build 目录用于编译
- compile 编译动作,将 src 目录的源码编译到 build 目录中,依赖于 init 任务
- dist 打包发布,创建 dist/lib 目录,生成 jar 包,依赖于 compile 任务
- clean 清理使用的目录
路径处理/ Path
编译 Java 代码时,通常会指定依赖的 jar 包,ANT 中主要有两种方式配置
- 通过全局设置
指定路径,然后在
任务中引用该配置,可在多个任务中共享
- 直接在
任务中指定路径
只在 javac 等其他任务中作为参数,并不是一个 task
资源 Resource
在 Ant 中,文件/文件夹被抽象为 [资源](http://ant.apache.org/manual/Types/
resources.html),便于文件访问。
内置的资源类型:
- resource 基础资源类型,其他资源类型都基于此类型
- file 代表可通过本地文件系统访问的文件
- javaresource 可通过 Java 类加载器加载的资源
- javaconstant 获取 Java 常量值,该常量签名必须为
public static
- zipentry 代表 ZIP 压缩文件中的某个文件
- tarentry 代表 TAR 压缩文件中的某个文件
- gzipresource 非标准资源,为其他资源提供即时压缩的一层封装
- bzip2resource 非标准资源,为其他资源提供即时压缩的封一层封装
- url 代表 URL
- string 代表 Java 字符串
- propertyresource 代表 Ant 属性
资源集合 Resource Collections
包含资源的资源组
分类:
- fileset, dirset, multirootfileset, filelist, 和 path (以及衍生的类型) 代表 file 资源
- tarfileset,代表 file 或 tarentry
- zipfileset,代表 file 或 zipentry
- propertyset,代表 property 资源
内置的资源集合
有点类似 SQL 查询操作
- resources 普通资源集合
- files 与 fileset 类似的文件集合
- restrict 根据指定条件限制包含的资源
- sort 根据自然排序或指定排序器,将资源排序
- first 获取第一个资源,可与 sort 结合使用,排序查找资源
- last 获取最后一个资源
- allbutfirst 除第一个以外的所有资源
- allbutlast 出最后一个以外的所有资源
- tokens 包含从资源中的 string 标记,可用来实现 Unix 函数(如 sort, grep 等)
- 设置 Set operations
- union 取指定资源集合的并集
- intersect 取指定资源集合的交集
- difference 取指定资源集合的差集
- mappedresources 封装另一个资源集合并使用 mapper 映射内部资源
- archives 接受任意数量的资源并假定它们是 ZIP 或 TAR 压缩文件。返回资源的内容
- resourcelist 接受任意数量的资源,读取这些资源并返回一个行读取的资源
文件过滤
通过对资源、资源集合的操作,对构建的文件过滤、筛选;
以 fileset 、dirset 为例
项目实例
- 背景
Java Web 项目,通过 Jenkins 配置自动构建,同时调用 ant 脚本进行项目构建打包 - 目的
- 设置依赖库
- 创建构建目录
- 拷贝静态文件(页面、图片等不需编译文件,包括依赖库)到构建目录
- 替换自定义配置的 jdbc 文件
- 编译源代码
- 生成 war 包
simple example build file
运行
Ant 提供两种方式运行:
- 命令行
ant [options] [target [target2 [target3] ...]]
详细参数可使用 ant -h
查看
示例:
- ant
默认当前文件包含 build.xml
,运行默认任务
- ant -buildfile anotherName.xml
,指定配置文件,运行默认任务
- ant -buildfile anotherName.xml dist
,指定配置文件,运行指定任务
- Java 调用
// 传统调用入口
java -Dant.home=c:\ant org.apache.tools.ant.Main [options] [target]
// 1.6 后引入
java -Dant.home=c:\ant org.apache.tools.ant.launch.Launcher [options] [target]
Ant 也可以通过
命令启动
```
```
对比两种方式,命令行更加方便,且可与其他工具配合使用。