Apache 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路径即可,示例图如下:0001
当上面的环境变量配置好了之后就可以在cmd中进行测试了,如果出现下面的提示则说明已经配置成功了:1
写一个入门实例,输出“Hello World”。在一个目录新建一个名“build_test1.xml”的文件,内容如下:
<?xml version="1.0"?> <project name="helloWorld"> <target name="sayHello"> <echo message="Hello,Ant!"/> </target> </project>
然后将cmd的工作目录切换到上面那个文件的目录,执行以下命令:ant -buildfile build_test1.xml sayHello ,输出如下:2
上面的代码很简单,就是简单输出一个“Hello,Ant!”。关于上面的代码中的每个标签是什么含义,我将在下面进行简单解释
三 Ant的一些常用标签以及示例
(1)<project>标签:
<project>标签是构建文件的根标签,每个构建文件对应一个项目,它的几个常用属性如下:
name:表示project项目名
default:表示该Ant项目启动时默认执行的任务名,如果没有该参数,则需要在项目运行时手动指定执行的任务
basedir:表示项目执行的默认目录
示例代码如下:
<?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>
在控制台中执行以下命令:
ant -buildfile build_test2.xml
输出如下:
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的含义相反,表示当属性没被设置时才执行这个任务
示例代码如下:
<?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>
输出:
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>标签:
顾名思义,可以创建一个文件夹
示例代码如下:
<mkdir dir="build/classes"/>
(4)<delete>标签:
可以对文件或者文件夹进行删除,常用属性如下:
file:表示要删除的文件
dir:表示要删除的目录
includeEmptyDirs:表示是否删除指定目录中的空目录,如:includeEmptyDirs=”true”
failonerror:表示在碰到错误时是否停止,默认是自动停止
示例代码如下:
代码如下:
<delete dir="build/classes" />
(5)<copy>标签:
用于复制文件或者目录,常用属性如下:
file:表示源文件
tofile:表示目标文件
todir:表示目标目录
overwrite:表示是否覆盖目标文件,默认是不覆盖
复制单个文件:
代码如下:
<copy file="old.txt" tofile="new.txt" />
复制一个文件到另一个目录:
代码如下:
<copy file="old.txt" todir="test1/addtest" overwrite="true" />
对目录进行复制:
代码如下:
<copy todir="test1/addtest"> <fileset dir="addtest"/> </copy>
(6)<move>标签:
用于移动文件或者目录,常用属性跟<copy>标签差不多
示例代码如下:
代码如下:
<move file="sourcefile" tofile="destfile" /> <move file="sourcefile" todir="destdir" /> <move todir="newdir" > <fileset dir="olddir" /> </move>
(7)<filelist>标签:
表示一个文件列表,常用属性如下:
dir:表示文件目录
files:用逗号分隔的一个文件列表
refid :表示对某处定义的一个<filelist>的引用
示例代码如下:
<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:表示不包含这些模式的文件列表
示例代码如下:
<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>标签:
用于定义一个参数
示例代码如下:
代码如下:
<property name="zifangsky" value="www.zifangsky.cn" />
(10)<path>标签:
用于定义一个路径
示例代码如下:
<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文件的路径
示例代码如下:
<target name="compile" depends="clean"> <mkdir dir="build/classes" /> <javac srcdir="src" destdir="build/classes" /> </target>
(12)<java>标签:
用于执行.class文件,常用属性如下:
classname :表示将执行的类名
jar:表示包含该类的JAR文件名
classpath:表示用到的类路径
示例代码如下:
<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文件名
示例代码如下:
XHTML
<?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>