SuperAPI AI 工具集

calling-rust-from-tauri-frontend

编程与开发

查看项目

更新于 10-16 06:17

技能介绍

用途:指导在 Tauri v2 前端通过命令系统与 invoke 函数调用 Rust 后端函数。Tauri 提供两种 IPC 机制:命令(推荐,类型安全的函数调用,参数与返回值经序列化)和事件(动态单向通信,本文不涉及)。

主要能力:用 #[tauri::command] 定义命令,并在 tauri::Builder 的 invoke_handler 中用 tauri::generate_handler![...] 注册;前端从 @tauri-apps/api/core 导入 invoke 调用,启用 withGlobalTauri 时也可用 window.TAURI.core.invoke。参数默认将 Rust snake_case 映射为 JS camelCase,可用 rename_all 调整;复杂参数需实现 serde::Deserialize,返回类型需实现 serde::Serialize。大二进制数据可用 tauri::ipc::Response 绕过 JSON 序列化。错误处理可返回 Result<T, E>(E 实现 Serialize 或为 String),也可用 thiserror 自定义错误或结构化错误响应,前端以 try/catch 捕获。异步命令用 async fn,但不可直接使用 &str 等借用类型,需用拥有所有权的类型。命令可注入 WebviewWindow、AppHandle、State<T> 访问窗口、应用信息与共享状态(配合 manage 注册)。高级功能包括通过 Request 与 InvokeBody 访问原始请求头与请求体,以及用 Channel 实现流式传输。命令可放在模块中组织,但 lib.rs 中的命令不能为 pub。

使用方式:Rust 侧定义并注册命令,前端 await invoke('命令名', { 参数 })。

限制:命令名在整个应用中必须唯一;所有命令必须在单个 generate_handler! 调用中注册;异步命令不能直接使用借用类型;参数需实现 Deserialize,返回值需实现 Serialize。具体安装与版本要求资料未提供。