Ant生成一个简单的Java项目

编译源代码

由于 Ant 的主要目标是生成 Java 应用程序，它能够内在地、出色地支持调用 javac 编译器以及其他 Java 相关任务就毫不奇怪了。下面是编译 Java 代码的任务的编写方式：

<javac srcdir="src"/>

这个标签寻找 src 目录中以 .java 为扩展名的所有文件，并对它们调用 javac 编译器，从而在相同的目录中生成类文件。当然，将类文件放在一个单独的目录结构中通常会更清晰；可以通过添加distdir 属性来让 Ant 做到这点。其他有用的属性包括：

· classpath：等价于 javac 的 -classpath 选项。

· debug="true"：指示编译器应该带调试信息编译源文件。

javac 任务的一个重要特点在于，它仅编译那些它认为需要编译的源文件。如果某个类文件已经存在，并且对应的源文件自从该类文件生成以来还没有改变过，那么该源文件就不会被重新编译。javac任务的输出显示了实际被编译的源文件的数目。编写一个 clean 目标来从目标目录移除生成的任何类文件是个很好的习惯。如果想要确保所有源文件都已编译，就可以使用这个任务。这种行为刻画了 Ant 的许多任务的特点：如果某个任务能够确定所请求的操作不需要执行，那么该操作就会被跳过。

像 Ant 一样，javac 编译器本身也是用 Java 语言实现的。这对 Ant 中的 javac 任务的使用来说非常有利，因为它通常调用 Ant 运行所在的相同 Java 虚拟机（JVM）中的编译器类。在每次需要编译 Java 代码时，其他生成工具通常需要运行一个新的 javac 进程，从而需要一个新的 JVM 实例。但是在使用 Ant 的情况下，只需要单个 JVM 实例，它既用于运行 Ant 本身，也用于执行所有必需的编译任务（以及其他相关任务，比如处理 JAR 文件）。这是一种高效得多的资源使用方式，能够极大地缩短项目生成时间。

编译器选项

正如我们从前一小节看到的，Ant 的 javac 任务的默认行为是调用运行 Ant 本身的任何 JVM 的标准编译器。然而，有时您可能想要单独地调用编译器 —— 例如当你希望指定编译器的某些内存选项，或者需要使用一种不同级别的编译器的时候。为实现这个目的，只需将 javac 的 fork 属性设

置为 true，比如像下面这样：

<javac srcdir="src" fork="true"/>

如果想要指定一个不同的 javac 可执行文件，并向它传递一个最大内存设置，您可以像下面这样做：

<javac srcdir="src" fork="true" executable="/home/zhujia/jdk1.6.0_21/bin/javac"

memoryMaximumSize="128m"/>

甚至可以将 Ant 配置为使用某种不同的编译器。受支持的编译器包括开放源代码的 Jikes 编译器和来自 GNU 编译器集（GNU Compiler Collection，GCC）的 GCI 编译器。（请参阅参考资料以了解关于这两种编译器的更多信息。）可以通过两种方式指定这些编译器：可以设置 build.compiler属性，这将应用于使用 javac 任务的所有场合；或根据需要设置每个javac 任务中的 compiler 属性。

javac 任务还支持其他许多选项。请参考 Ant 手册以了解更多细节（请参阅参考资料）。

创建 JAR 文件

在编译 Java 源文件之后，结果类文件通常被打包到一个 JAR 文件中，这个文件类似 zip 归档文件。每个 JAR 文件都包含一个清单文件，它可以指定该 JAR 文件的属性。

下面是 Ant 中 jar 任务的一个简单使用例子：

<jar distfile="package.jar" basedir="classes"/>

这将创建一个名为 package.jar 的 JAR 文件，并把 classes 目录中的所有文件添加到其中（JAR文件能够包含任意类型的文件，而不只是类文件）。此处没有指定清单文件，因此 Ant 将提供一个基本的清单文件。

manifest 属性允许指定一个用作该 JAR 文件的清单的文件。清单文件的内容还可以使用 manifest任务在生成文件中指定。这个任务能够像文件系统写入一个清单文件，或者能够实际嵌套在 jar 之内，以便一次性地创建清单文件和 JAR 文件。例如：

<jar distfile="package.jar" basedir="classes">

<manifest>

<attribute name="Built-By" value="${user.name}"/>

<attribute name="Main-class" value="package.Main"/>

</manifest>

</jar>

时间戳生成

