onhide 中 setfullscreen(false) 失效是因系统冻结 webview 或 rom 忽略后台 api；需搭配样式重置、statusbarstyle 设置及 pause 事件监听，并检查 manifest.json 全局配置与页面级按需恢复。
onHide 中调 plus.navigator.setFullscreen(false) 为什么经常失效
不是代码写错了，而是时机和平台限制共同导致的静默失败。iOS 15+ 和华为 EMUI、小米 HyperOS 等新系统在 App 进入后台时会冻结 WebView，此时调用 setFullscreen(false) 不触发任何错误，但也不生效。Android 端更严重：部分 ROM（如 ColorOS 14+）直接忽略后台状态下的全屏控制 API。
必须搭配样式重置才可靠：
- 在
onHide中先调用plus.webview.currentWebview().setStyle({ top: 'statusBarHeight', height: 'calc(100% - statusBarHeight)' })，用动态计算的statusBarHeight显式还原布局尺寸 - 再执行
plus.navigator.setFullscreen(false)，仅作为逻辑标记，不依赖它单独起效 - iOS 必须额外补一句
plus.navigator.setStatusBarStyle('default')，否则状态栏文字颜色残留为白色或黑色，看起来像“没恢复”
Android 后台恢复要监听 pause 事件而非 onHide
onHide 在某些 Android 厂商系统上触发过早，WebView 尚未完成挂起流程；而 plus.android.on('pause', callback) 是原生层真正进入后台的信号，时机更准。
实操建议：
- 在
App.vue的onLaunch中注册：plus.android.on('pause', () => { /* 清理逻辑 */ }) - 清理逻辑里执行：重置 Webview 样式 +
plus.navigator.setFullscreen(false)+plus.navigator.showSystemNavigation()（Android 专属） - 避免在
onHide里做关键恢复，它更适合处理轻量 UI 切换（如暂停视频）
冷启动时状态栏仍透明？检查 manifest.json 全局配置
很多团队只改了 JS 层逻辑，却忘了 manifest.json 里的“沉浸式开关”是持久生效的。如果 Android 设置中勾选了“沉浸式状态栏”，或写了 "statusBarStyle": "transparent"，那么每次冷启动都会强制启用透明态——跟 JS 层是否调 setFullscreen(false) 完全无关。
必须确认以下两点：
- 在
manifest.json → app-plus → statusbar下，移除immersed: true或显式设为false - 删掉或改为
"statusBarStyle": "default"，不能留空或缺失该字段
页面级恢复比全局恢复更安全
全局在 App.vue 里统一恢复容易误伤：比如某个视频页需要常驻全屏，其他页退出后却被强制还原，造成体验断裂。
推荐按需控制：
- 在需要恢复的页面（如首页、列表页）的
onShow中主动调一次plus.navigator.setFullscreen(false)和样式重置 - 在全屏页（如播放页）的
onHide或onUnload中执行清理，而不是靠全局生命周期兜底 - 避免在
onLaunch中无条件重置——冷启动时用户未必希望状态栏立刻弹出，尤其 Kiosk 类应用
真正难的不是“怎么隐藏”，而是“什么时候、在哪一层、用什么方式把它彻底还回去”。WebView 容器、原生导航栏、系统状态栏三者生命周期不同步，纯 JS 层操作永远只是其中一环。
