ant简介

1.Ant

---

Ant是一个Open Source的软件,是一种基于Java的build工具,能够进行编译、执行、打包、发布等操作。

 

2.安装Ant

---

前提：系统中已经安装JDK并已经配置JAVA_HOME和运行Java所需的CLASSPATH和PATH

 

从http://ant.apache.org/下载最新版本，目前最近版本1.6.5
解压缩，设置ANT_HOME路径为解压缩目录
将bin目录加入PATH环境变量，即%ANT_HOME%in
Ant支持一些可选task,你可以从apache网站下载这些task包，将这些jar文件放到Ant安装目录的lib目录

下。

3.运行Ant

---

运行Ant非常简单，在Command窗口下执行ant命令就行了
没有指定任何参数时，Ant会在当前目录下查询build.xml文件。如果找到了就用该文件作为buildfile。

 

如果你用 -find 选项。Ant就会在上级目录中寻找buildfile，直至到达文件系统的根。要想让Ant使用其

他的buildfile，可以用参数 -buildfile file，这里file指定了你想使用的buildfile。
可以指定执行一个或多个target。当省略target时，Ant使用标签<project>的default属性所指定的target。

例子：
ant

使用当前目录下的build.xml运行Ant，执行缺省的target。

ant -buildfile test.xml

使用当前目录下的test.xml运行Ant，执行缺省的target。

ant -buildfile test.xml dist

使用当前目录下的test.xml运行Ant，执行一个叫做dist的target。

ant -buildfile test.xml -Dbuild=build/classes dist

使用当前目录下的test.xml运行Ant，执行一个叫做dist的target，并设定build属性的值为build/classes。

4.编写build.xml

---

Ant的buildfile是用XML写的。每个buildfile含有一个project。
buildfile中每个task元素可以有一个id属性，可以用这个id值引的.指定的任务。这个值必须是唯一。

 

Projects
Attribute  Description  Required  
name  项目名称.  No 
default  当没有指定target时使用的缺省target Yes 
basedir  用于计算所有其他路径的基路径。该属性可以被basedir property覆盖。当覆盖时，该属性被忽略。如果属性和basedir property都没有设定，就使用buildfile文件的父目录。
 NO

一个项目可以定义一个或多个target。一个target是一系列你想要执行的。执行Ant时，你可以选择执行

那个target。当没有给定target时，使用project的default属性所确定的target。

Targets

一个target可以依赖于其他的target。例如，你可能会有一个target用于编译程序，一个target用于生成

可执行文件。你在生成可执行文件之前必须先编译通过，所以生成可执行文件的target依赖于编译target

。Ant会处理这种依赖关系。

然而，应当注意到，Ant的depends属性只指定了target应该被执行的顺序－如果被依赖的target无法运行

，这种depends对于指定了依赖关系的target就没有影响。

Ant会依照depends属性中target出现的顺序（从左到右）依次执行每个target。然而，要记住的是只要某

个target依赖于一个target，后者就会被先执行。

<target name="A"/>
<target name="B" depends="A"/>
<target name="C" depends="B"/>
<target name="D" depends="C,B,A"/>

假定我们要执行target D。从它的依赖属性来看，你可能认为先执行C，然后B，最后A被执行。错了，C依

赖于B，B依赖于A，所以先执行A，然后B，然后C，最后D被执行。

一个target只能被执行一次，即时有多个target依赖于它（看上面的例子）。

如果（或如果不）某些属性被设定，才执行某个target。这样，允许根据系统的状态（java version, OS, 命令行属性定义等等）来更好地控制build的过程。要想让一个target这样做，你就应该在target元素中，加入if（或unless）属性，带上target因该有所判断的属性。例如：

<target name="build-module-A" if="module-A-present"/>
<target name="build-own-fake-module-A" unless="module-A-present"/>

如果没有if或unless属性，target总会被执行。

target有下面的属性：
Attribute  Description  Required  
name  target的名字  Yes 
depends  用逗号分隔的target的名字列表，也就是依赖表。 No 
if  执行target所需要设定的属性名。 No 
unless  执行target需要清除设定的属性名。 No 
description  关于target功能的简短描述。 No

一个task是一段可执行的代码。

一个task可以有多个属性（如果你愿意的话，可以将其称之为变量）。属性只可能包含对property的引用

。这些引用会在task执行前被解析。

下面是Task的一般构造形式：

<name attribute1="value1" attribute2="value2" ... />

这里name是task的名字，attributeN是属性名，valueN是属性值。

有一套内置的（built-in）task，以及一些可选task，但你也可以编写自己的task。

所有的task都有一个task名字属性。Ant用属性值来产生日志信息。

Properties

一个project可以有很多的properties。可以在buildfile中用property task来设定，或在Ant之外设定。

一个property有一个名字和一个值。property可用于task的属性值。这是通过将属性名放在"${"和"}"之

间并放在属性值的位置来实现的。例如如果有一个property builddir的值是"build"，这个property就可

用于属性值：${builddir}/classes。这个值就可被解析为build/classes。

内置属性

如果你使用了<property> task 定义了所有的系统属性，Ant允许你使用这些属性。例如，${os.name}对

应操作系统的名字。

要想得到系统属性的列表可参考the Javadoc of System.getProperties。

除了Java的系统属性，Ant还定义了一些自己的内置属性： 
basedir project基目录的绝对路径 (与<project>的basedir属性一样)。
ant.file buildfile的绝对路径。
ant.version Ant的版本。
ant.project.name 当前执行的project的名字；由<project>的name属性设定.
ant.java.version Ant检测到的JVM的版本； 目前的值有"1.1", "1.2", "1.3" and "1.4".

 

在和HeJian为DailyC项目写的 build.xml完整例子：

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

<!-- set global properties for this build -->
<property name="src" value="src"/>
<property name="lib" value="lib"/>
<property name="classes" value="classes"/>
<property name="dist" value="dist"/> 
<property name="web" value="WebRoot"/>

<path id="master-classpath">
<pathelement path="${classes}"/>
<fileset  file="${lib}/*.jar"/>
</path>

   
<target name="init">
<!-- Create the time stamp -->
<tstamp/>

</target>

<target name="clean">
<!-- Delete the ${classes} and ${dist} directory trees -->
<delete dir="${classes}"/>
<delete dir="${dist}"/>
</target>

<target name="compile" depends="init,clean">
<!-- Create the build directory structure used by compile -->
<mkdir dir="${classes}"/>
<!-- Compile the java code from ${src} into ${build} -->
<javac srcdir="${src}" destdir="${classes}">
  <classpath refid="master-classpath"/>
</javac>
</target>

<target name="dist" depends="compile">
<!-- Create the distribution directory -->
<mkdir dir="${dist}"/>
<!-- Put everything in ${build} into the dailyc-${DSTAMP}.jar file -->
<jar jarfile="${dist}/dailyc-${DSTAMP}.jar" basedir="${classes}"/>

<war destfile="${dist}/dailyc.war" webxml="web.xml">
  <fileset dir="${web}"/>
  <lib dir="${lib}">
    <include name="ChartDirector.jar"/>
  </lib>  
  <classes dir="${classes}"/>
</war>
</target>
</project>

感谢http://blog.youth.cn/html/17/456317-4181.html