Apache Ant学习总结：Ant自动化脚本入门以及一些常用命令介绍

Posted 2020-07-26

一 Ant简介

Apache Ant是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的自动化构建。它是Apache软件基金会JAKARTA目录中的一个子项目，它有以下的优点：

• 跨平台性。Ant是纯Java语言编写的，所以具有很好的跨平台性

• 操作简单。Ant是由一个内置任务和可选任务组成的。Ant运行时需要一个XML文件(构建文件)。 Ant通过调用target树，就可以执行各种任务。由于Ant构建文件 是XML格式的文件，所以很容易维护和书写，而且结构清晰。可以很方便的集成到各种开发环境中去

（注：以上简介参考至百度百科）

二 Ant环境搭建及入门实例

1. 要想使用ant，首先需要去官网下载ant的安装包，地址：http://ant.apache.org/bindownload.cgi

2. ant的环境变量配置。配置过程跟Java的环境变量配置有点类似，也就是在系统的“环境变量”的“系统变量”——Path 添加上ant的bin路径即可，示例图如下：

当上面的环境变量配置好了之后就可以在cmd中进行测试了，如果出现下面的提示则说明已经配置成功了

写一个入门实例，输出“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 ，输出如下：

上面的代码很简单，就是简单输出一个“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文件名

示例代码如下：

<?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>

本文出自 “zifangsky的个人博客” 博客，请务必保留此出处http://983836259.blog.51cto.com/7311475/1789792