强制升级需在每次onShow或路由跳转前轻量检查版本，用plus.key监听返回键并软拦截，配合APP-PLUS条件编译、HTTPS升级包、iOS ATS及Android安装权限配置。
App端怎么触发强制升级弹窗
uni-app在App端没法靠H5的更新机制，得用原生能力拉取版本信息再比对。关键不是“弹窗”，而是“什么时候检查+怎么中断用户操作”。
常见错误是只在onLaunch里查版本，结果用户已经进到二级页面了，新版本来了也不弹——必须在每次onShow或路由跳转前做一次轻量检查（带缓存）。
- 用
uni.getSystemInfoSync().platform === 'ios' || 'android'区分平台，调原生插件或自定义基座发请求 - 服务端返回的版本号必须和
uni.getSystemInfoSync().version严格比对（注意iOS可能带build号，建议统一用CFBundleShortVersionString字段） - 弹窗本身用
uni.showModal，但showCancel: false还不够，要配合success回调里调uni.downloadFile+uni.installDoucment（iOS需额外配置ATS和LSApplicationQueriesSchemes）
为什么uni.navigateBack拦截不住返回键
因为App端的物理返回键（Android）和手势返回（iOS）不走JS路由栈，uni.navigateBack只是个导航方法，不是系统事件钩子。
真正能拦的是plus.key.addEventListener('backbutton', ...)，但这个API只在5+原生环境生效，H5和小程序里根本不存在。
- 必须在
uni-app的app-plus条件编译块里写：#ifdef APP-PLUS plus.key.addEventListener('backbutton', () => { // 这里写弹窗逻辑 }, false); #endif - 别在
onLoad里注册，要在onLaunch或onShow里确保执行一次，否则热重载后监听就丢了 - 如果用户点的是右上角关闭按钮（非物理键），那得另外监听
plus.webview.currentWebview().setStyle({popGesture: 'none'})禁用手势
强制升级弹窗里点取消/返回键怎么办
点了取消不能真让用户走，否则升级逻辑就断了。这时候得用“软拦截”：把返回键行为覆盖成“重新弹窗”，而不是放行。
但要注意，连续弹两次uni.showModal会被系统屏蔽，必须加防抖或改用uni.showToast提示“请先升级”。
- 在
plus.key监听里，不要直接uni.navigateBack，而是uni.showModal并设success为空函数 - 如果用户长按返回键触发多按，
plus.key会多次触发，得用setTimeout加锁，比如500ms内只响应第一次 - Android上部分厂商（华为、小米）会把“返回键+Home键”组合识别为截屏，此时
backbutton事件可能延迟或丢失，建议加个plus.runtime.getProperty兜底检测是否在前台
uni-app条件编译和原生能力的坑
很多开发者卡在“写了plus.key但没反应”，其实是编译目标没选对。HBuilderX里必须勾选“运行到手机或模拟器”并选择“自定义基座”，普通云打包不会包含5+ API。
还有人把plus对象当成全局变量直接用，结果报plus is not defined——它只在APP-PLUS环境下存在，且初始化有延迟。
- 所有
plus.xxx调用前，先判断typeof plus !== 'undefined'，再判断plus.runtime是否ready - 升级包路径必须用
https，HTTP在iOS 12+和Android 9+默认被拦截，报错net::ERR_CLEARTEXT_NOT_PERMITTED - Android 11+要求APK安装权限显式声明，得在
manifest.json → app-plus → permissions里加"android.permission.REQUEST_INSTALL_PACKAGES"
