一. 配置环境变量
      1. 添加ANT_HOME——Ant目录;(可选)
      2. 在PATH追加"Ant目录\bin"
      3.在控制台cmd输入命令ant,提示
          “Buildfile: build.xml does not exist!
            Build failed“
          表示系统能够识别ant 命令了,这样可以在任意文件夹下运行该命令。
 
二. build.xml文件的组成
   build.xml文件的主干是,一个根结点project,project里面包含多个target,target内含不同的task。
 
    Ant的大概运行过程
   当运行ant命令,则尝试读取当前目录的build.xml,分析xml文件,按照project的default属性,执行指定的target。
   当运行ant targetname,则在读取xml文件后,分析找到相应的target并执行。
 
1.project根结点
   基本属性: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依赖于它。
 
   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或unless属性,target总会被执行。
 
   2.3 description属性
       可选的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>
 
   3.2 删除目录delete
       <delete includeEmptyDirs="true">
            <fileset dir="${build}"/>
       </delete>
 
       <target name="clean" description="clean up" >
            <delete dir="${build}"/>
            <delete dir="${dist}"/>
       </target>
 
   3.3 copy文件或目录
       <copy file="file" tofile="file.bak"/>
 
       <copy file="config.xml" todir="${dist.classes.dir}"/>
 
       <copy todir="${targetdir}">
            <fileset dir="${sourcedir}"/>
       </copy>
 
       <target name="copy-resources" depends="clean">
            <copy todir="${targetdir}">
                <fileset dir="${sourcedir}">
                    <exclude name="**/**/*.java" />
                </fileset>
            </copy>
       </target>
 
   3.4 move文件或目录
       <move file="file" tofile="file.bak"/>
 
       <move todir="${targetdir}">
            <fileset dir="${sourcedir}"/>
       </move>
 
       <move todir="${targetdir}">
            <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>
 
   3.6 jar
       <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>
4. 变量property
   <property name="sourcedir" value="${basedir}/src" />
   <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的版本
 
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>