uni-app在线更新本质分热更新（wgt）和整包更新（APK/IPA）：wgt仅更新前端资源且需versionName字符串升序比较并调plus.runtime.restart()；整包更新用于原生变更，Android需下载后调uni.installApp()并申请权限，iOS仅跳转App Store。
uni-app 实现在线更新 app 版本，本质是区分「热更新（wgt）」和「整包更新（apk / ipa）」两种路径。不满足前提条件时，plus.runtime.install() 或 uni.installapp() 会静默失败，连错误回调都没有——这是绝大多数人卡住的根本原因。
怎么判断该走 wgt 热更新还是整包更新
关键看服务端返回的更新类型字段（比如 type: 0 或 type: 1），但底层逻辑由你控制：
- wgt 热更新只替换
static/、js/、css/、页面结构等前端资源，不改原生容器；要求manifest.json中的versionName必须严格大于当前plus.runtime.version（字符串比较，不是数值） - 整包更新必须重装 APK（Android）或跳转 App Store（iOS），它能更新原生能力、插件、WebView 内核等全部内容；适用于版本号大变更、权限调整、targetSdkVersion 升级等场景
- H5 和小程序端不支持任何形式的“安装更新”，该逻辑必须主动屏蔽（比如用
uni.getSystemInfoSync().platform === 'ios' || 'android'做守卫）
plus.runtime.install() 为什么调了没反应
plus.runtime.install() 是 wgt 更新的核心，但它极其脆弱，常见失效点如下：
- 传入的 URL 不是 HTTPS 直链，或服务端返回状态码不是 200，或
Content-Type不是application/octet-stream - 本地
plus.runtime.version没变：必须先改manifest.json的versionName，再通过 HBuilderX → 发行 → 原生App → 制作移动App资源升级包 生成新 wgt；手动 zip 压缩、重命名文件、漏改versionCode都会导致失败 - 没等模块就绪就调用：冷启动时
plus.runtime可能未加载完成，建议加setTimeout(..., 1000)或监听plusready事件 - 安装后没重启：wgt 安装成功后必须显式调用
plus.runtime.restart()，否则仍运行旧代码 - 验证方式错误：不要只看下载是否完成，要安装后立刻查
plus.runtime.getProperty('version')，值变了才算真生效
uni.installApp() 在 Android 上总失败怎么办
uni.installApp() 是整包更新入口，但 Android 下失败率极高，问题集中在路径与权限：
- 不能传远程 URL：必须先用
uni.downloadFile()下载到本地，取tempFilePath再传给uni.installApp() - 路径必须可读：推荐保存到
uni.env.USER_DATA_PATH + '/update/app-release.apk'，避免 Android 10+ 外部存储限制 - 权限缺失：Android 8.0+ 需在
AndroidManifest.xml声明android.permission.REQUEST_INSTALL_PACKAGES；Android 11+ 若用外部路径，还需动态申请该权限 - iOS 上它只是跳转：实际行为是尝试打开
itms-services://链接或 fallback 到 Safari，不会下载、不校验、不提示——别指望它“自动安装”
真正容易被忽略的是版本号比较逻辑：wgt 要求字符串升序（"1.10.0" > "1.9.0" 成立），而整包更新常依赖 appVersionCode 数值比对；两个逻辑混用、或服务端只比对一个字段，就会导致“检测到更新但不触发安装”。
