一. 配置环境变量
1. 添加ANT_HOME——Ant目录；(可选)
2. 在PATH追加"Ant目录\bin"
3.在控制台cmd输入命令ant，提示
“Buildfile: build.xml does not exist!
Build failed“
Build failed“
表示系统能够识别ant 命令了，这样可以在任意文件夹下运行该命令。
二. build.xml文件的组成
build.xml文件的主干是，一个根结点project,project里面包含多个target,target内含不同的task。
Ant的大概运行过程
当运行ant命令，则尝试读取当前目录的build.xml，分析xml文件，按照project的default属性,执行指定的target。
当运行ant targetname，则在读取xml文件后，分析找到相应的target并执行。
当运行ant命令，则尝试读取当前目录的build.xml，分析xml文件，按照project的default属性,执行指定的target。
当运行ant targetname，则在读取xml文件后，分析找到相应的target并执行。
1.project根结点
基本属性：name、default、basedir。
name: 项目名称(可选)
基本属性：name、default、basedir。
name: 项目名称(可选)
default: 默认开始执行的target。(必需)
basedir: 用于计算所有其他路径的基路径。可以被basedir property覆盖。当覆盖时，该属性被忽略。如果属性和basedir property都没有设定，就使用build.xml的父目录。一般basedir=".",设置为build.xml所在的目录。(可选)
2.target
| Attribute属性 | Description属性值内容 | Required |
| name | target的名字 | Y |
| depends | 需要依赖的其他target | N |
| description | 关于target功能的简短描述 | N |
| if | 为了执行本target而被设置的属性的名字 | N |
| unless | 为了执行本target而不被设置的属性的名字 | N |
2.1 依赖关系depands
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
当执行target D,则先执行A,再B,然后C,最后D。
一个target只能被执行一次，即使有多个target依赖于它。
<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>
当执行target D,则先执行A,再B,然后C,最后D。
一个target只能被执行一次，即使有多个target依赖于它。
2.2 if,unless
if属性表示该属性内容的变量如果已经被设置了，则可以执行本target;
unless属性则表示该属性内容的变量如果还没有被设置，则可以执行本target。
伪代码:
//if="ready" //unless="ready"
if(ready == "ok"){ if(ready == null){
execute target; execute target;
}else { }else {
skip; skip;
} }
if属性表示该属性内容的变量如果已经被设置了，则可以执行本target;
unless属性则表示该属性内容的变量如果还没有被设置，则可以执行本target。
伪代码:
//if="ready" //unless="ready"
if(ready == "ok"){ if(ready == null){
execute target; execute target;
}else { }else {
skip; skip;
} }
如果没有if或unless属性，target总会被执行。
2.3 description属性
可选的description属性可用来提供关于target的一行描述，可由-projecthelp命令行选项输出
可选的description属性可用来提供关于target的一行描述，可由-projecthelp命令行选项输出
3. task
常用的task:
3.1 创建目录mkdir
创建一个目录，如果其父目录不存在，也会被同时创建。
<mkdir dir="build/classes"/>
<target name="init">
<mkdir dir="${dist.dir}" />
<mkdir dir="${dist.classes.dir}" />
<mkdir dir="${dist.webapps.dir}" />
</target>
创建一个目录，如果其父目录不存在，也会被同时创建。
<mkdir dir="build/classes"/>
<target name="init">
<mkdir dir="${dist.dir}" />
<mkdir dir="${dist.classes.dir}" />
<mkdir dir="${dist.webapps.dir}" />
</target>
3.2 删除目录delete
<delete includeEmptyDirs="true">
<fileset dir="${build}"/>
</delete>
<delete includeEmptyDirs="true">
<fileset dir="${build}"/>
</delete>
<target name="clean" description="clean up" >
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
3.3 copy文件或目录
<copy file="file" tofile="file.bak"/>
<copy file="file" tofile="file.bak"/>
<copy file="config.xml" todir="${dist.classes.dir}"/>
<copy todir="${targetdir}">
<fileset dir="${sourcedir}"/>
</copy>
<fileset dir="${sourcedir}"/>
</copy>
<target name="copy-resources" depends="clean">
<copy todir="${targetdir}">
<fileset dir="${sourcedir}">
<exclude name="**/**/*.java" />
</fileset>
</copy>
</target>
<copy todir="${targetdir}">
<fileset dir="${sourcedir}">
<exclude name="**/**/*.java" />
</fileset>
</copy>
</target>
3.4 move文件或目录
<move file="file" tofile="file.bak"/>
<move file="file" tofile="file.bak"/>
<move todir="${targetdir}">
<fileset dir="${sourcedir}"/>
</move>
<fileset dir="${sourcedir}"/>
</move>
<move todir="${targetdir}">
<fileset dir="${sourcedir}">
<include name="**/**/*.java" />
</fileset>
</move>
<fileset dir="${sourcedir}">
<include name="**/**/*.java" />
</fileset>
</move>
3.5 compile
<path id="libraries">
<fileset dir="${libdir}">
<include name="*.jar" />
</fileset>
</path>
<target name="compile" depends="copy-resources">
<javac srcdir="${sourcedir}"
destdir="${targetdir}"
classpathref="libraries" />
<jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
</target>
<path id="libraries">
<fileset dir="${libdir}">
<include name="*.jar" />
</fileset>
</path>
<target name="compile" depends="copy-resources">
<javac srcdir="${sourcedir}"
destdir="${targetdir}"
classpathref="libraries" />
<jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
</target>
3.6 jar
<jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
<jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>
<jar destfile="${dist}/lib/app.jar">
<fileset dir="${build}/classes"
excludes="**/Test.class"
/>
<fileset dir="${src}/resources"/>
</jar>
<fileset dir="${build}/classes"
excludes="**/Test.class"
/>
<fileset dir="${src}/resources"/>
</jar>
4. 变量property
<property name="sourcedir" value="${basedir}/src" />
<property name="build" location="build" />
<property name="build" location="build" />
除了可以使用自定义的变量，还可以使用java系统属性, 例如${os.name}对应操作系统的名字，以及Ant内置属性：
basedir <project>的basedir属性
ant.file buildfile的绝对路径
ant.version Ant的版本
ant.project.name 当前执行的project的名字；由<project>的name属性设定
ant.java.version Ant检测到的JVM的版本
ant.file buildfile的绝对路径
ant.version Ant的版本
ant.project.name 当前执行的project的名字；由<project>的name属性设定
ant.java.version Ant检测到的JVM的版本
5. build.xml example
<?
xml
version
="1.0"
encoding
="UTF-8"
?>
< project default ="junitTest" name ="myProject" basedir ="." >
< property name ="sourcedir" value ="${basedir}/src" />
< property name ="targetdir" value ="${basedir}/WEB-INF/classes" />
< property name ="libdir" value ="${basedir}/WEB-INF/lib" />
< path id ="libraries" >
< fileset dir ="${libdir}" >
< include name ="*.jar" />
</ fileset >
</ path >
< target name ="junitTest" depends ="compile" >
< java classname ="junit.textui.TestRunner" >
< classpath >
< path refid ="libraries" />
< path location ="${targetdir}" />
</ classpath >
< arg value ="can.junit.HibernateDemoTest" />
</ java >
</ target >
< target name ="compile" depends ="copy-resources" >
< javac srcdir ="${sourcedir}"
destdir ="${targetdir}"
classpathref ="libraries" />
</ target >
< target name ="copy-resources" depends ="clean" >
< copy todir ="${targetdir}" >
< fileset dir ="${sourcedir}" >
< exclude name ="**/**/*.java" />
</ fileset >
</ copy >
</ target >
< target name ="clean" >
< delete dir ="${targetdir}" />
< mkdir dir ="${targetdir}" />
</ target >
</ project >
< project default ="junitTest" name ="myProject" basedir ="." >
< property name ="sourcedir" value ="${basedir}/src" />
< property name ="targetdir" value ="${basedir}/WEB-INF/classes" />
< property name ="libdir" value ="${basedir}/WEB-INF/lib" />
< path id ="libraries" >
< fileset dir ="${libdir}" >
< include name ="*.jar" />
</ fileset >
</ path >
< target name ="junitTest" depends ="compile" >
< java classname ="junit.textui.TestRunner" >
< classpath >
< path refid ="libraries" />
< path location ="${targetdir}" />
</ classpath >
< arg value ="can.junit.HibernateDemoTest" />
</ java >
</ target >
< target name ="compile" depends ="copy-resources" >
< javac srcdir ="${sourcedir}"
destdir ="${targetdir}"
classpathref ="libraries" />
</ target >
< target name ="copy-resources" depends ="clean" >
< copy todir ="${targetdir}" >
< fileset dir ="${sourcedir}" >
< exclude name ="**/**/*.java" />
</ fileset >
</ copy >
</ target >
< target name ="clean" >
< delete dir ="${targetdir}" />
< mkdir dir ="${targetdir}" />
</ target >
</ project >
本文转自 Icansoft 51CTO博客，原文链接：
http://blog.51cto.com/android/110442
