启动画面
使用您自己的图形自定义 Android WebView 应用的启动画面。
通过在 Config.java 中配置以下变量来自定义启动屏行为:
选项
类型
说明
SPLASH_SCREEN_ACTIVATED
true 或 false
设置为 true 以启用启动屏
SPLASH_TIMEOUT
数字(毫秒)
如果主页 URL 仍在加载,则在显示加载指示器之前的延迟时间
REMAIN_SPLASH_OPTION
true 或 false
为 true 时,保持启动屏可见,直到主页 URL 完全加载完成(会覆盖
SPLASH_TIMEOUT)SPLASH_MIN_TIME
数字(毫秒)
当
REMAIN_SPLASH_OPTION 为 true 时的最短显示时长;如果实际加载时间超过此值,则忽略此设置SPLASH_FADE_OUT
数字(毫秒)
所有计时器结束后的淡出动画时长;设置为 0 可禁用淡出效果
SCALE_SPLASH_IMAGE
百分比 [0–100]
相对于设备最小尺寸缩放启动屏图片;0 表示隐藏图片
替换启动屏图片
- 用您自己的方形 GIF(例如 128×128、512×512 或 1024×1024 px)替换 assets 中的
splash.gif - 确保图片尺寸相等(宽 = 高)以获得最佳显示效果
- 在
colors.xml中设置背景颜色
下方视频展示了为您的 Android 应用添加自定义启动屏的步骤:
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 Android 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for Android 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 Android 用户提供原生应用外壳。