onBackPress 应仅拦截 options.from === 'backbutton' 的物理返回键,iOS 侧滑返回不触发该回调;需在 App.vue 的 onLaunch 中用条件编译注册 uni.onBackPress,防重复绑定与平台报错。
用户点右上角“返回”、调用 uni.navigateBack()、甚至页面栈自动退栈,都会触发 onBackPress。但你真正该干预的,只有物理按键(Android)或导航栏返回按钮(iOS),其他来源一拦就卡死页面栈。
关键判断是 options.from === 'backbutton'——这是唯一可信信号。其他值如 'navigateBack' 或 'pop' 都不该 return true,否则用户点哪都退不了。
App.vue 的 onLaunch 中注册监听:uni.onBackPress,不要在页面级组件里写if (process.env.UNI_PLATFORM === 'app-plus') 条件编译包裹整个逻辑,否则 H5 和小程序会报 plus is not defined
双击退出不是“两次点击后执行”,而是“第一次点击设标记,第二次点击检查间隔是否
典型错误是把 exitConfirm 放在某个业务页的 data 中,结果用户从首页跳到商品页再按返回,双击逻辑直接失效。
App.vue 的 data 中定义:exitTimestamp: 0
onBackPress 里先检查 options.from !== 'backbutton' 就直接 returnDate.now() - this.exitTimestamp :成立则调用退出;不成立则更新 <code>this.exitTimestamp = Date.now()
uni.showModal 弹确认框,内容别写“确定退出”,而要写“再按一次退出应用”,更符合用户预期plus.runtime.quit(),iOS 不能真退出,得降级处理iOS 系统禁止 App 主动退出,plus.ios.import("UIApplication").sharedApplication().performSelector("exit") 在 iOS 13+ 已失效,强行调用会静默失败或闪退。
目前可靠做法只有两个:一是调用 plus.runtime.launchApplication({ action: 'QUIT' }) 跳转到系统设置页(部分机型支持);二是引导用户手动上滑关闭。后者更稳定,但需接受“无法强制退出”的事实。
plus.runtime.quit(),它会立即终止进程,无回调uni.showToast({ title: '请上滑关闭应用', icon: 'none', duration: 2000 })
uni.exit() —— 这是 H5 API,App 端根本不存在,运行时报错onBackPress 在 H5 平台压根不触发。浏览器地址栏后退、Alt+←、手势返回,全绕过它。这不是 bug,是浏览器安全机制决定的。
所以你不能靠统一入口处理“退出”,H5 必须单独判断环境、单独实现逻辑,而且不能弹确认框后再执行 history.back()——因为浏览器返回是同步不可逆操作,弹框还没关,页面已经跳走了。
uni.getSystemInfoSync().platform === 'h5' 判断环境window.history.length > 1,避免 history.back() 执行后白屏uni.navigateBack(),H5 下它依赖 uni-app 页面栈,刷新后栈为空,调用即静默失败真实场景里最容易被忽略的,是 iOS 侧滑返回根本不会进 onBackPress,哪怕你在 pages.json 里配了 "popGesture": "close",它也只影响页面退栈,不触发任何 JS 回调。这意味着你写的双击退出逻辑对侧滑完全无效——用户用手指一滑,App 就没了,连确认机会都没有。