客户端更新检测与安装（Windows）—— 接口文档

展播端（Tauri Windows 应用）检测后端是否有新版本安装包，下载并启动安装。仅 Windows。

一、检测更新接口

POST /api/update/check

请求体：

{ "current": "0.1.0" }   // 前端上报的当前安装版本（Tauri getVersion）

响应：

{
  "ok": true,
  "latest_version": "0.1.1",
  "installer_name": "云超服昆创园OPC运营中心_0.1.1_x64-setup.exe",
  "download_url": "/download",
  "update_available": true
}

字段：

字段	说明
`ok`	是否成功
`latest_version`	最新版本号（从安装包文件名解析）
`installer_name`	安装包文件名
`download_url`	安装包下载相对路径（前缀 `api_base`）
`update_available`	是否需要更新（`latest > current`）

最新版本如何确定：扫描 backend/ 目录下 *.setup.exe，从文件名正则 _(\d+\.\d+(?:\.\d+)?) 提取版本号（如 ..._0.1.1_x64-setup.exe → 0.1.1）。文件名倒序取第一个。

二、下载安装包接口

GET /download（别名 /11）—— 返回 backend/ 下最新安装包，application/octet-stream 附件下载。

三、前端流程

文件	逻辑
`src/utils/updateCheck.js`	`getCurrentVersion()` 用 Tauri `getVersion()` 读真实版本 → `checkForUpdate()` 调 `/api/update/check` → `downloadAndInstall()` fetch 下载字节
`src/components/UpdateNotify.jsx`	检测到更新弹底部提示；点「下载更新」→ 下载 → 启动安装 → 应用退出
Rust `install_update`	写盘到 `%TEMP%` → 启动安装程序 → 0.8s 后 `app.exit(0)`

触发时机：启动静默查一次 + 每 30 分钟自动查 + 点页眉 logo 主动查。

四、发布新版本步骤

把新安装包放入 backend/，文件名带版本号：云超服昆创园OPC运营中心_0.2.0_x64-setup.exe。
同步改 package.json 的 version（Tauri getVersion 读取它）。
重启后端 + 重新打包前端 yarn build:win。
安装端检测到 latest > current → 弹更新提示 → 下载安装。

五、验证

curl -X POST http://192.168.1.9:10085/api/update/check \
  -H "Content-Type: application/json" -d '{"current":"0.1.0"}'

backend/ 有更高版本安装包时返回 update_available: true。

六、注意

当前按「文件名倒序取第一个」判定最新；若目录同时存在多个版本（如 0.9 与 0.10），字符串倒序可能取错。多版本共存时应改为「解析全部版本号 → 取数值最大」。
downloadAndInstall 经 invoke 传递安装包字节（约 2.5MB，JSON 数组稍慢）；如需更快可改 Rust 端直接 HTTP 下载。

2.7 KiB Raw Permalink Blame History Unescape Escape