1. Ant简要说明
Apache Ant是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具,大多用于Java环境中的自动化构建。Ant具有跨平台性和操作简单等特点。Ant是由一个内置任务和可选任务组成的。Ant运行时需要一个XML文件(构建文件)。 Ant通过调用target树,就可以执行各种任务。
2. Ant环境搭建
ant下载路径http://ant.apache.org/,下载完成后,解压到指定路径下如:D:\ANT\apache-ant-1.9.7,然后在电脑上进行环境配置如:
ANT_HOME D:\ANT\apache-ant-1.9.7
path D:\ANT\apache-ant-1.9.7\bin
classpath D:\ANT\apache-ant-1.9.7\lib
ant环境验证:在cmd命令窗口,输入命令ant如图:
如上图显示则为环境搭建完成。
2. Ant常用语法
ant的构建脚本是使用xml文件承载的,缺省命名为build.xml。进入其文件所在目录,可以在cmd中直接使用ant命令调用。一个简单标准ant文件的基本结构如:
<?xml version="1.0" encoding="UTF-8"?>
<project name="main" basedir="." default="help">
<property file="./build.properties"></property>
<property file="./resource/version.txt"></property>
<property name="base-dir-home" value="${basedir}"/>
<record name="debug.${TIMESTAMP}.txt" loglevel="verbose" append="no" action="start"/>
<taskdef resource="net/sf/antcontrib/antlib.xml">
<classpath>
<pathelement location="./tools/ant-contrib.jar"/>
</classpath>
</taskdef>
<target name="out-base" description="初始化base">
<echo>start out-base</echo>
<ant antfile="build.xml"
dir="./builds"
inheritall="true"
inheritrefs="false"
/>
</target>
<target name="out-port">
<echo>start out-port</echo>
<ant antfile="build.xml"
dir="./outPortTool"
inheritall="true"
inheritrefs="false"
/>
</target>
<target name="out-version">
<echo>start out-version</echo>
<antcall target="out-port"></antcall>
<antcall target="out-xmls"></antcall>
<antcall target="out-base"></antcall>
<ant antfile="build.xml"
dir="./outVersionTool"
inheritall="true"
inheritrefs="false"
/>
</target>
<target name="out-xmls" description="执行输出xmls">
<echo>start out-xmls</echo>
<ant antfile="build.xml"
dir="./buildXML"
inheritall="true"
inheritrefs="false"
/>
</target>
<target name="help" description="初始菜单">
<echo>targets:</echo>
<echo>out-port</echo>
<echo>out-xmls</echo>
<echo>out-base</echo>
<echo>out-version</echo>
</target>
</project>
- project标签是构建文件的根标签
(1) default表示默认的运行目标,这个属性是必须的。
(2) basedir表示项目的基准目录。
(3) name表示项目名。
(4) description表示项目的描述。 - target标签是任务标签,一个项目标签下可以有一个或多个target标签。一个target标签可以depends属性依赖其他的target标签,target标签的属性:
(1) name表示标明,这个属性是必须的。
(2) depends表示依赖的目标。
(3) if表示仅当属性设置时才执行。
(4) unless表示当属性没有设置时才执行。
(5) description表示项目的描述。 - property标签是引用标签如:
(1)<property file="./build.properties"></property>
导入项目根目录下build.properties中的全局变量,开发人员也可以在此文件中重新定义全局变量。
(2)<property name="base-dir-home" value="${basedir}"/>
定义各种元素的名称,可以是组件、源代码目录路径、资源目录路径、库目录路径等。 - echo标签是输入日志标签。
- ant标签是代表可以执行另一个xml文件形式的ant脚本。
- antcall标签是调用当前构建文件的另一个任务。注意,不一定是同一个项目。也就是说,同一个构建文件可能包含多个项目,其余的项目可以通过import构建文件来获得。
- record标签是向当前的构建过程添加一个监听者,把输出记录到文件。
- copy标签是复制一个文件或目录,属性:
(1).file 表示源文件。
(2).tofile 表示目标文件。
(3).todir 表示目标目录。
(4).overwrite 表示指定是否覆盖目标文件,默认值是不覆盖。
(5).includeEmptyDirs 表示制定是否拷贝空目录,默认值为拷贝。
(6).failonerror 表示指定如目标没有发现是否自动停止,默认值是停止。
(7).verbose 表示制定是否显示详细信息,默认值不显示。 - delete标签是删除一个文件或目录,或删除根据fileset定义的文件集合
- mkdir标签用于创建一个目录,它有一个属性dir用来指定所创建的目录名。
- jar标签用来生成一个JAR文件,其属性如下:
(1) destfile表示JAR文件名。
(2) basedir表示被归档的文件名。
(3) includes表示别归档的文件模式。
(4) exchudes表示被排除的文件模式。 - javac标签用于编译一个或一组java文件,其属性如下:
(1).srcdir表示源程序的目录。
(2).destdir表示class文件的输出目录。
(3).include表示被编译的文件的模式。
(4).excludes表示被排除的文件的模式。
(5).classpath表示所使用的类路径。
(6).debug表示包含的调试信息。
(7).optimize表示是否使用优化。
(8).verbose 表示提供详细的输出信息。
(9).fileonerror表示当碰到错误就自动停止。 - java标签用来执行编译生成的.class文件,其属性如下:
(1).classname 表示将执行的类名。
(2).jar表示包含该类的JAR文件名。
(3).classpath所表示用到的类路径。
(4).fork表示在一个新的虚拟机中运行该类。
(5).failonerror表示当出现错误时自动停止。
(6).output 表示输出文件。
(7).append表示追加或者覆盖默认文件。 - replace标签用给定值替换指定文件中所有出现一个或者多个token的地方,如
<replace file="index.xml">
。
<replacefilter token="@inxxx" value="outxxx"/>
</replace> - move标签将文件移动到另一个目录,或将文件集移动到另一个目录。
3. Ant的运行
安装好Ant并且配置好路径之后,在命令行中切换到构建文件的目录,输入Ant命令就可以运行Ant.若没有指定任何参数,Ant会在当前目录下查询build.xml文件。如果找到了就用该文件作为构建文件。如果使用了 –find 选项,Ant 就会在上级目录中找构建文件,直至到达文件系统得跟目录。如果构建文件的名字不是build.xml ,则Ant运行的时候就可以使用 –buildfile file,这里file 指定了要使用的构建文件的名称。
转载请说明出处:http://blog.youkuaiyun.com/u012438830/article/details/78418926