在生成环境中使用当前时间和日期，以某种方式标记某个生成任务的输出，以便记录它是何时生成的，这经常是可取的。这可能涉及编辑一个文件，以便插入一个字符串来指定日期和时间，或将这个信息合并到 JAR 或 zip 文件的文件名中。

这种需要是通过简单但是非常有用的 tstamp 任务来解决的。这个任务通常在某次生成过程开始时调用，比如在一个 init 目标中。这个任务不需要属性，许多情况下只需 <tstamp/> 就足够了。tstamp 不产生任何输出；相反，它根据当前系统时间和日期设置 Ant 属性。下面是 tstamp 设置的一些属性、对每个属性的说明，以及这些属性可被设置到的值的例子：

属性	说明	例子
DSTAMP	设置为当前日期，默认格式为yyyymmdd	20031217
TSTAMP	设置为当前时间，默认格式为 hhmm	1603
TODAY	设置为当前日期，带完整的月份	2003 年 12 月 17 日

例如，在前一小节中，我们按如下方式创建了一个 JAR 文件：

<jar distfile="package.jar" basedir="classes"/>

在调用 tstamp 任务之后，我们能够根据日期命名该 JAR 文件，如下所示：

<jar distfile="package-${DSTAMP}.jar" basedir="classes"/>

因此，如果这个任务在 2003 年 12 月 17 日调用，该 JAR 文件将被命名为

package-20031217.jar。

还可以配置 tstamp 任务来设置不同的属性，应用一个当前时间之前或之后的时间偏移，或以不同的方式格式化该字符串。所有这些都是使用一个嵌套的 format 元素来完成的，如下所示：

<tstamp>

<format property="OFFSET_TIME"

pattern="HH:mm:ss"

offset="10" unit="minute"/>

</tstamp>

上面的清单将 OFFSET_TIME 属性设置为距离当前时间 10 分钟之后的小时数、分钟数和秒数。

用于定义格式字符串的字符与 java.text.SimpleDateFormat 类所定义的那些格式字符相同。

综合

下面是一个build.xml文件实例，它将编译 src 目录下的所有源代码，将结果类文件放在 build 目录下，然后把所有类文件打包到 dist 目录中的一个 JAR 文件中。要自己试验这个生成文件，您所需要的就是包含一个或多个 Java 源代码文件的 src 目录 —— 这个目录可以包含从简单的“Hell World”程序到来自某个现有项目的大量源文件的任何内容。如果需要向 Java classpath 添加 JAR 文件或其他任何内容，以便成功地编译源代码，您只需在 javac 任务中为其添加一个 classpath 属性。

该生成文件看起来如下：

<?xml version="1.0"?>

<project default="dist" name="Project Argon">

<description>A simple Java project</description>

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

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

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

<target name="init">

<tstamp/>

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

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

</target>

<target name="compile" depends="init">

<javac srcdir="${srcDir}" distdir="${buildDir}"/>

</target>

<target name="dist" depends="compile">

<jar distfile="${distDir}/package-${DSTAMP}.jar" basedir="${buildDir}">

<manifest>

<attribute name="Built-By" value="${user.name}"/>

<attribute name="Main-Class" value="package.Main"/>

</manifest>

</jar>

<jar distfile="${distDir}/package-src-${DSTAMP}.jar" basedir="${srcDir}"/>

</target>

<target name="clean">

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

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

</target>

</project>

下面是使用该文件执行的某次生成过程的示例输出（您得到的输出可能不一样，具体取决于 src 目录的内容）：

Buildfile: build.xml

init:

[echo] ant version: Apache Ant version 1.7.1 compiled on September 8 2010

[mkdir] Created dir: /home/zhujia/Developer/workspace/I18N_ANT/bin

[mkdir] Created dir: /home/zhujia/Developer/workspace/I18N_ANT/dist

build:

[javac] Compiling 1 source file to /home/zhujia/Developer/workspace/I18N_ANT/bin

dist:

[jar] Building jar: /home/zhujia/Developer/workspace/I18N_ANT/dist/I18N-20101005.jar

[jar] Building jar: /home/zhujia/Developer/workspace/I18N_ANT/dist/I18N-src-20101005.jar

BUILD SUCCESSFUL

Total time: 1 second

注意 JAR 文件是根据当前日期来命名的，并且为应用程序的主类设置了一个清单条目，以便主类能够通过一个简单的命令 java -jar package-20031217.jar 来直接运行。我们还创建了一个 JAR 文件，它仅包含项目的源代码。