提交

README.md

@@ -70,3 +70,26 @@ node --test tests/*.test.mjs
 - 锁码格式、长度和唯一性规则。
 
 一期需要确认是否与管理后台头程订单及仓库任务同步上线。
+
+## App 在线更新
+
+Android App 启动后会读取 `VITE_PDA_UPDATE_URL` 并检查国内 PDA 的独立更新通道，员工也可在“个人中心 → 检查更新”手动触发；H5 仅展示 App 操作提示，不执行更新。更新服务接收 `appid`、`platform`、`appVersion`、`appVersionCode`、`wgtVersion` 查询参数，无更新返回 `{ "update": false }`，有更新返回：
+
+```json
+{
+  "update": true,
+  "packageType": "apk",
+  "versionName": "0.0.2",
+  "versionCode": 2,
+  "downloadUrl": "https://updates.example.com/pda/domestic/0.0.2.apk",
+  "mandatory": false,
+  "releaseNotes": "本次更新内容"
+}
+```
+
+`packageType` 只允许 `apk` 或 `wgt`。`mandatory=true` 时员工不能跳过，并在下载或安装失败后提供重试；wgt 安装完成会立即重启，APK 交由 Android 安装器完成覆盖安装。正式发布要求：
+
+1. 国内 PDA 每次整包发布同时递增 `manifest.json` 的 `versionName` 与整数 `versionCode`，使用国内独立 AppID、包名和签名打包 APK。
+2. wgt 发布至少递增 `versionName`，并使用与已安装原生包兼容的 uni-app 编译器生成；新增原生模块、权限或不兼容运行时能力时必须发布 APK，不能只发 wgt。
+3. 更新清单与下载地址使用 HTTPS，先在测试设备验证可选更新、强制更新、断网重试、APK 覆盖安装、wgt 重启及扫码作业回归，再切换正式清单。
+4. 国内和海外更新记录、文件目录及发布权限保持隔离，服务端必须按请求中的 `appid` 拒绝跨应用更新包。