失败

描述

退出当前构建（仅抛出 BuildException），可以选择性地打印其他信息。

异常消息可以通过 message 属性或嵌套在元素中的字符数据设置。

参数

属性 描述 必填
message 提供有关构建退出原因的更多信息的 message 否
if 仅在当前项目中 存在给定名称的属性 时才失败 否
unless 仅在当前项目中 不存在给定名称的属性 时才失败 否
status 使用指定的退出代码退出；假设生成的异常未被捕获，JVM 将使用此状态退出。自 Apache Ant 1.6.2 起 否

指定为嵌套元素的参数

作为 if/unless 属性的替代方案，可以使用单个嵌套的 <condition> 元素来实现条件失败，该元素应包含一个核心条件或自定义条件。有关条件的信息，请参见 此处。
自 Ant 1.6.2 起

示例

退出当前构建，不提供其他信息。

<fail/>
BUILD FAILED

build.xml:4: No message

退出当前构建并将消息打印到您的输出位置

<fail message="Something wrong here."/>
BUILD FAILED

build.xml:4: Something wrong here.

实现与上述相同结果的不同方法。

<fail>Something wrong here.</fail>

退出当前构建并将解释打印到您的输出位置

<fail unless="thisdoesnotexist"/>
BUILD FAILED

build.xml:2: unless=thisdoesnotexist

使用条件来实现相同的效果

<fail>
    <condition>
        <not>
            <isset property="thisdoesnotexist"/>
        </not>
    </condition>
</fail>
BUILD FAILED

build.xml:2: condition satisfied

检查文件 one.txt 和 two.txt 是否都存在，否则构建将失败。

<fail message="Files are missing.">
    <condition>
        <not>
            <resourcecount count="2">
                <fileset id="fs" dir="." includes="one.txt,two.txt"/>
            </resourcecount>
        </not>
    </condition>
</fail>