此任务用于停止当前构建并抛出BuildException
。它从当前构建退出并向控制台显示异常消息。
message
属性用于为此元素设置异常消息。
属性 | 描述 | 必需 |
---|---|---|
message |
显示失败原因的消息 | 否 |
if |
仅当当前目录中存在属性时才会失败 | 否 |
unless |
仅在当前项目中不存在属性时才会失败 | 否 |
下面来看一下Ant Fail Task的一些例子,如下所示。
无消息
<project name="fail-project-example" default="fail"> <target name="fail"> <fail/> </target> </project>
设置消息
<project name="fail-project-example" default="fail"> <target name="fail"> <fail message="something went wrong"/> </target> </project>
使用unless
<project name="fail-project-example" default="fail"> <target name="fail"> <fail unless="it is unless message"/> </target> </project>
输出结果为:
fail: BUILD FAILED unless=it is unless message