从 Tauri 2.0 Beta 升级
本指南将引导您将 Tauri 2.0 beta 应用程序升级到 Tauri 2.0 发布候选版本。
Tauri v2 CLI 包含一个 migrate
命令,该命令可自动化大部分过程并帮助您完成迁移。
npm install @tauri-apps/cli@latestnpm run tauri migrate
yarn upgrade @tauri-apps/cli@latestyarn tauri migrate
pnpm update @tauri-apps/cli@latestpnpm tauri migrate
cargo install tauri-cli --version "^2.0.0" --lockedcargo tauri migrate
在命令行界面参考中了解有关 migrate
命令的更多信息
我们从 beta 版到发布候选版进行了几项重大更改。这些更改可以自动迁移(见上文)或手动执行。
我们更改了 Tauri 内置插件在 capabilities PR #10390 中处理方式。
要从最新 beta 版本迁移,您需要将 capabilities 中的所有核心权限标识符前缀为 core:
或切换到 core:default
权限并删除旧的核心插件标识符。
..."permissions": [ "path:default", "event:default", "window:default", "app:default", "image:default", "resources:default", "menu:default", "tray:default",]...
..."permissions": [ "core:path:default", "core:event:default", "core:window:default", "core:app:default", "core:image:default", "core:resources:default", "core:menu:default", "core:tray:default",]...
我们还添加了一个新的特殊 core:default
权限集,它将包含所有核心插件的所有默认权限,这样您可以简化 capabilities 配置中的权限模板。
..."permissions": [ "core:default"]...
我们对内置开发服务器的网络暴露方式进行了更改 PR #10437 和 PR #10456。
内置移动开发服务器不再暴露网络范围,而是将流量从本地机器直接隧道传输到设备。
目前,此改进在 iOS 设备上运行(直接或从 Xcode)时不会自动应用。在这种情况下,我们默认使用公共网络地址作为开发服务器,但有一种解决方法,即打开 Xcode 以自动启动 macOS 机器和连接的 iOS 设备之间的连接,然后运行 tauri ios dev --force-ip-prompt
以选择 iOS 设备的 TUN 地址(以 ::2 结尾)。
如果打算在物理 iOS 设备上运行,您的开发服务器配置需要适应此更改。之前我们建议检查 TAURI_ENV_PLATFORM
环境变量是否与 android
或 ios
匹配,但由于现在除非使用 iOS 设备,否则我们可以连接到 localhost,因此您应该改为检查 TAURI_DEV_HOST
环境变量。以下是一个 Vite 配置迁移示例
- 2.0.0-beta
import { defineConfig } from 'vite';import { svelte } from '@sveltejs/vite-plugin-svelte';import { internalIpV4Sync } from 'internal-ip';
const mobile = !!/android|ios/.exec(process.env.TAURI_ENV_PLATFORM);
export default defineConfig({ plugins: [svelte()], clearScreen: false, server: { host: mobile ? '0.0.0.0' : false, port: 1420, strictPort: true, hmr: mobile ? { protocol: 'ws', host: internalIpV4Sync(), port: 1421, } : undefined, },});
- 2.0.0:
import { defineConfig } from 'vite';import Unocss from 'unocss/vite';import { svelte } from '@sveltejs/vite-plugin-svelte';
const host = process.env.TAURI_DEV_HOST;
export default defineConfig({ plugins: [svelte()], clearScreen: false, server: { host: host || false, port: 1420, strictPort: true, hmr: host ? { protocol: 'ws', host: host, port: 1430, } : undefined, },});
© 2025 Tauri 贡献者。CC-BY / MIT