SuperAPI AI 工具集

adding-tauri-splashscreen

编程与开发

查看项目

更新于 10-15 20:21

技能介绍

用途:为 Tauri v2 应用添加启动画面,在主窗口加载与初始化期间显示加载界面。

主要能力:在 tauri.conf.json 中配置 splashscreen 与 main 两个窗口,主窗口设 visible: false 隐藏,启动窗口可设 decorations: false、transparent: true、alwaysOnTop: true、center: true;提供 splashscreen.html 示例(含加载动画、进度条、深色发光等样式变体);前端通过 @tauri-apps/api 的 invoke 调用后端命令;后端用 Rust 维护 SetupState,前端与后端任务均完成后关闭启动窗口并显示、聚焦主窗口。

使用方式:前端在 DOMContentLoaded 或 tauri://created 事件中执行初始化并 invoke('set_complete', { task: 'frontend' });后端需 cargo add tokio --features time,在 setup 中用 tauri::async_runtime::spawn 执行初始化,完成后调用 set_complete。简单场景可只用 close_splashscreen 命令。

限制与注意:异步 Rust 中必须用 tokio::time::sleep,不可用 std::thread::sleep;窗口 label 需与配置一致;初始化失败也应显示主窗口并呈现错误状态;启动画面建议保持 1-3 秒;透明窗口需在 html 与 body 设 background: transparent;移动端启动画面机制不同,建议使用平台原生方案。常见问题包括 URL 路径错误、主窗口过早显示、透明背景失效与窗口定位,可按资料中的排查项检查。