uni-app App端wgt热更新能用，但必须满足三硬条件：manifest.json版本号已变更、HBuilderX正确生成.wgt包、服务端返回的wgtUrl可被plus.runtime.install()正确加载；缺一则导致“检测到更新但不下载”或“下载失败静默退出”。
直接上结论：uni-app 的 App 端热更新（wgt 包）能用，但必须满足三个硬条件——manifest.json 版本号已变更、HBuilderX 正确生成了 .wgt 包、服务端接口返回的 wgtUrl 可被 plus.runtime.install() 正确加载。漏掉任一环，都会卡在“检测到更新但不下载”或“下载失败静默退出”。
manifest.json 版本号改了但没生效？检查 appid 和 version 位置
很多人改了 manifest.json 里的 versionName，却忘了 versionCode 是纯数字且必须递增；更关键的是，appid 必须和你打包时用的完全一致（比如 UNI832D722），否则 wgt 包解压后无法覆盖原资源目录。
-
versionName用于展示（如"1.0.1"），可含点号 -
versionCode是整数（如101），每次升级必须比上次大 -
appid错一个字符，plus.runtime.install()就会报错"Invalid widget package" - HBuilderX 打包 wgt 前会读取
manifest.json中的appid和versionName，生成文件名形如UNI832D722_1.0.1.wgt
plus.runtime.install() 下载 wgt 失败？注意协议、路径和权限
常见现象是调用 plus.runtime.install(wgtUrl) 后控制台无报错，但资源没更新。根本原因通常是 URL 不合法或运行时权限缺失。
- URL 必须是 HTTPS（iOS 强制，Android 8.0+ 也默认拦截 HTTP）
- 路径不能带中文或空格，例如
https://example.com/static/UNI832D722.wgt可行，https://example.com/资源包/UNI832D722.wgt会失败 - Android 需要
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>（targetSdkVersion - iOS 上 wgt 更新仅支持
plus.runtime.restart()后生效，不会立即刷新界面
服务端返回 update: true 但客户端不触发 install？检查响应头和 JSON 结构
客户端靠 uni.request() 拿到响应后，会判断 res.data.update === true 并取 res.data.wgtUrl。如果这个字段是空字符串、null 或拼写错误（比如写成 WgtUrl），整个流程就断了。
- 确保服务端返回 Content-Type 是
application/json - JSON 字段名严格区分大小写：
update、wgtUrl、pkgUrl，少一个字母都不行 - 测试时可用 curl 直接请求接口：
curl "https://example.com/update/?name=myapp&version=1.0.0"，看返回是否符合预期 - 不要在服务端做重定向（302），
plus.runtime.install()不跟随跳转
wgt 更新真正难的不是调用 API，而是版本号管理和服务端判定逻辑——比如 v1.0.1 → v1.1.0 属于功能迭代，该走 wgt；v1.1.0 → v2.0.0 可能涉及 Native 插件变更，就必须强制整包更新。这个分界线得提前和后端对齐，不能只靠字符串比较。
