Build 文件
通常,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.
所有构建文件都需要project元素和至少一个target元素。
XML元素project有三个属性 -
Sr.No. | 属性和描述 |
---|---|
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>
目标元素具有以下属性 -
Sr.No. | 属性和描述 |
---|---|
1 | name 目标名称(必填) |
2 | depends 以逗号分隔的目标所依赖的所有目标的列表。 (可选的) |
3 | description 目标的简短描述。 (可选的) |
4 | if 允许基于条件属性的真实性执行目标。 (可选的) |
5 | unless 将目标添加到指定Extension Point的依赖项列表中。 扩展点类似于目标,但它没有任何任务。 (可选的) |
上例中的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:\>