ant_demo程序说明.txt

使用ANT工具实现自动编译的例子。 自己的呀！里面有完整文档。

Java的Build工具—Ant应用指南（1）

本文以最新发布的Ant 1.5.1为例，介绍这款优秀的Build工具的安装配置、基本应用和一些高级话题。最新的Ant下载地址是 http://jakarta.apache.org/ant/ 。 

Ant是一种基于Java的Build工具。理论上来说，它有些类似于C中的make，但比make优越。现在存在的大多数Build工具，如make、gnumake、nmake、jam等都存在这样或那样的不足，比如依赖于特定的平台、配置文件过于复杂或者对格式无法检查而容易出错等。与这些工具相比较，Ant的两个特性决定了它是一款优秀的Build工具： 

1. 基于Java的实现。具有良好的跨平台性，同时可以通过增加新的Java类来扩展Ant的功能，而无需去了解不同平台上不同的脚本语言。 

2.基于XML的配置文件。Ant以XML树来描述Target/Task的关系，文件结构清晰、易读易写，并且利用XML对格式的控制来避免由于配置文件的错误造成的Build操作失败。 

安装与配置 

Ant的安装非常简单，把从网上下载的jakarta-ant-1.5.1-bin.zip解开到一个目录下即可（以下假定安装在目录D:\jakarta-ant-1.5.1）。接下来需要进行环境变量配置： 

SET ANT_HOME=D:\jakarta-ant-1.5.1 //注意是Ant的安装目录，不是bin子目录
SET PATH=%PATH%;%ANT_HOME%\bin; 


在配置环境变量之前，请确认已经正确设置了JAVA_HOME系统变量。输入ant命令，看到如下输出说明已成功安装了Ant工具： 

Buildfile: build.xml does not exist!
Build failed 


提示信息表明在当前目录不存在build.xml配置文件，但这本身已经说明Ant成功运行了。 

快速入门 

下面用一个最简单也是最经典的例子-HelloWorld来感受一下Ant吧。 

//HelloWorld.java
package com.sharetop.antdemo;
public class HelloWorld {
public static void main( String args[] ) {
System.out.println("Hello world. ");
}
} 


要让Ant编译这个文件，首先需要编写一个Build配置文件。在一般情况下，这个文件被命名为build.xml。 

<?xml version="1.0" encoding="UTF-8" ?>
<project name="HelloWorld" default="run" basedir="." >
<property name="src" value="src"/>
<property name="dest" value="classes"/>
<property name="hello_jar" value="hello.jar" />
<target name="init">
<mkdir dir="${dest}"/>
</target>
<target name="compile" depends="init">
<javac srcdir="${src}" destdir="${dest}"/>
</target>
<target name="build" depends="compile">
<jar jarfile="${hello_jar}" basedir="${dest}"/>
</target>
<target name="run" depends="build">
<java classname="com.sharetop.antdemo.HelloWorld" classpath="${hello_jar}"/>
</target>
</project> 

javac srcdir="src" destdir="classes"
来看一下这个文件的内容，它描述了以下信息：工程的名字为HelloWorld，工程有四个target，分别是init、compil、build和run，缺省是run。compile只有一个任务javac，源文件位于src目录下，输出的类文件要放在classes目录下。build的任务是jar，生成的jar文件为hello.jar，它打包时以classes为根目录。而run则是执行这个HelloWorld类，用hello.jar作为classpath。这四个target之间有一个依赖关系，这种关系用depends来指定。即如果Target A依赖于Target B，那么在执行Target A之前会首先执行Target B。所以从下面运行缺省Target（run）的输出看，这四个Target的执行顺序是：init→compile→build→run。文件目录结构如图1所示。HelloWorld.java文件在src\com\sharetop\antdemo子目录下。 

 
图1 ant_demo应用的目录结构 


在命令行输入命令：ant，然后运行，可以看到如下输出： 

如果配置文件名不是build.xml，比如是build_front.xml，那么，可以使用-buildfile命令参数指定： 

G:\myDoc\ant_demo>ant -buildfile build_front.xml  


也可以单独执行指定的某个target，比如，只编译不打包执行，可以使用下面输入命令即可： 

G:\myDoc\ant_demo>ant compile  

在相应的目录下会找到编译出的HelloWorld.class文件。 

再看看上面的build.xml配置文件，文件开头定义了3个属性，分别指定了源文件输出路径、类文件输出路径和生成的Jar文件名，后面对这些路径的引用都通过一个${property name}来引用。所以，要注意这样一个原则“目录的定义与目录的引用应该分开”。 （未完待续） 

个人心得：
可以在<mkdir dir="${dest}"/>
前面加上<mkdir dir="${src}"/>以生成源文件夹。
手工执行javac srcdir="src" destdir="classes"通不过，
使用javac src\HelloWorld.java -d classes时可以通过，怀疑是ANT内部机制。
classname="com.sharetop.antdemo.HelloWorld"
可以随便改，只要和JAVA源文件的包名一致，在目标文件夹下就可以生成相应的文件夹。如在本例中JAVA文件改为 package com.linlin.HelloWorld,classname="com.linlin.HelloWorld"效果是一样的。