Ant - build 文件
通常,名为 build.xml 的 Ant 构建文件应该驻留在项目的基本目录中。 但是,对文件名或其位置没有限制。 您可以随意使用其他文件名或将构建文件保存在其他位置。
对于本练习,请在计算机的任何位置创建一个名为 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 构建脚本的默认 target 。 一个项目可能包含任意数量的 target 。 此属性指定应将哪个 target 视为默认 target 。 (强制的) |
3 | basedir 项目的基目录(或)根文件夹。 (可选的) |
target 是您希望作为一个单元运行的任务的集合。 在我们的示例中,我们有一个简单的 target 来向用户提供信息性消息。
target 可以依赖于其他 target 。 例如,deploy target 可能依赖于包 target ,package target 可能依赖于编译 target 等等。 使用 depends 属性表示依赖关系。
For example −
< target name="deploy" depends="package"> .... </ target > < target name="package" depends="clean,compile"> .... </ target > < target name="clean" > .... </ target > < target name="compile" > .... </ target >
target target 元素具有以下属性 −
序号 | 属性 & 描述 |
---|---|
1 | name target 名称(必填) |
2 | depends 此 target 所依赖的所有 target 的逗号分隔列表。 (可选的) |
3 | description target 的简短描述。 (可选的) |
4 | if 允许基于条件属性的真实性执行 target 。 (可选的) |
5 | unless 将 target 添加到指定扩展点的依赖列表中。 扩展点类似于 target ,但它没有任何任务。 (可选的) |
上例中的 echo 任务是一个打印消息的简单任务。 在我们的示例中,它打印消息 Hello World。
要运行 ant 构建文件,请打开命令提示符并导航到 build.xml 所在的文件夹,然后键入 ant info。您也可以改为键入 ant。 两者都可以工作,因为 info 是构建文件中的默认 target 。
您应该看到以下输出 −
C:\>ant Buildfile: C:\build.xml info: [echo] Hello World - Welcome to Apache Ant! BUILD SUCCESSFUL Total time: 0 seconds C:\>