plus.navigator.setStatusBarStyle 在 App 端生效的必要条件是：仅限 APP-PLUS 环境，plus 对象就绪后调用，推荐 onReady 或 onShow 中使用并加 #ifdef APP-PLUS 编译包裹，iOS 首次设置建议放 onLaunch，Android 厂商系统可能忽略该调用。
plus.navigator.setStatusBarStyle 在 App 端生效的必要条件
这个 API 只在 APP-PLUS 环境下可用，且必须等 plus 对象就绪后才能调用。常见错误是放在 mounted 或 created 钩子中——此时 plus 还未初始化，调用静默失败。
正确时机是 onReady（推荐）或 onShow，且必须用条件编译包裹：
// #ifdef APP-PLUS
onReady() {
// 等待 plus 环境可用（iOS 上可能需稍延迟）
setTimeout(() => {
plus.navigator.setStatusBarStyle('light'); // 白色图标（时间/信号等）
// 或 'dark' 表示黑色图标
}, 100);
}
// #endif
-
setStatusBarStyle不影响背景色，只控制状态栏图标的明暗 - iOS 上部分机型（如 iOS 17+）对动态切换支持不稳定，首次设置建议放
onLaunch中 - Android 厂商定制系统（如华为 EMUI、小米 HyperOS）可能忽略该调用，属系统限制，非代码问题
plus.navigator.setFullscreen(true) 隐藏状态栏的实际效果
它不是“修改”状态栏，而是把整个 WebView 拉伸到屏幕顶部，视觉上覆盖状态栏区域。但前提是页面已设为自定义导航栏，否则无效。
必须同时满足三项：
- pages.json 中对应页面的
navigationStyle为"custom" - 配置
"app-plus": { "titleNView": false }，避免残留空白标题区 - 在
onShow中调用（onLoad太早，mounted无 plus 环境）
// #ifdef APP-PLUS
onShow() {
plus.navigator.setFullscreen(true);
}
// #endif
注意：调用后页面内容会顶上去，需用 var(--status-bar-height) 手动留白，否则首屏内容被遮挡。
Android 端直接改状态栏背景色的原生写法
uni-app 自身不提供设置状态栏背景色的 JS API，只能通过 Android 原生桥接实现。以下代码仅适用于 APP-PLUS && ANDROID：
// #ifdef APP-PLUS && ANDROID
const color = plus.android.importClass('android.graphics.Color');
const window = plus.android.runtimeMainActivity().getWindow();
window.setStatusBarColor(color.parseColor('#2d8cf0'));
// #endif
- 该调用需要 Android 5.0+（API 21），低版本无效
- 部分厂商（如 OPPO、vivo）会强制跟随系统深色模式，硬设颜色可能被覆盖
- 不能与
setFullscreen(true)同时使用——后者会让状态栏不可见，背景色设置失去意义
为什么 navigationBarTextStyle 设为 white 却没反应
因为该字段只在 navigationStyle: "default" 时起作用。一旦设为 "custom"，状态栏文字颜色就脱离 pages.json 控制，必须走 plus.navigator.setStatusBarStyle。
典型误操作：
- 页面 style 里写了
"navigationStyle":"custom"，还指望"navigationBarTextStyle":"white"生效 - 在 H5 或小程序端调用
plus相关 API，没加#ifdef APP-PLUS导致运行时报错 - 在
onLoad就调setStatusBarStyle，plus 对象尚未 ready
真正可控的只有 App 端；iOS 上还受 info.plist 全局 UIStatusBarStyle 影响，动态设置优先级低于原生配置。
