SuperAPI AI 工具集

tauri-core-runtime

编程与开发

查看项目

更新于 10-15 22:18

技能介绍

用途:面向 Tauri 2.x 应用的核心运行时配置,覆盖应用初始化、setup 钩子、后台任务派生与生命周期管理,防止 Builder 链配置错误。

主要能力:整理 Builder 方法(default、setup、invoke_handler、manage、plugin、menu、on_window_event、on_menu_event、on_webview_event、on_page_load、on_tray_icon_event、any_thread、build、run);Manager trait 方法(app_handle、state、try_state、manage、get_webview_window、webview_windows、get_window、get_focused_window、config、path、package_info);AppHandle 属性(Clone、Send + Sync、实现 Manager/Emitter/Listener)。

使用方式:标准入口在 lib.rs 用 #[cfg_attr(mobile, tauri::mobile_entry_point)] 标注 run(),链式调用 manage、plugin、invoke_handler、setup 后 .run(tauri::generate_context!())。setup 钩子在窗口显示前运行,返回 Result,错误会中止启动。后台任务用 app.handle().clone() 后移入线程或 tokio 任务。异步命令自动运行在 tokio 运行时,同步阻塞操作可用 #[tauri::command(async)]。退出用 app.exit(0),重启用 app.restart()(需 tauri-plugin-process)。

适用场景:桌面与移动端 Tauri 应用初始化、托盘常驻、窗口事件处理、后台心跳与异步 I/O。

限制与警告:invoke_handler 只能调用一次,所有命令放入单个 generate_handler![];不要用 Arc 包装托管状态;状态包装类型不匹配会导致运行时 panic;重 I/O 不应在 setup 中同步执行。