Skip to main content
本指南为桌面应用提供可复现的本地打包步骤。 只发布一个二进制文件。 World Monitor 是唯一的桌面制品，所有变体 —— tech、finance、commodity、energy、happy —— 均在安装后于应用内切换，并在重启后保持。不存在按变体划分的安装包、标签或下载。 这是刻意的约束，而非疏漏：/api/version 和 /api/download 解析 /releases/latest，它最多只返回一个 release，因此第二条发布线永远无法送达用户（#5908）。 包标识由单一的 Tauri 配置控制：src-tauri/tauri.conf.json → World Monitor / world-monitor。

​
前置条件

  • Node.js + npm
  • Rust 工具链
  • 操作系统原生 Tauri 构建前置条件：
    • macOS：Xcode 命令行工具
    • Windows：Visual Studio Build Tools + NSIS + WiX
安装依赖（此操作也会安装桌面脚本所使用的已锁定 Tauri CLI 版本）：
所有桌面脚本都调用 node_modules/.bin 中的本地 tauri 二进制文件；在执行 npm ci 之后，无需在运行时通过 npx 下载包。 如果本地 CLI 缺失，scripts/desktop-package.mjs 会立即失败，并显示明确的 npm ci 修复提示信息。

​
网络预检与修复

在 CI 或托管网络中运行桌面打包之前，请验证连接性和代理配置：
如果上述命令失败，请使用以下支持的修复方案之一：
  • 内部 npm 镜像/代理。
  • 内部 Cargo 稀疏索引/注册表镜像。
  • 预先打包的 Rust crates（src-tauri/vendor/）+ Cargo 离线模式。
  • 在构建之前还原所需包输入的 CI 制品/缓存策略。
有关失败分类标签和故障排除流程，请参见 docs/TAURI_VALIDATION_REPORT.md。

​
打包命令

查看脚本用法/帮助：

​
macOS（.app + .dmg）

​
Windows（.exe + .msi）

打包器目标在 Tauri 配置中已锁定，并由打包脚本强制执行：
  • macOS：app,dmg
  • Windows：nsis,msi

​
Rust 依赖模式（在线与受限网络）

在 src-tauri/ 中，项目支持两种打包路径：

​
1) 标准在线构建（默认）

使用常规 Cargo 行为（crates.io）：

​
2) 受限网络构建（预打包或内部镜像）

src-tauri/.cargo/config.toml 中定义了一个可选的打包源。要使用它，首先在具有注册表访问权限的机器上准备打包好的 crates：
然后使用以下任一方法启用离线模式：
  • 一次性 CLI 覆盖（不修改文件）：
  • 本地覆盖文件（推荐用于 CI/可重复的离线作业）：
对于 CI 或内部镜像，请将 src-tauri/vendor/ 作为制品发布，并在受限网络构建之前还原它。如果您的组织使用内部 crates 镜像而非打包方式，请在 CI 专用 Cargo 配置中将 source.crates-io.replace-with 指向该镜像，并运行相同的构建命令。

​
可选的签名/公证钩子

默认情况下使用未签名打包。 如果环境变量中存在签名凭据，Tauri 将在相同的打包命令期间自动签名/公证。

​
macOS Apple 开发者签名 + 公证

在打包之前设置（Developer ID 签名）：
对于公证，请选择一种身份验证方式：
然后运行标准或显式签名脚本别名之一：

​
Windows Authenticode 签名

在打包之前设置（PowerShell）：
然后运行标准或显式签名脚本别名之一：

​
包标识（名称/图标）

src-tauri/tauri.conf.json → World Monitor / world-monitor，其中 bundle.icon 指向共享的图标集。无论用户之后切换到哪个变体，每个打包构建都带有该标识，因此窗口标题与已安装的应用名称始终为 World Monitor。 新增第二个 tauri.*.conf.json 来为某个变体做品牌化，会被 tests/desktop-one-binary-model.test.mjs 明确拒绝：没有任何流程会发布它，端点也无法提供它。如果确实需要按变体划分的品牌化二进制，请先在 #5902 中重新讨论打包模型。

​
输出位置

制品生成在以下位置：
常见子文件夹：
  • app/ → macOS .app
  • dmg/ → macOS .dmg
  • nsis/ → Windows .exe 安装程序
  • msi/ → Windows .msi 安装程序

​
发布检查清单（干净机器）

  1. 为所需的 OS 构建安装包。
  2. 将制品移动到干净机器（或全新的 VM）。
  3. 安装/启动：
    • macOS：挂载 .dmg，将应用拖到”应用程序”，然后启动。
    • Windows：运行 .exe 或 .msi，从”开始”菜单启动。
  4. 验证启动：
    • 应用窗口无崩溃地打开。
    • 地图视图正常渲染。
    • 初始数据加载路径不会出现致命错误。
  5. 验证包标识与应用内变体切换：
    • 窗口标题和产品名称为 World Monitor。
    • 切换到其他变体后会重新加载为该变体的面板/图层，并在重启后保持。
  6. 如果启用了签名：
    • 在 OS 对话框/属性中验证代码签名元数据。
    • 在 macOS 上验证公证/Gatekeeper 接受情况。