失敗

說明

退出目前的建置（僅拋出 BuildException），選擇性地列印其他資訊。

例外狀況的訊息可透過訊息屬性或巢狀到元素中的字元資料設定。

參數

屬性 說明 必要
訊息 訊息提供建置退出的更多資訊 否
如果 僅當目前專案中存在指定名稱的屬性時才會失敗 否
除非 僅當目前專案中不存在指定名稱的屬性時才會失敗 否
狀態 使用指定的狀態碼退出；假設產生的例外狀況未被捕捉，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>