SuperAPI AI 工具集

migrating-tauri-apps

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:指导 Tauri 应用迁移到 v2 stable,支持两条路径——v1.x 到 v2 stable(破坏性变更较多)与 v2 beta 到 v2 stable(变更较少)。

主要能力:覆盖配置文件结构重组、Cargo.toml 特性增删、Rust 与 JavaScript API 变更、插件化迁移、事件系统行为变化、环境变量重命名、移动端支持配置,以及迁移检查清单和常见问题排查。

使用方式:先安装最新 CLI(npm install @tauri-apps/cli@latest),再运行 npm run tauri migrate(或 yarn/pnpm/cargo tauri migrate)。该命令可自动化大部分任务,但不能完全替代人工审查,运行后需逐项核对。

关键变更:v1 的 package/tauri 顶层结构改为顶层 productName、version、identifier、app、bundle,并新增必填 mainBinaryName;allowlist 被 capabilities 权限系统取代,需在 src-tauri/capabilities/ 下创建 JSON;原 api 模块移除,功能拆分为 @tauri-apps/plugin-* 插件,需安装并在 Rust 中注册;Window 重命名为 WebviewWindow,菜单与托盘 API 改为 Builder 形式;文件系统函数重命名(如 createDir→mkdir、readBinaryFile→readFile);emit() 行为改为广播全部监听器;Windows 生产环境源改为 http://tauri.localhost,可用 useHttpsScheme 保持旧行为;环境变量改为 TAURI_SIGNING_PRIVATE_KEY 等。v2 beta 到 stable 需为权限加 core: 前缀或使用 core:default,并更新移动端开发服务器配置。

适用场景:桌面与移动端 Tauri 项目的版本升级。限制:资料未提供具体版本号范围、收费信息或效果保证,迁移结果需自行验证。