Pine
68 lines
2.7 KiB
Markdown
68 lines
2.7 KiB
Markdown
# 客户端更新检测与安装（Windows）—— 接口文档
|
||
|
||
> 展播端（Tauri Windows 应用）检测后端是否有新版本安装包，下载并启动安装。仅 Windows。
|
||
|
||
## 一、检测更新接口
|
||
|
||
**`POST /api/update/check`**
|
||
|
||
请求体：
|
||
```json
|
||
{ "current": "0.1.0" } // 前端上报的当前安装版本（Tauri getVersion）
|
||
```
|
||
|
||
响应：
|
||
```json
|
||
{
|
||
"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 主动查。
|
||
|
||
## 四、发布新版本步骤
|
||
|
||
1. 把新安装包放入 `backend/`，文件名带版本号：`云超服昆创园OPC运营中心_0.2.0_x64-setup.exe`。
|
||
2. 同步改 `package.json` 的 `version`（Tauri `getVersion` 读取它）。
|
||
3. 重启后端 + 重新打包前端 `yarn build:win`。
|
||
4. 安装端检测到 `latest > current` → 弹更新提示 → 下载安装。
|
||
|
||
## 五、验证
|
||
|
||
```bash
|
||
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 下载。
|