Splash

作者:Les Hughes ([email protected])

描述

此任务创建一个启动画面。启动画面在构建期间显示,并包含一个方便的进度条。与sound任务结合使用,在等待构建完成时提供趣味性...

参数

属性 描述 必需
imageurl 指向要显示的图像的 URL。 否;默认值为类路径中的 antlogo.gif
showduration 初始暂停构建以显示启动画面的时间(以毫秒为单位)。 否;默认值为 5000
progressregexp 用于解析输出并提取当前进度的进度正则表达式。必须存在一个组模式,它表示进度编号(0-100)(例如 进度:(.*)%)。
自 Apache Ant 1.8.0 起
否;默认值为每个操作和记录的输出行都会增加进度
displaytext 在启动画面窗口中显示的文本
自 Ant 1.8.0 起
否;默认值为 正在构建...

已弃用的属性

以下属性可用于配置代理设置,以从防火墙后面检索图像。但是,这些设置不仅适用于此任务,还适用于所有后续任务。因此,它们现在已弃用,优先使用<setproxy>任务,该任务清楚地向构建阅读者说明了正在发生的事情。

属性 描述 必需
useproxy 使用代理访问 imgurl
proxy 代理服务器的 IP 或主机名
port 代理端口号
user 用于向代理进行身份验证的用户
password 代理密码

示例

从类路径中显示 images/ant_logo_large.gif

<splash/>

显示 Jakarta 徽标,初始时间为 5 秒。

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

使用受控进度和非默认文本显示启动画面

<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>