用途:面向 Tauri 2.x 应用开发,帮助理解其核心架构与组件模型,避免沿用 Tauri 1.x 的架构假设。
主要能力:梳理架构分层(Rust 后端、平台原生 Webview、IPC 桥、插件系统、权限系统);列出各平台 Webview 引擎(Windows 用 WebView2、macOS/iOS 用 WKWebView、Linux 用 WebKitGTK、Android 用 Android WebView);说明关键依赖(@tauri-apps/cli、@tauri-apps/api、tauri、tauri-build、serde/serde_json);描述双进程模型与 IPC 桥的 JSON 消息、事件与 Channel 流式通信;给出标准项目结构、入口点模式(lib.rs + main.rs 拆分)、类型层级(App、AppHandle、WebviewWindow、Window、Webview、State、Builder)以及 Manager、Emitter、Listener 三个 trait 的方法;还包含 Builder 配置方式与前端 API 概览。
使用方式:按资料中的项目结构与入口点模式组织代码;命令统一放入单个 generate_handler![];异步命令参数用 String;状态注册与访问类型需一致。
限制与警告:不要在命令中用同步 I/O 阻塞主线程;invoke_handler 只能调用一次;lib.rs 中直接定义的命令不要标记 pub;不要用 Arc 包裹托管状态;异步命令参数不要用 &str;注册 Mutex<T> 时须用 State<'_, Mutex<T>>。Cargo.lock 应提交,target/ 应忽略,gen/ 不可手动编辑。具体版本兼容与平台细节以官方文档为准。