此任務(wù)用于停止當(dāng)前構(gòu)建并拋出BuildException。它從當(dāng)前構(gòu)建退出并向控制臺顯示異常消息。
message屬性用于為此元素設(shè)置異常消息。
| 屬性 | 描述 | 必需 |
|---|---|---|
message |
顯示失敗原因的消息 | 否 |
if |
僅當(dāng)當(dāng)前目錄中存在屬性時才會失敗 | 否 |
unless |
僅在當(dāng)前項(xiàng)目中不存在屬性時才會失敗 | 否 |
下面來看一下Ant Fail Task的一些例子,如下所示。
無消息
<project name="fail-project-example" default="fail">
<target name="fail">
<fail/>
</target>
</project>
設(shè)置消息
<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>
輸出結(jié)果為:
fail:
BUILD FAILED
unless=it is unless message