Ant - 构建文件



通常,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 有三个属性,如下所示:

序号 属性及描述
1

name

项目的名称。(可选)

2

default

构建脚本的默认目标。一个项目可能包含任意数量的目标。此属性指定哪个目标应被视为默认目标。(必填)

3

basedir

项目的基目录(或)根文件夹。(可选)

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

目标可以依赖于其他目标。例如,一个deploy目标可能依赖于package目标,package目标可能依赖于compile目标,依此类推。依赖关系使用depends属性表示。

例如:

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

target 元素具有以下属性:

序号 属性及描述
1

name

目标的名称(必填)

2

depends

此目标依赖的所有目标的逗号分隔列表。(可选)

3

description

目标的简短描述。(可选)

4

if

允许根据条件属性的真假执行目标。(可选)

5

unless

将目标添加到指定扩展点的依赖列表中。扩展点类似于目标,但它没有任何任务。(可选)

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

要运行 ant 构建文件,请打开命令提示符并导航到 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:\>
广告