关于 updating-tauri-dependencies
为维护 Tauri 项目的开发者提供跨 JavaScript 与 Rust 生态更新依赖的操作指南,重点说明两侧版本同步及插件版本一致性。
主要功能
- 01同步 JavaScript 与 Rust 版本
- 02更新 Tauri CLI 和 API
- 03更新 Rust crate
- 04保持插件版本一致
- 05检查过期依赖
适用场景
- 01升级 Tauri 项目依赖
- 02排查 JavaScript 与 Rust 版本不匹配
- 03更新 Tauri 插件并验证构建
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ dchuk/ claude-code-tauri-skills --skill updating-tauri-dependencies安装后在 Claude Code 中输入/updating-tauri-dependencies确认已加载。
详细介绍
更新 Tauri 依赖
本指南介绍如何更新 JavaScript 和 Rust 生态系统中的 Tauri 依赖。
版本同步(关键)
JavaScript @tauri-apps/api 包和 Rust tauri crate 必须保持次版本号一致。添加新功能时,必须同时升级两端,以确保兼容性。
对于 Tauri 插件,npm 包和 cargo crate 必须保持版本完全一致(例如,均为 2.2.1)。
更新 JavaScript 依赖
使用 npm
更新 Tauri CLI 和 API 包:
npm install @tauri-apps/cli@latest @tauri-apps/api@latest
检查过时的包:
npm outdated @tauri-apps/cli
npm outdated @tauri-apps/api
使用 yarn
更新 Tauri CLI 和 API 包:
yarn up @tauri-apps/cli @tauri-apps/api
检查过时的包:
yarn outdated @tauri-apps/cli
yarn outdated @tauri-apps/api
使用 pnpm
更新 Tauri CLI 和 API 包:
pnpm update @tauri-apps/cli @tauri-apps/api --latest
检查过时的包:
pnpm outdated @tauri-apps/cli
pnpm outdated @tauri-apps/api
更新 Rust 依赖
手动更新
-
在 crates.io 上查看最新版本:
-
编辑
src-tauri/Cargo.toml并更新版本号:
[build-dependencies]
tauri-build = "2.0"
[dependencies]
tauri = { version = "2.0", features = [] }
- 在 src-tauri 目录中运行 cargo update:
cd src-tauri && cargo update
使用 cargo-edit(自动)
如果尚未安装,请安装 cargo-edit:
cargo install cargo-edit
自动升级 Tauri 依赖:
cd src-tauri && cargo upgrade tauri tauri-build
检查更新
检查所有 Tauri 依赖
JavaScript 包:
# npm
npm outdated | grep tauri
# yarn
yarn outdated | grep tauri
# pnpm
pnpm outdated | grep tauri
Rust crate:
cd src-tauri && cargo outdated | grep tauri
注意:cargo outdated 需要 cargo-outdated 工具:
cargo install cargo-outdated
更新 Tauri 插件
更新 Tauri 插件时,npm 包和 Rust crate 必须更新到相同版本。
以下以更新插件为例(例如,shell 插件):
JavaScript 端
# npm
npm install @tauri-apps/plugin-shell@latest
# yarn
yarn up @tauri-apps/plugin-shell
# pnpm
pnpm update @tauri-apps/plugin-shell --latest
Rust 端
编辑 src-tauri/Cargo.toml:
[dependencies]
tauri-plugin-shell = "2.0"
然后更新:
cd src-tauri && cargo update
完整更新工作流
要更新项目中的所有 Tauri 依赖:
- 更新 JavaScript 依赖:
# Using npm (adjust for your package manager)
npm install @tauri-apps/cli@latest @tauri-apps/api@latest
- 更新 JavaScript 端的所有 Tauri 插件:
npm install @tauri-apps/plugin-shell@latest @tauri-apps/plugin-fs@latest
# Add other plugins as needed
-
在
src-tauri/Cargo.toml中更新 Rust 依赖 -
运行 cargo update:
cd src-tauri && cargo update
- 重新构建项目以验证兼容性:
npm run tauri build
# or
cargo tauri build
故障排除
版本不匹配错误
如果遇到 JavaScript 和 Rust 依赖之间的版本不匹配错误:
- 确认两端使用的次版本号一致
- 检查
package.json中的@tauri-apps/api版本 - 检查
src-tauri/Cargo.toml中的tauricrate 版本 - 确保两者版本一致(例如,均为 2.x)
Cargo 锁定文件冲突
如果更新后 Cargo.lock 出现冲突:
cd src-tauri && rm Cargo.lock && cargo update
插件版本不匹配
如果插件版本不匹配,请确保同一插件的 npm 版本和 cargo 版本完全一致。