用途
Tauri v2+ 开发技能用于构建跨平台桌面和移动应用:前端使用 Web 技术,后端使用 Rust。该技能声称可预防 8+ 常见错误并节省约 60% token。技能说明适用于配置 tauri.conf.json、实现 Rust 命令(#[tauri::command])以及相关设置。
主要能力
- 提供 Rust 命令的创建与前端调用方式,使用 @tauri-apps/api/core 的 invoke。
- 说明 Tauri v2 的权限模型:默认拒绝一切操作,需在 capabilities/default.json 中显式声明权限(如 core:default)。
- 强调命令必须注册到 tauri::generate_handler![...],否则前端调用会静默失败。
- 说明 main.rs 应保持为薄透传,所有应用逻辑放在 lib.rs,并使用 #[cfg_attr(mobile, tauri::mobile_entry_point)] 以兼容移动端。
- 提供配置示例(tauri.conf.json、Cargo.toml、项目结构)以及关键设置说明。
- 涵盖常见模式:错误处理(Result<T, E> + thiserror)、Serde 边界规则、状态管理(Mutex<T> + State)、事件发射(Emitter)、Channel 流式传输、窗口访问(WebviewWindow、get_webview_window)。
- 列出常见问题及其根因与解决办法,例如“Command not found”“Permission denied”、插件功能静默失败、更新器在生产环境失败、Sidecar 找不到、移动端构建失败等。
- 提供发布与分发相关的参考主题:安全与权限、IPC 决策指南、官方插件、更新器与分发、托盘/边车/深链接等。
使用方式
- 创建 Tauri 命令:在 src-tauri/src/lib.rs 中定义带 #[tauri::command] 的函数,并在 run() 中通过 tauri::Builder::default().invoke_handler(tauri::generate_handler![greet]) 注册。
- 前端调用:使用 import { invoke } from '@tauri-apps/api/core',注意不要使用 v1 的 @tauri-apps/api/tauri。
- 添加权限:在 src-tauri/capabilities/default.json 中配置 identifier、windows 与 permissions(至少 core:default)。
- 遵循关键规则:命令始终注册到 generate_handler![];命令返回 Result<T, E>;使用 Mutex<T> 管理共享状态;使用任何插件功能前先添加对应权限;共享代码放在 lib.rs;异步命令使用拥有所有权的类型。
- 处理状态、事件、Channel 与窗口访问时参考文中给出的代码模式。
适用场景
- 需要以 Web 前端 + Rust 后端构建跨平台桌面或移动应用的开发者。
- 需要预防 Tauri v2 常见错误(权限、IPC 注册、状态类型不匹配、移动端构建、白屏等)的项目。
- 需要参考官方插件安装、注册与权限字符串的场景。
- 需要处理更新器与分发、托盘、Sidecar、深链接、资源协议等高级运行时主题的场景。
限制
- Tauri v2 默认拒绝所有操作,即使“安全”操作也需要权限。
- 安装插件但未在能力文件中添加其权限字符串,会导致运行时静默失败。
- 并非所有 Tauri API 和插件都支持移动端(iOS/Android);使用前需查看插件页面的平台支持矩阵。系统托盘(TrayIconBuilder)、窗口标签/多窗口、部分 shell 插件功能等常见为桌面独有。
- 异步命令不能使用借用类型(如 &str),必须使用拥有所有权的类型(如 String)。
- 移动端构建需要先安装对应的 Rust target(rustup target add <target>)。
- 更新器在生产环境要求签名产物并使用 HTTPS 端点。
- Sidecar 需在 tauri.conf.json 的 bundle.externalBin 中配置路径,并确保二进制被捆绑。
- 本资料未提供具体的收费、价格、平台覆盖范围或效果保证等信息。