Apache Ant学习总结(一):Ant自动化脚本入门以及一些常用命令介绍
一 Ant简介
Apache Ant是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,大多用于Java环境中的自动化构建。它是Apache软件基金会JAKARTA目录中的一个子项目,它有以下的优点:
-
跨平台性。Ant是纯Java语言编写的,所以具有很好的跨平台性
-
操作简单。Ant是由一个内置任务和可选任务组成的。Ant运行时需要一个XML文件(构建文件)。 Ant通过调用target树,就可以执行各种任务。由于Ant构建文件 是XML格式的文件,所以很容易维护和书写,而且结构清晰。可以很方便的集成到各种开发环境中去
(注:以上简介参考至百度百科)
二 Ant环境搭建及入门实例
-
要想使用ant,首先需要去官网下载ant的安装包,地址:http://ant.apache.org/bindownload.cgi
-
ant的环境变量配置。配置过程跟Java的环境变量配置有点类似,也就是在系统的“环境变量”的“系统变量”——Path 添加上ant的bin路径即可,示例图如下:
当上面的环境变量配置好了之后就可以在cmd中进行测试了,如果出现下面的提示则说明已经配置成功了
写一个入门实例,输出“Hello World”。在一个目录新建一个名“build_test1.xml”的文件,内容如下:
1
2
3
4
5
6
|
<? xml version = "1.0" ?>
< project name = "helloWorld" >
< target name = "sayHello" >
< echo message = "Hello,Ant!" />
</ target >
</ project >
|
然后将cmd的工作目录切换到上面那个文件的目录,执行以下命令:ant -buildfile build_test1.xml sayHello ,输出如下:
上面的代码很简单,就是简单输出一个“Hello,Ant!”。关于上面的代码中的每个标签是什么含义,我将在下面进行简单解释
三 Ant的一些常用标签以及示例
(1)<project>标签:
<project>标签是构建文件的根标签,每个构建文件对应一个项目,它的几个常用属性如下:
-
name:表示project项目名
-
default:表示该Ant项目启动时默认执行的任务名,如果没有该参数,则需要在项目运行时手动指定执行的任务
-
basedir:表示项目执行的默认目录
示例代码如下:
1
2
3
4
5
6
|
<? xml version = "1.0" ?>
< project name = "hello" default = "sayBaseDir" basedir = "C:\\Users\\Administrator\\Desktop" >
< target name = "sayBaseDir" >
< echo message = "The base dir is: ${basedir}" />
</ target >
</ project >
|
在控制台中执行以下命令:
1
|
ant -buildfile build_test2.xml |
输出如下:
1
2
3
4
5
6
7
|
Buildfile: C:\Users\Administrator\Desktop\ant\build_test2.xml sayBaseDir: [echo] The base dir is: C:\Users\Administrator\Desktop
BUILD SUCCESSFUL Total time: 0 seconds |
(2)<target>标签:
target表示是一个个的待执行的任务,在一个project标签下可以有多个target标签。同时,可以指定一个target依赖于另一个target,这样在执行时会先执行依赖的那个任务,然后才执行目标任务。这个属性是非常有用的,比如要编译执行一个Java文件,那么我们的执行顺序就应该是先编译然后再执行,这时我们就可以让执行class文件的那个任务依赖于编译Java文件的那个任务。target标签的几个常用属性如下:
-
name:表示任务名
-
depends:表示该任务依赖的任务名
-
if:表示仅当属性存在时才执行这个任务
-
unless:跟if的含义相反,表示当属性没被设置时才执行这个任务
示例代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
|
<? xml version = "1.0" ?>
< project name = "targetStudy" default = "targetB" >
< property name = "zifangsky" value = "www.zifangsky.cn" />
< target name = "targetA" if = "zifangsky" >
< echo message = "Java Version: ${ant.java.version}" />
</ target >
< target name = "targetB" depends = "targetA" unless = "xxx" >
< echo message = "The base dir is: ${basedir}" />
</ target >
</ project >
|
输出:
1
2
3
4
5
6
7
8
9
10
|
Buildfile: C:\Users\Administrator\Desktop\ant\build_test3.xml targetA: [echo] Java Version: 1.8
targetB: [echo] The base dir is: C:\Users\Administrator\Desktop\ant
BUILD SUCCESSFUL Total time: 0 seconds |
(3)<mkdir>标签:
顾名思义,可以创建一个文件夹
示例代码如下:
1
|
< mkdir dir = "build/classes" />
|
(4)<delete>标签:
可以对文件或者文件夹进行删除,常用属性如下:
-
file:表示要删除的文件
-
dir:表示要删除的目录
-
includeEmptyDirs:表示是否删除指定目录中的空目录,如:includeEmptyDirs=”true”
-
failonerror:表示在碰到错误时是否停止,默认是自动停止
示例代码如下:
1
|
< delete dir = "build/classes" />
|
(5)<copy>标签:
用于复制文件或者目录,常用属性如下:
-
file:表示源文件
-
tofile:表示目标文件
-
todir:表示目标目录
-
overwrite:表示是否覆盖目标文件,默认是不覆盖
复制单个文件:
1
|
< copy file = "old.txt" tofile = "new.txt" />
|
复制一个文件到另一个目录:
1
|
< copy file = "old.txt" todir = "test1/addtest" overwrite = "true" />
|
对目录进行复制:
1
2
3
|
< copy todir = "test1/addtest" >
< fileset dir = "addtest" />
</ copy >
|
(6)<move>标签:
用于移动文件或者目录,常用属性跟<copy>标签差不多
示例代码如下:
1
2
3
4
5
6
7
|
< move file = "sourcefile" tofile = "destfile" />
< move file = "sourcefile" todir = "destdir" />
< move todir = "newdir" >
< fileset dir = "olddir" />
</ move >
|
(7)<filelist>标签:
表示一个文件列表,常用属性如下:
-
dir:表示文件目录
-
files:用逗号分隔的一个文件列表
-
refid :表示对某处定义的一个<filelist>的引用
示例代码如下:
1
2
3
4
5
6
7
8
|
< filelist id = "resourceFiles" dir = "${res.src}" files = "web.xml,application.xml" />
< filelist refid = "resourceFiles" />
< filelist id = "resourceFiles" dir = "${res.src}" >
< file name = "web.xml" />
< file name = "application.xml" />
</ filelist >
|
(8)<fileset>标签:
表示一种类型的文件列表,常用几个属性如下:
-
include:表示文件模式列表
-
exclude:表示不包含这些模式的文件列表
示例代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
< copy todir = "${buildwar.dest}/WEB-INF/classes" overwrite = "true" >
< fileset dir = "${build.bin}" >
< include name = "**/*.class" />
</ fileset >
</ copy >
< copy todir = "${buildwar.dest}" overwrite = "true" >
< fileset dir = "${webapp.dir}" >
< exclude name = "/WEB-INF/classes/**" />
</ fileset >
</ copy >
< path id = "buildpath" >
< fileset refid = "lib.runtime" />
< fileset refid = "lib.lib" />
</ path >
|
(9)<property>标签:
用于定义一个参数
示例代码如下:
1
|
< property name = "zifangsky" value = "www.zifangsky.cn" />
|
(10)<path>标签:
用于定义一个路径
示例代码如下:
1
2
3
4
5
6
7
8
|
< path id = "classpath" >
< fileset dir = "${lib.dir}" >
< include name = "**/*.jar" />
</ fileset >
< fileset dir = "${tomcat.home}/lib" >
< include name = "**/*.jar" />
</ fileset >
</ path >
|
(11)<javac>标签:
用于编译Java文件,常用几个属性如下:
-
srcdir:表示源代码路径
-
destdir:表示生成的class文件的路径
示例代码如下:
1
2
3
4
|
< target name = "compile" depends = "clean" >
< mkdir dir = "build/classes" />
< javac srcdir = "src" destdir = "build/classes" />
</ target >
|
(12)<java>标签:
用于执行.class文件,常用属性如下:
-
classname :表示将执行的类名
-
jar:表示包含该类的JAR文件名
-
classpath:表示用到的类路径
示例代码如下:
1
2
3
4
5
6
7
|
< target name = "run" depends = "compile" >
< java classname = "javase.base.Demo2" >
< classpath >
< pathelement path = "build/classes/" />
</ classpath >
</ java >
</ target >
|
(13)<jar>标签:
用于将class文件打包成jar包,常用属性如下:
-
basedir:表示待归档的目录
-
destfile:表示生成的JAR文件名
示例代码如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
<? xml version = "1.0" ?>
< project name = "javacTest" default = "makeJar" basedir = "." >
< target name = "clean" >
< delete dir = "build" />
</ target >
< target name = "compile" depends = "clean" >
< mkdir dir = "build/classes" />
< javac srcdir = "src" destdir = "build/classes" />
</ target >
< target name = "run" depends = "compile" >
< java classname = "javase.base.Demo2" >
< classpath >
< pathelement path = "build/classes/" />
</ classpath >
</ java >
</ target >
< target name = "makeJar" depends = "run" >
< jar destfile = "Demo.jar" basedir = "build/classes" >
< manifest >
< attribute name = "Main-class" value = "javase.base.Demo2" />
</ manifest >
</ jar >
</ target >
</ project >
|