此任務用於停止當前構建並丟擲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