构建第一个Ant应用

        通过上篇对Ant介绍想必大家对Ant有了一定的认识，接下来我们通过构建一个简单的项目来深入学习Ant的机制及原理。

 

        1.我们新建一个Java项目，命名为"HelloAnt"，在项目中新建类HelloAnt，包名为com.ant.hello，如下所示：

 

        2.为HelloAnt.java编写代码：

package com.ant.hello;

public class HelloAnt {
    
    public static void main(String[] args){
        System.out.println("Hello Ant!");
    }
    
}

 
        3.打开项目所在目录，我们会看到以下目录结构：

        项目已经弄好了，开始Ant构建之前，首先要编写Ant构建文件。构建文件定义了构建的流程，Ant构建文件默认命名为build.xml，也可以是其他名称，只不过在运行的时候把这个自定义名称当作参数传给Ant。构建文件可以放在任何的位置，一般做法是放在项目根目录或指定目录中，这样可以保持项目的简洁和清晰。
        下面是一个典型的项目层次结构：
            (1) src存放源文件。 
            (2) classes存放编译后的class文件。 
            (3) lib存放依赖Jar包。 
            (4) dist存放打包，发布以后的发布包文件（war,jar等）。

            (5) doc存放文档

            (6) web存放页面
        Ant构建文件是XML文件，每个构建文件定义一个唯一的项目(Project元素)；每个项目下可以定义很多目标(target元素)；这些目标之间可以有依赖关系(depends属性)，当执行这类目标时，需要执行他们所依赖的目标。每个目标中可以定义多个任务，目标中还定义了所要执行的任务序列。Ant在构建目标时必须调用所定义的任务，任务定义了Ant实际执行的命令。
        Ant中的任务定义为3类： 
            (1) 核心任务。核心任务是Ant自带的任务，如java，javc，jar等等。 
            (2) 可选任务。可选任务实来自第三方的任务，因此需要一个附加的Jar文件。 
            (3) 用户自定义的任务。用户自定义的任务实用户自己开发的任务。

 

        4.开始编写我们的build.xml文件，其实在Ant的事例项目中已经有类似的构建文件，感兴趣的可以看看，下面是我们这个项目的build.xml文件内容： 

<?xml version="1.0" encoding="UTF-8" ?>

<!--  工程名：HelloAnt 默认开始target：run 所在目录：本目录 -->
<project name="HelloAnt" default="run">

	<!-- 源文件目录 -->
	<property name="src" value="src" />
	<!-- 类编译后输出目录 -->
	<property name="dest" value="classes" />
	<!-- 打包后输出目录 -->
	<property name="dist" value="dist" />
	<!-- 输出的jar文件 -->
	<property name="hello_jar" value="hello.jar" />

	<!--  初始化目标 -->
	<target name="init" depends="clean">
		<mkdir dir="${dest}" />
		<mkdir dir="${dist}" />
	</target>

	<!--  project声明的默认开始目标 -->
	<target name="run" depends="jar">
		<description>这里可以添加其他动作</description>
	</target>

	<!--  编译class文件 -->
	<target name="compile" depends="init">
		<javac srcdir="${src}" destdir="${dest}" includeantruntime="true" />
	</target>

	<!--  打包成jar -->
	<target name="jar" depends="compile">
		<jar destfile="${dist}/${hello_jar}" filesetmanifest="mergewithoutmain">
			<manifest>
				<attribute name="Built-By" value="${user.name}" />
				<attribute name="Main-Class" value="com.ant.hello.HelloAnt" />
				<attribute name="Class-Path" value="." />
			</manifest>
			<fileset dir="${dest}" />
		</jar>
	</target>

	<!--  清除编译痕迹 -->
	<target name="clean">
		<delete dir="${dest}" />
		<delete dir="${dist}" />
	</target>

	<!--  返回 -->
	<target name="rebuild" depends="clean, run">
		<ant target="clean" />
		<ant target="run" />
	</target>

</project>

 

        通过对标签的了解我们可以很清楚的知道每一个target的目标是什么，如：init是创建输出文件夹；compile是编译源文件等等。

        从他们的依赖关系我们可以很容易的理清target之间的序列关系，当启动HelloAnt这个构建project时，默认首先调用名为"run"的target，而run 的依赖是名为"jar"的target，这样在run执行前就需要运行jar这个target，同理向上推出最先执行的target，最终得出的序列顺序为：init-->compile-->jar-->run。

        我们看到在build.xml文件尾部还有一个名为"rebuild"的target，这个也很好理解，当我们默认执行"ant"命令时，Ant会默认调用project的default目标，但当我们为Ant指定target时，Ant会从指定的target开始构建，就如下列输入：

ant rebuild

        如果项目目录中出现我们指定的文件及文件结构说明我们构建成功了！

        当我们的项目比较简单时我们还可以自己去写build.xml，一旦项目非常庞大及复杂，我们肯定无法很轻松的完成构建文件，下几篇就学习一下利用插件等工具实现自动构建。