Ant在自动构建和部署Java程序方面方便易用,而且非常灵活,通过Ant可以实现编译、运行java程序,以及打jar包、war包等功能。
一、Ant安装配置
1.下载安装
下载http://www.apache.org/dist/ant/binaries下的apache-ant-1.7.1-bin.zip
解压即可。
2.ant的配置
1) 在环境变量中设置ANT_HOME,值为你的安装目录ANT安装目录
2) 在环境变量中设置JAVA_HOME,值为你的jdk安装目录
3) 把ANT_HOME/bin,JAVA_HOME/bin加到你系统的path目录中去。
3.测试是否成功
DOS输入
ant -version回车,看到输出说明配置成功。
javac 和 java 回车,有帮助信息则说明JDK配置成功。
二、Ant关键元素
Ant 的关键元素 project 、 target 、 property 和 task 。
1. project 元素
project 元素是 Ant 构件文件的根元素, Ant 构件文件至少应该包含一个 project 元素,否则会发生错误。在每个 project 元素下,可包含多个 target 元素。接下来向读者展示一下 project 元素的各属性。
1 ) name 属性
用于指定 project 元素的名称。
2 ) default 属性
用于指定 project 默认执行时所执行的 target 的名称。
3 ) basedir 属性
用于指定基路径的位置。该属性没有指定时,使用 Ant 的构件文件的附目录作为基准目录。
2. target 元素
它为 Ant 的基本执行单元,它可以包含一个或多个具体的任务。多个 target 可以存在相互依赖关系。它有如下属性:
1 ) name 属性
指定 target 元素的名称,这个属性在一个 project 元素中是唯一的。我们可以通过指定 target 元素的名称来指定某个 target 。
2 ) depends 属性
用于描述 target 之间的依赖关系,若与多个 target 存在依赖关系时,需要以“ , ”间隔。 Ant 会依照 depends 属性中 target 出现的顺序依次执行每个 target 。被依赖的 target 会先执行。
3 ) if 属性
用于验证指定的属性是否存在,若不存在,所在 target 将不会被执行。
4 ) unless 属性
该属性的功能与 if 属性的功能正好相反,它也用于验证指定的属性是否存在,若不存在,所在 target 将会被执行。
5 ) description 属性
该属性是关于 target 功能的简短描述和说明。
3. property 元素
该元素可看作参量或者参数的定义, project 的属性可以通过 property 元素来设定,也可在 Ant 之外设定。若要在外部引入某文件,例如 build.properties 文件,可以通过如下内容将其引入: <property file=” build.properties”/>
property 元素可用作 task 的属性值。在 task 中是通过将属性名放在“ ${ ”和“ } ”之间,并放在 task 属性值的位置来实现的。
Ant 提供了一些内置的属性,它能得到的系统属性的列表与 Java 文档中 System.getPropertis() 方法得到的属性一致,这些系统属性可参考 sun 网站的说明。
同时, Ant 还提供了一些它自己的内置属性,如下:
basedir : project 基目录的绝对路径,该属性在讲解 project 元素时有详细说明,不再赘述;
ant.file : buildfile 的绝对路径,如上面的各例子中, ant.file 的值为 E:"build.xml ;
ant.version : Ant 的版本,在本文中,值为 1.7.0 ;
ant.project.name :当前指定的 project 的名字,即前文说到的 project 的 name 属性的值;
ant.java.version : Ant 检测到的 JDK 的版本,在上例运行结果中可看到为 1.5 。
三、Ant常用任务
在 Ant 工具中每一个任务封装了具体要执行的功能,是 Ant 工具的基本执行单位。在本小节中,主要引导读者来看下 Ant 的常用任务及其使用举例。
1. copy 任务
该任务主要用来对文件和目录的复制功能。举例如下:
Eg1. 复制单个文件: <copy file="file.txt" tofile="copy.txt"/>
Eg2. 对文件目录进行复制:
<copy todir="../newdir/dest_dir">
<fileset dir="src_dir"/>
</copy>
Eg3. 将文件复制到另外的目录:
<copy file="file.txt" todir="../other/dir"/>
2. delete 任务
对文件或目录进行删除,举例如下:
Eg1. 删除某个文件: <delete file="photo/amigo.jpg"/>
Eg2. 删除某个目录: <delete dir="photo"/>
Eg3. 删除所有的备份目录或空目录:
<delete includeEmptyDirs="true">
<fileset dir="." includes="**/*.bak"/>
</delete>
3. mkdir 任务
创建目录。 eg : <mkdir dir="build"/>
4. move 任务
移动文件或目录,举例如下:
Eg1. 移动单个文件: <move file="fromfile" tofile=”tofile”/>
Eg2. 移动单个文件到另一个目录: <move file="fromfile" todir=”movedir”/>
Eg3. 移动某个目录到另一个目录:
<move todir="newdir">
<fileset dir="olddir"/>
</move>
5. echo 任务
该任务的作用是根据日志或监控器的级别输出信息。它包括 message 、 file 、 append 和 level 四个属性,举例如下:
<echo message="Hello,Amigo" file="logs/system.log" append="true">
四、ant执行命令的详细参数
-buildfile<file>,-file<file>,-f<file> :要指定执行构件的的位置和名称。
-find<file>,-s<file>: 查找构件文件,并执行找到的构件文件。
-help,-p:显示ant的命令帮助信息。在命令行中显示ant的命令选项及简短的介绍,-h是简写。
-version:显示ant 的版本信息。
-diagnostics:显示ant项目的运行环境、依赖库等信息,为错误诊断和报告提供一些有用的帮助信息。
-quiet,-q: 隐藏ant执行的提示输出信息。命令行将不会输出具体的target的执行信息。
-verbose,-v: 显示ant执行的详细信息,包括操作系统和Java环境等信息。
-debug,-d:显示ant执行调试的信息、详细的log信息。
-lib<path>:指定一个类库所在的位置(jar文件位置),让ant工具可以使用这些类文件。path类型指定类库文件。
-logfile<file>,-l<file>:指定ant执行时日志输出文件,让日志输出到指定文件而不在命令行输出。
例如:执行 ant -f test.xml -l c:\testAntLog.log 将会百日志信息输出到c:\testAntLog.log去。
-D<property>=<value>:用于设定一些变量,这些变量可以在target中直接引用,或覆盖已设定的属性值。
例如:ant -f test.xml -D src=hello
五、Ant系统属性 (用${}来获取属性值 例如:${os.name})
os.name: 操作系统的名称。
basedir: 项目引用的根路径。
ant.home: Ant工具的根目录位置。
ant.file: 构件文件的绝对路径。
ant.version: ant的版本信息。
ant.java.version: ant检测到的JVM版本。
ant.project.name: 当前执行的项目名称及信息。
java.version: Java的版本信息。
java.home: Java的根目录位置。
java.class.path: Java类库的文件的位置。
line.separator: 换行符.
user.home: 用户的home目录,在Linux和UNIX中经常甬道。
附件包括2个ant配置实例:
build.xml 默认Ant配置文件(Application)
build.properties 默认Ant配置所引用的属性文件(Application)
svn.properties Ant和svn整合的属性文件(Application)
antBuild.xml 利用Ant部署Web应用(Web)
antBuild.properties利用Ant部署Web应用的属性文件(Web)