Apache Ant Tasks - Fail

描述

Fail 任务用于通过抛出 BuildException 退出当前构建,可选择打印附加信息。 异常的消息可以通过消息属性或嵌套在元素中的字符数据来设置。


属性

序号 属性 & 描述
1

Message

一条消息,提供有关构建退出原因的更多信息。

2

If

仅当当前项目中存在给定名称的属性时才会失败

3

Unless

仅当当前项目中不存在给定名称的属性时才会失败

4

Status

使用指定的状态码退出; 假设生成的 Exception 没有被捕获,JVM 会以这个状态退出。


用法

示例

使用以下内容创建 build.xml −

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <property name="build.dir" value="build" />
   <target name="info">
      <fail unless="src.dir"/>
   </target>
</project>

由于未设置 src.dir,上述脚本将导致构建失败。


输出

在上述构建文件上运行 Ant 会产生以下输出 −

F:\tutorialspoint\ant>ant
Buildfile: F:\tutorialspoint\ant\build.xml

info:

BUILD FAILED
F:\tutorialspoint\ant\build.xml:5: unless=src.dir

Total time: 0 seconds