Apache Ant的安装

news2025/6/23 20:21:06

介绍

Apache Ant是一个Java库和一个命令行工具，可以用来构建Java应用。Ant提供了许多内置的任务（tasks），可以编译、组装、测试、运行Java应用。Ant也可以构建非Java应用，例如C、C++应用。
Ant非常灵活，没有强制Java项目必须满足什么编码规范、或者必须有什么样的目录布局。

Apache Ant官网

https://ant.apache.org/
在这里插入图片描述

Ant对Java版本的要求

当前， Ant维护了两条开发主线，一条是 1.9.x系列版本，运行时需要Java5及以后版本；另外一条是1.10.x系列版本，运行时需要Java8及以后版本。
当前1.9.x正是修改问题，1.10.x会新增特性，推荐采用1.10.x版本。
如果只有JRE，而不是一个完整的JDK，那么Ant的许多任务不能执行。

https://ant.apache.org/faq.html
在这里插入图片描述

Ant版本下载

如果是下载二进制发布包，打开页面：https://ant.apache.org/bindownload.cgi
例如，下载1.10.14版本的zip包，下载下来是apache-ant-1.10.14-bin.zip：
在这里插入图片描述

目录结构

将下载下来的压缩包解压到某个目录下，例如D盘，解压后的目录结构如下：
在这里插入图片描述
运行Ant，只有bin和lib子目录是必须的。

bin子目录下是启动脚本：
在这里插入图片描述

etc子目录包含xsl文件：
在这里插入图片描述

lib子目录下是Ant JAR文件和必须的依赖：
在这里插入图片描述

manual子目录下存放了手册，双击该目录下的index.html，显示文档内容：
在这里插入图片描述

设置环境变量

设置JAVA_HOME环境变量

设置JAVA_HOME环境变量指向JDK的安装路径，例如：
在这里插入图片描述

设置ANT_HOME环境变量

设置ANT_HOME环境变量指向Ant的安装路径，例如：
在这里插入图片描述

将bin子目录的路径增加到Path环境变量中

将${ANT_HOME}/bin (Unix) 或者 %ANT_HOME%\bin (Windows)增加到Path环境变量中，例如：
在这里插入图片描述

（可选）在Ant安装目录下运行命令ant -f fetch.xml -Ddest=system下载依赖库到本地

在ANT_HOME目录（就是Ant的安装目录）下面运行命令：
ant -f fetch.xml -Ddest=system
这个命令可以下载Ant可选任务需要的几乎所有依赖库到ANT_HOME/lib目录下面。如果不运行这个命令，许多的Ant依赖任务无法正确执行。

其中-Ddest后面各种取值的含义如下：

  -Ddest=user     user lib dir  ${user.home}/.ant/lib （下载的jar包放到用户的home目录下面）
  -Ddest=system   ant lib dir   ${ant.home}/lib   （下载的jar包放到Ant的lib目录下面。推荐用这个选项）
  -Ddest=optional optional dir  $${basedir}/lib/optional  (for Ant developers)  （下载的jar包放到源代码的lib/optional目录下面，在构建Ant源代码的时候使用这种方式）

https://ant.apache.org/manual/index.html
在这里插入图片描述

fetch.xml文件在Ant安装目录下：
在这里插入图片描述

看看在执行这个命令前，lib目录下的文件数量：
在这里插入图片描述

执行命令ant -f fetch.xml -Ddest=system：
在这里插入图片描述
省略了中间很多的输出。。。
最后输出：

看看在执行这个命令后，lib目录下的文件数量，可以发现，增加了很多文件：
在这里插入图片描述

可选任务

Ant提供了很多可选任务。一个可选任务通常需要外部的库才能运行。可选任务和核心任务打包在一起。
每个可选任务需要的外部依赖库参见https://ant.apache.org/manual/index.html
在这里插入图片描述

这些依赖的外部库必须增加到 Ant’s classpath中，可以用下面的一种方式：

放在ANT_HOME/lib目录下面，这种方式增加的jar文件对Ant的所有用户和builds可见。
放在${user.home}/.ant/lib (从Ant 1.6支持)，这种方式允许不同的用户增加新的库到Ant中。增加到该目录下的jar文件在命令行模式下的Ant可用。
在命令行下使用-lib参数。这种方式可以case-by-case增加jar文件。
在CLASSPATH 环境变量下。应该尽量避免这种方式。因为这种方式增加的jar文件对所有Java应用可见。
在被任务本身可接受的路径下面。