真要判断App是否进入后台,必须分平台用原生探针:Android用ActivityLifecycleCallbacks统计Resumed Activity数量,为0即后台;iOS只能靠onHide/onShow加时间戳兜底推测。

不能靠 onHide 就认定“已退后台”,也不能用 uni.getSetting 查状态——它俩都不反映真实进程级前后台关系。真要判断,必须分平台走原生探针,且 Android 和 iOS 的实现逻辑完全不同。
Android:用 ActivityLifecycleCallbacks 做精准计数
Android SDK 14+ 提供了 ActivityLifecycleCallbacks,这是目前最稳定、不依赖权限、也不被系统限制的方案。核心思路是:统计当前 Resumed 状态的 Activity 数量,为 0 即判定为后台。
- 在原生插件(如
AppStatusTracker.java)中注册全局生命周期回调,监听onActivityResumed和onActivityPaused - 用一个静态 int 计数器:
onActivityResumed时 +1,onActivityPaused时 -1 - 当计数器为 0,立刻触发 JS 层回调(如
uni.$emit('app-background')),表示真正进入后台 - 注意避免“跳转瞬间归零”的误判:可在
onActivityPaused后加Handler.postDelayed延迟 200ms 再检查计数,避开 Activity 切换抖动
iOS:无法直接检测,只能靠 onShow/onHide + 时间戳兜底
iOS 系统禁止 App 探测自身是否在后台(连 UIApplication.sharedApplication().applicationState 都不暴露给 JS 层),所以没有等价于 Android 的原生回调机制。
-
onHide是你唯一能拿到的信号,但它只代表“可能进后台”,也可能是锁屏或切到 Spotlight -
onShow同样不可靠:它既可能是冷启动,也可能是从微信/短信切回来,无法区分 - 实用策略:在
onHide触发时写入本地时间戳(uni.setStorageSync('lastHideTime', Date.now()));下次onShow时读取,若间隔 > 3 分钟,可近似认为上次是“非正常后台停留”(比如被系统挂起或用户长时间未操作) - 别尝试用
plus.ios.invoke('UIApplication', 'sharedApplication')...调用原生方法——iOS 14+ 已屏蔽此类反射调用,运行时直接 crash
为什么不能用 getRunningAppProcesses 或 getRunningTasks?
这些 API 在现代 Android 上基本失效,不是 uni-app 的问题,而是系统级限制。
-
getRunningTasks自 Android 5.0(API 21)起对第三方应用返回空列表,调用无意义 -
getRunningAppProcesses在 Android 8.0+ 被大幅阉割,返回的importance字段仅对本进程有效,其他进程一律返回IMPORTANCE_GONE或IMPORTANCE_CANT_SAVE_STATE,无法用于判断前台 - 即使低版本能跑,也需要声明
GET_TASKS权限,而该权限在 Google Play 上架时会被拒审 - 所有基于“遍历进程列表”的方案,在 targetSdkVersion ≥ 30 的包里默认被禁用,且 HBuilderX 打包时会静默过滤掉对应权限声明
onHide 的真实作用边界在哪?
onHide 不是“后台检测工具”,它是 uni-app 给你的最后一个**可执行 JS 的时机**,价值在于“收尾”,而非“判断”。
- 它一定会在按 Home 键、锁屏、切到其他 App 时触发(iOS/Android 均稳定)
- 但它绝不会在进程被强杀、内存回收、系统休眠时触发——那些场景下 JS 上下文直接销毁
- 不要在里面发“用户已退出”上报,因为 10 秒后他可能又切回来了
- 真正该做的事只有三件:
uni.setStorageSync保存关键状态、clearInterval清掉所有定时器、调用plus.geolocation.clearWatch停定位监听 - 如果你发现
onHide没触发,大概率是页面没正确注册生命周期(比如写在组件里而非页面级export default中),或被异常阻塞(如死循环、未 catch 的 Promise reject)
最易被忽略的一点:前后台状态本质是「进程可见性」,而 JS 层永远拿不到这个维度的真实数据。所有看似“检测”的方案,其实都是在用生命周期信号 + 时间差 + 平台特性做合理推测。别指望 100% 准确,业务上做好降级(比如草稿自动存、位置断点续传)比纠结“此刻是不是后台”更重要。











