Leptos + Tauri 2 配置指南：Trunk、SSG 与移动端热重载

• beforeDevCommand: trunk serve
  你执行 cargo tauri dev 时，Tauri 会先帮你启动 Trunk 的开发服务器。
• devUrl: http://localhost:1420
  Tauri 开发模式加载的页面地址就是这个（Trunk 默认端口常用 1420）。
• beforeBuildCommand: trunk build
  你执行 cargo tauri build 时，先把 Leptos 编译成静态资源。
• frontendDist: ../dist
  Trunk build 的输出目录（注意这是相对 src-tauri/ 的路径，所以通常是 ../dist）。
• withGlobalTauri: true
  注入 window.__TAURI__，方便 WASM/vanilla JS 访问。

示例配置 2：Trunk.toml

在项目根目录创建/修改 Trunk.toml：

[build]
target = "./index.html"

[watch]
ignore = ["./src-tauri"]

[serve]
port = 1420
open = false
ws_protocol = "ws"

这里的重点：

• [build].target = "./index.html"
  指定构建入口页面（Trunk 以它为入口组织资源与 wasm 输出）。
• [watch].ignore = ["./src-tauri"]
  避免 Trunk 监听 Rust/Tauri 工程目录导致无意义的重编译或文件句柄压力（特别是 Windows/大型工程时会明显）。
• [serve].ws_protocol = "ws"
  移动端热重载稳定性的关键项。

开发与构建命令

开发（桌面）：

cargo tauri dev

发布构建：

cargo tauri build

因为你已经在 tauri.conf.json 里配置了 beforeDevCommand/beforeBuildCommand，所以通常不需要你手动先跑 trunk serve/build。

WASM 侧怎么用 Tauri API

开启 withGlobalTauri 后，window.__TAURI__ 会存在。官方 JS API 文档也明确：使用全局对象需要这个开关。

在 Leptos/WASM 里常见做法是：

• 用 wasm-bindgen / web-sys 从 window 上取 __TAURI__
• 再调用你需要的模块（例如 event、window、path、plugin 等）

如果你更偏工程化，也可以在前端用一层 thin wrapper：把需要的 Tauri 能力封装成少量 JS 函数，再让 WASM 调这些函数，边界更清晰、类型更可控。

常见问题排查

• 启动后白屏，但浏览器访问 http://localhost:1420 正常
  优先检查 tauri.conf.json 里的 devUrl 端口是否与 Trunk 一致，以及是否启动了 trunk serve（看终端输出）。
• 热重载在移动端不工作
  先确认 Trunk.toml 里 ws_protocol = "ws" 已设置。
• WASM 里拿不到 window.__TAURI__
  检查 app.withGlobalTauri 是否为 true，并确认你是在 Tauri 窗口里运行（不是纯浏览器环境）。