Splash

作者 Les Hughes (leslie.hughes@rubus.com)

說明

此任務會建立一個開機畫面。開機畫面會在建置期間顯示,並包含一個進度條。搭配 sound 任務使用,讓你在等待建置完成時不會無聊...

參數

屬性 說明 必要
imageurl 指向要顯示影像的 URL。 否;預設為類別路徑中的 antlogo.gif
showduration 暫停建置以顯示開機畫面的初始時間(毫秒)。 否;預設為 5000
progressregexp 用於剖析輸出並找出目前進度的進度正規表示式。必須只有一個群組模式,且它代表進度數字 (0-100)(例如 Progress: (.*)%
自 Apache Ant 1.8.0
否;預設為每個動作和記錄的輸出列都會增加進度
displaytext 顯示在開機畫面視窗中的顯示文字
自 Ant 1.8.0
否;預設為 Building ...

已棄用的屬性

下列屬性可用於設定代理設定,以便從防火牆後方擷取影像。不過,這些設定不只套用於此任務,也套用於所有後續任務。因此,它們現在已棄用,建議改用 <setproxy> 任務,讓建置的讀者清楚了解正在進行的動作。

屬性 說明 必要
useproxy 使用代理存取 imgurl
proxy 代理伺服器的 IP 或主機名稱
port 代理埠號
user 用於向代理驗證身分的使用者
password 代理密碼

範例

Splash images/ant_logo_large.gif 從類別路徑。

<splash/>

Splash Jakarta 標誌,初始時間為 5 秒。

<splash imageurl="https://jakarta.apache.org/images/jakarta-logo.gif"
        useproxy="true"
        showduration="5000"/>

Splash 搭配受控進度和非預設文字

<target name="test_new_features">
    <echo>New features</echo>
    <splash progressRegExp="Progress: (.*)%" showduration="0" displayText="Test text"/>
    <sleep seconds="1"/>
    <echo>Progress: 10%</echo>
    <sleep seconds="1"/>
    <echo>Progress: 20%</echo>
    <sleep seconds="1"/>
    <echo>Progress: 50%</echo>
    <sleep seconds="1"/>
    <echo>Progress: 70%</echo>
    <sleep seconds="1"/>
    <echo>Progress: 100%</echo>
    <sleep seconds="3"/>
</target>