SuperAPI AI 工具集

tauri-app-splashscreen

编程与开发

查看项目

更新于 10-16 07:53

技能介绍

用途

该技能用于在 Tauri v2 应用中配置启动画面(splashscreen)窗口,在应用初始化期间显示加载动画或 Logo,从而避免启动时出现白屏闪烁。当用户提到启动画面、加载屏幕、白屏、启动屏幕等需求时使用。

主要能力

  • 在 tauri.conf.json 中配置 splashscreen 窗口与主窗口
  • 提供从 Rust 侧关闭启动画面并显示主窗口的命令
  • 提供前端初始化完成后触发切换的调用方式
  • 处理前端加载缓慢的情况:保持启动画面可见,直到前端发出就绪信号
  • 设置超时兜底,即使初始化卡住也能关闭启动画面,防止界面卡死

使用方式

  1. 在 tauri.conf.json 中配置启动画面窗口:
{
  "app": {
    "windows": [
      { "label": "splashscreen", "url": "splashscreen.html", "width": 400, "height": 300, "decorations": false, "center": true },
      { "label": "main", "url": "/", "visible": false }
    ]
  }
}
  1. 创建 splashscreen HTML 文件(例如 splashscreen.html),放入加载动画或 Logo。

  2. 在应用就绪时,从 Rust 关闭启动画面并显示主窗口:

#[tauri::command]
async fn close_splashscreen(app: tauri::AppHandle) {
    if let Some(splash) = app.get_webview_window("splashscreen") { splash.close().unwrap(); }
    if let Some(main) = app.get_webview_window("main") { main.show().unwrap(); }
}
  1. 前端初始化完成后触发:
import { invoke } from '@tauri-apps/api/core';
await invoke('close_splashscreen');
  1. 对于前端加载缓慢的情况,保持启动画面可见,直到前端发出就绪信号。

  2. 设置超时,即使初始化卡住也能关闭启动画面,防止界面卡死。

输出

  • tauri.conf.json 中的启动画面窗口配置
  • 从启动画面切换到主窗口的 Rust 命令
  • 针对初始化卡死的超时兜底方案

适用场景

  • 需要在 Tauri v2 桌面应用启动阶段展示加载界面的场景
  • 希望避免启动白屏闪烁、提升启动体验的场景

限制

资料未提供关于收费、价格、平台兼容性范围、性能效果等方面的具体信息,暂未提供。