Apache Ant快速入门教程

1. ANT定义

　　Ant(Another Neat Tool)是一组Java类别库与命令列工具，它的建立档案(build file)是由XML组成，而每一个建立档案会包含一个计画(Project)与一个以上的目标(target)，在每一个目标内会包含一组要执行的任务(task)。一个Ant建立档案会由计画、目标、任务、属性(properties)、路径(paths)等相关元素所组成。

　　2. ANT的组成元素

　　项目(Project)

　　在Ant脚本中是为上层的元素，它有叁个选择性的属性可以设定，分别name、default、basedir

　　name是专案的名称

　　default代表当在专案中不存在任何target时，专案就会直接使用default设置的target

　　basedir即buildfile文件所在之根目录

　　目标(Target)

　　每一个专案定义零到多个目标，一个目标也就是一组你想要执行的任务，并且当您要启动Ant时，可以选择想要执行的目标只要没有给定任何目标，专案就会使用预定目标 我们也可以运用if/unless条件式来决定该执行那一个目标，一个目标可以相依于其他目标，也就是需要等被依赖的目标执行完成，该目标才能接续执行。

　　任务(Tasks)

　　一个任务是由一个可执行的代码所组成，它包含了多重属性。

　　属性(Properties)

　　一个属性是由一个名称和一个值组成，名称以大小写作为区别，举例来说，有一个builddir的属性拥有build值， 而且使用在属性标籤表示式会是${builddir}/classes，当执行Ant buildfile时会输出build/classes的结果，一般而言属性不是变数,通常以字串常数的型态呈现。

　　例子，设置test.dist属性为"dist"值：

　　<property name="test.dist" value="dist"/>

　　路径(Paths)

　　路经结构是由classpath、pathelement、fileset、dirset与filelist等元素分别组合而成。

　　classpath是类别参考路径

　　pathelement用来指定目录或jar文档

　　fileset是一群档案的组合

　　dirset是一群目录的组合

　　filelist定义为档案的集合

　　<classpath>

    <pathelement path="${classpath}"/>
    <fileset dir="lib">
      <include name="**/*.jar"/>
    </fileset>
    <pathelement location="classes"/>
    <dirset dir="${build.dir}">
      <include name="apps/**/classes"/>
      <exclude name="apps/**/*Test*"/>
    </dirset>
    <filelist refid="other_jars"/>
  </classpath>

　　3.第一支简单的ANT BUILDFILE文件

　　首先， 我们必须依据所属的应用程式项目建立自己的buildfile文件，可以参考以下的范例说明：

　　建立简单buildfile文件：

<project name="TestProject" default="dist" basedir=".">   

  <!-- 为build文件设定全域性属性 -->

  <property name="src" location="src"/>

  <property name="build" location="build"/>

  <property name="dist"  location="dist"/>

 

  <target name="init">   

    <!-- 建立build的目录结构 -->

    <mkdir dir="${build}"/>

  </target>

 

  <target name="compile" depends="init" description="compile the source " >

    <!-- 从src目录编绎java代码,且将编译好的class代码移动到build目录  -->

    <javac srcdir="${src}" destdir="${build}"/>

  </target>

 

  <target name="dist" depends="compile" description="generate the distribution" >

    <!-- 创建放置jar档目录 -->

    <mkdir dir="${dist}/lib"/>

 

    <!-- 把build目录内的所有档案结构打包成一个TestProject.jar档  -->

    <jar jarfile="${dist}/lib/${ant.project.name}.jar" basedir="${build}"/>

  </target>

 

  <target name="clean"  description="clean up" >

    <!-- 删除build与dist树状结构目录  -->

    <delete dir="${build}"/>

    <delete dir="${dist}"/>

  </target>

</project>

在撰写完成buildfile文件之后，需要安装Ant工具或者使用Eclipse IDE内建的Ant plugin来执行我们刚才所建立的buildfile文件。

　　Buildfile: D:\Works\TestProject\TestProject.xml

　　init:

　　[mkdir] Created dir: D:\Works\TestProject\build

　　compile:

　　[javac] Compiling 1 source file to D:\Works\TestProject\build

　　dist:

　　[mkdir] Created dir: D:\Works\TestProject\dist\lib

　　[jar] Building jar: D:\Works\TestProject\dist\lib\TestProject.jar