Ant 简明教程

Ant - Build Files

通常，Ant 构建文件名为 build.xml ，它应当放在项目的基本目录中。然而，对文件名或它的位置没有限制。您可以自由地使用其它文件名或将构建文件保存在其它位置。

为了进行这个练习，在计算机中任意位置创建一个名为 build.xml 的文件，它的内容如下：

<?xml version="1.0"?>
   <project name="Hello World Project" default="info">
   <target name="info">
      <echo>Hello World - Welcome to Apache Ant!</echo>
   </target>
</project>

请注意，xml 声明之前不应有空行或空格。如果您允许空行或空格，那么在执行 ant 构建时，会导致以下错误信息：

The processing instruction target matching "[xX][mM][lL]" is not allowed.
All build files require the project element and at least one target element.

XML 元素 project 有三个属性，如下：

Sr.No

Attributes & Description

name 项目名称。（可选）

default 构建脚本的默认目标。一个项目可以包含任何数量的目标。此属性指定应该视为默认值的目标。（强制）

basedir 基本目录（或）项目的根文件夹。（可选）

目标是您要作为一个单元运行的任务集合。在我们的示例中，我们有一个简单的目标，为用户提供信息消息。

目标可以依赖于其他目标。例如， deploy 目标可能依赖于程序包目标， package 目标可能依赖于编译目标，依此类推。依赖项使用 depends 属性表示。

例如 -

<target name="deploy" depends="package">

   ....
</target>
<target name="package" depends="clean,compile">
   ....
</target>
<target name="clean" >
   ....
</target>
<target name="compile" >
   ....
</target>

目标元素具有以下属性：

Sr.No	Attributes & Description
1	name 目标的名称（必需）
2	depends 此目标所依赖的所有目标的逗号分隔列表。（可选）
3	description 目标的简要说明。（可选）
4	if 允许基于条件属性的真实性执行目标。（可选）
5	unless 将目标添加到指定的扩展点的依赖项列表中。扩展点类似于目标，但它没有任何任务。（可选）

上述示例中的 echo 任务是一个打印消息的简单任务。在我们的示例中，它打印消息 Hello World 。

要运行蚂蚁构建文件，请打开命令提示符并导航到 build.xml 所在的文件夹，然后键入 ant info 。你也可以键入 ant 。两者都会起作用，因为 info 是构建文件中的默认目标。

你应该看到以下输出：

C:\>ant
Buildfile: C:\build.xml

info: [echo] Hello World - Welcome to Apache Ant!

BUILD SUCCESSFUL
Total time: 0 seconds

C:\>