通常,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构建时会出现以下错误消息 -
不允许匹配"[xX] [mM] [lL]"的处理指令目标。
所有构建文件都需要项目元素和至少一个目标元素。
XML元素项目有三个属性 :
Sr.No。 | 属性&说明 |
---|---|
1 | name 项目名称。 (可选) |
2 | default 构建脚本的默认目标。项目可能包含任意数量的目标。此属性指定应将哪个目标视为默认目标。 (必填) |
3 | basedir 基础目录(或)项目的根文件夹。 (可选) |
目标是您希望作为一个单元运行的任务集合。在我们的示例中,我们有一个简单的目标来向用户提供信息性消息。
目标可以依赖于其他目标。例如, deploy 目标可能依赖于包目标,包目标可能依赖于编译目标等等。依赖关系使用 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 将目标添加到指定扩展点的依赖关系列表中。扩展点类似于目标,但它没有任何任务。 (可选) |
上例中的 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:\>