Ant语法和规范

一、前言：

       以前在做JavaEE项目的时候曾经听说过这个名字，但是由于没有用到，所以也没有去学习。最近在研究Android打包的时候，看了下build.xml文件，甚是迷糊，于是学习一下，稍有心得。

二、什么是ant？

        ant是一种基于Java的打包工具，非常类似于Linux下的makefile。ant有自己的语法和规范，通常用xml来承载。ant可以集成代码生成、编译、打包等功能（需要说明一下，ant本身并不具备这些功能，只是调用者），使用ant能做到编译、打包一系列流程的自动化，就像生产流水线，一条指令，全程自动生产。

ant工具是使用Java语言编写的，所以依赖jdk，安装ant必须先安装好jdk。同样ant很多扩展的自定义的功能同样可以使用Java编写，后续会详细介绍。

三、ant的基本语法和规范

            ant的构建脚本是使用xml文件承载的，缺省命名为build.xml。进入其文件所在目录，可以在cmd中直接使用ant命令调用（前提是先配好bin目录的环境变量）。

       我们先来看一下build.xml文件的基本结构：

<?xml version="1.0" encoding="UTF-8"?>
<project name="test" default="build">
      <property name="file.dir" value="D://"/>
        <property file="local.properties" />
        <loadproperties srcFile="project.properties" />
        <import file="rules.xml" optional="true" />
        <target name="build">
             <echo>runing...</echo>
        </target>
       <target name="debug" depends="build">
             <echo level="info">${file.dir} debugging...</echo>
       </target>
</project>

project    根标签。name属性表示项目名称，没什么作用；default属性表示默认执行命令，cmd命令行中使用ant和ant  default属性值（本例是ant build） 两种方式等效。

property  定义类标签。可以定义一些常量值，需要注意：定义后理论不能再修改（其实可以通过第三方库修改）。比如第3行定义了一个file.dir的变量，值为”D://“，引用时使用 ${file.dir}调用。第4行，是引入一个properties文件（里面定义了很多property），相当于导包。

loadproperties  引用标签。功能和第4行<property file=""/>等同，表示引入一个properties定义集群。好处是便于封装和管理。

import  引入标签。和loadproperties不同的是，import是引入另一个构建文件，包括变量和执行命令。

target  执行标签。可以在cmd命令行中直接ant + target执行，比如以上脚本可以执行： ant build 和 ant debug。target标签中有个depends属性，表示执行命令依赖。如果要执行debug命令，会自动先执行depends里面的命令。以上脚本执行 ant debug，实际是执行了 ant build 和 ant debug

echo  日志标签。表示日志输出，能在cmd命令中打印显示，level属性表示：日志级别。 比较特殊的是echo中可以引用变量，用法同变量调用方式${name}。

以上就是ant最基本的语法规范，我们执行下ant debug命令看看结果。

分析以上执行过程：cmd进入build.xml所在目录，执行target名为debug的命令，由于debug依赖于build，所以先执行build命令，打印出runing... 然后再执行debug命令下的语句，打印出D:// debugging... （注意其中引用了一个变量），执行完毕！

四、ant的常用语法

        1、文件语句

        文件操作是ant中最常用的基本操作，包括创建、复制、删除、遍历等。由于ant涉及最多的就是文件操作，所以它的api相对来说非常丰富，让我们来逐一介绍和学习。

        创建：mkdir标签。 传入一个文件路径，直接创建出一个文件目录。然而不知为何ant没有提供创建文件的功能。

<mkdir dir="D:/test"/><span style="font-family: Arial, Helvetica, sans-serif; background-color: rgb(255, 255, 255);">      </span>

        删除：delete标签。删除文件或文件夹。

<delete file="D:/test/example.txt"/>
<delete dir="D:/test"/>

              移动：move标签。包括文件重命名、文件移动、文件目录移动。

<!-- 重命名 -->
<move file="D:/test/example1.txt" tofile="D:/test/example2.txt"/>
<!-- 移动文件至新目录，新目录会自动创建 -->
<move file="D:/test/example2.txt" todir="D:/test2"/>
<!-- 文件夹移动 -->
<move dir="D:/test/example2.txt" todir="D:/test2"/>

              复制：copy标签。文件复制。

