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>

相关推荐