uniapp 2.0 热更新云打包，更新弹框没有展示

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

针对你遇到的云打包 apk 安装后，热更新弹框不展示的问题，结合 uni-app 2.0 和官方升级中心插件的常见情况，排查方向主要集中在“云函数连接”和“旧包绑定”上。

以下是可能的原因和对应的解决方案：

1. 云端服务空间发生变更（最常见原因）

如果你的应用使用了 uni-upgrade-center 升级中心插件，并且近期更换或迁移过 uniCloud 服务空间（例如从阿里云迁移到支付宝云，或更换了新的空间），旧版安装包内部仍然绑定的是旧的服务空间地址。

• 现象：基座包能更新是因为它连接的是当前激活的服务空间。但之前通过云打包发布的 apk，其内部代码绑定的空间 id 是旧的，导致无法请求到新空间的 check-version 云函数，因此收不到更新弹窗。
• 解决方案：你需要重新进行一次云打包（整包更新），将新的服务空间配置重新编译进 apk 中，用户安装新版 apk 后，即可正常检测后续的更新。

2. 原生插件未正确打包进正式包

部分升级插件依赖原生插件（如 CL-UpDater 等）来实现弹窗和进度条。

• 现象：在自定义基座中运行正常，因为基座包含了原生插件。但云打包时，如果 manifest.json 的模块配置中遗漏了勾选，或者 nativePlugins 配置不正确，导致正式包中未包含该原生插件，调用 uni.requireNativePlugin 时就会返回空对象，从而没有弹框。
• 解决方案：
  1. 检查 manifest.json 的 App 原生插件配置，确保相关插件已勾选。
  2. 如果是本地插件，确认插件目录在 nativeplugins 下，且打包时已包含。
  3. 在正式包中通过 console.log 打印一下 uni.requireNativePlugin('插件ID') 的返回值，如果为空，则说明打包时未包含该插件。

3. 弹窗逻辑仅在强制更新时展示

部分升级插件的新版逻辑有所调整，弹窗的展示行为与“是否强制更新”有关。

• 现象：在 uni-admin 后台发布版本时，如果未勾选“强制更新”，部分插件（如 uni-upgrade-center 新版）在下载资源时，可能会直接关闭弹窗，并在系统通知栏显示进度，导致你以为没有弹窗。
• 解决方案：在 uni-admin 后台发布新版本时，尝试勾选“强制更新”选项，观察弹窗是否正常出现。如果出现，说明这是插件的设计逻辑，而非 bug。

4. wgt 包的版本冲突

如果应用之前通过 wgt 热更新升级过，本次又发布了新的 wgt 包，可能因为版本号问题导致安装失败。

• 现象：plus.runtime.install 安装时，可能会因为 wgt 包中的 manifest.json 版本号不高于当前运行版本而失败，且错误回调中可能没有触发弹窗。
• 解决方案：
  1. 确保新 wgt 包的版本号（在 manifest.json 中配置）严格大于当前已安装的版本。
  2. 如果确实需要忽略版本号强制安装，可以在调用 plus.runtime.install 时，将 force 参数设置为 true。

5. 代码层面未正确触发检查

• 检查点：确认在 App.vue 的 onLaunch 生命周期中，check-update 相关的云函数调用是否被正确执行，且未被 try-catch 静默吞掉错误。
• 调试建议：在检测更新的入口处增加 console.log，并在 check-version 云函数的 catch 分支中打印错误信息，确认云函数是否成功请求并返回了需要更新的 code（如 101 或 102）。

如果以上步骤仍无法解决，建议检查云打包时的错误日志，或尝试在 check-version 云函数中增加日志，确认客户端的请求是否成功到达了服务端。