<!-- 文件复制，指定新文件名 -->
<copy file="D:/test/example.txt" tofile="D:/test/example2.txt"/>
<!-- 文件复制，指定新文件目录 -->
<copy file="D:/test/example.txt" todir="D:/test/new/"/>
<!-- 文件夹复制，指定新文件夹 -->
<copy dir="D:/test/" todir="D:/test/new/"/>

        2、条件语句

             condition标签，配合istrue或者isfalse使用。

	<condition property="check">
		<istrue value="false" />
	</condition>
	<target name="build" if="check">
		<echo>build running...</echo>
	</target>

        稍微解释下以上语句：在执行名为build的target任务时，由于target中含有if的标签，所以需要判断名为check的条件语句的值，但是istrue=false的语句表示条件不符合，echo并不会执行。如果改成istrue=true，echo将执行。当然以上语句等价于：

	<condition property="check">
		<isfalse value="true" />
	</condition>
	<target name="build" if="check">
		<echo>build running...</echo>
	</target>

                  需要注意下，istrue和isfalse两种标签不能同时存在。

          除了直接使用istrue指定条件语句的值，还能动态地使用equals比较变量，比如：

<property name="id" value="99"></property>
	<condition property="check">
		<equals arg1="${id}" arg2="100"/>
	</condition>
	<target name="build" if="check">
		<echo>build running...</echo>
	</target>

         3、循环语句
        ant本身并没有提供循环语句，但是我们可以借助于ant-contrib.jar使用循环语句，举个简单的例子：

    <property name="ant-contrib" value="E:\\Android\\android-sdk\\tools\\lib\\ant-contrib-1.0b3.jar"></property>
    <taskdef name="foreach" classname="net.sf.antcontrib.logic.ForEach" classpath="${ant-contrib}"/>
	<target name="build">
	    <foreach list="1,2,3,4,5,6,7,8,9" param="number" delimiter="," target="log"/>  
	</target>
	<target name="log">
		<echo>foreach running: ${number}</echo>
	</target>

       以上语句稍微有些复杂，我们一句句来理。第一句property定义一个变量，即扩展jar包ant-contrib-1.0b3.jar所在的文件位置。第二句taskdef标签，表示定义自定义名为foreach的标签，需要引用类名和类路径，这是使用foreach的前提条件，必须先定义好。然后我们就可以在target任务中愉快地使用for循环了。
       接下来我们来看foreach语句的内容，list标签 + delimiter标签构成循环的条件，这里是循环9次，每次循环创建一个名为number的数字变量，同时执行log任务打印一句话，结果如下：

        4、自定义语句

        ant的魅力所在之处就是强大的自定义语句，比如上面的foreach语句。ant官方库只定义了一些简单的语句，但是在实际项目中远远不足以满足我们的需要，比如新建一个文件。这里我们就用自定义语句来实现下。

        ant的原理是每个语句标签映射一个java类文件，每个标签里的属性则映射java类的变量，有点类似spring中xml映射javabean。每个ant标签映射的java类文件不是随意编写的，有一定的规范。

        在ant安装目录下的lib文件目录中有个名为ant.jar的包，这个就是ant的规范标准库，自定义语句Java类都需要依赖它来编译，同时每个语句必须继承其中名为Task.java的基类，复写execute方法执行自定义操作。

package com.ant.test;

import java.io.File;
import java.io.IOException;

import org.apache.tools.ant.BuildException;
import org.apache.tools.ant.Task;

public class FileCreater extends Task{

	private String fileName;
	
	public void setName(String fileName){
		this.fileName = fileName;
	}
	
	@Override
	public void execute() throws BuildException {
		try {
			new File(fileName).createNewFile();
		} catch (IOException e) {
			log("create file '" + fileName + "' failed!");
		}
		log("create file '" + fileName + "' successful!");
		super.execute();
	}
}

         上面定义了创建文件的自定位标签，把这个java文件打成jar包，然后就可以在build.xml使用了，xml内容如下：

    <property name="fileJar" value="D:/file.jar"></property>
    <taskdef name="filecreater" classname="com.ant.test.FileCreater" classpath="${fileJar}"/>
	<target name="build">
	    <filecreater name="D:/test.txt"/>  
	</target>

         以上执行的操作是创建一个路径为D:/test.txt的文件。filecreater是映射FileCreater.java的自定义标签，name属性传入文件路径名，会自动 反射调用 FileCreater.java中的setName方法注入参数值。在FileCreater.java中有个log打印输出方法，可以在cmd中输出，极大方便我们的调试。执行结果如下：

------------------------------------------------------------------------------------------------>

好了，ant相关的就先写到这里，权当抛砖引玉^-^