App端状态栏文字颜色必须调用原生能力控制，iOS需启用UIViewControllerBasedStatusBarAppearance并配置Info.plist，Android需配置android:windowLightStatusBar及WRITE_SETTINGS权限（仅调试），uni.setNavigationBarColor的style参数仅App有效且仅支持"default"和"black"两值。
App端状态栏文字颜色不能靠 CSS 或 navigationBarTextStyle 动态控制，必须调用原生能力；iOS 和 Android 行为不一致，直接写死配置或监听系统主题大概率失效。
uni.setNavigationBarColor 的 style 参数只在 App 端生效，且仅接受两个值
uni.setNavigationBarColor 的 style 字段不是用来改导航栏文字色的——它专用于状态栏文字颜色，但只对 App 有效，H5 和小程序完全忽略。它的取值只有："default"（浅色文字，通常白）和 "black"（深色文字，通常黑）。
常见错误现象：调用了 uni.setNavigationBarColor({ style: 'black' }) 却没变化，原因通常是：
- 没同时传
navigationBarBackgroundColor，部分安卓机型（如华为 EMUI）会直接忽略style - 在
onLoad里调用，此时原生环境未就绪；应延迟 100ms 或改到onReady后 - AndroidManifest.xml 未配
android:windowLightStatusBar="true"，导致系统强制白字
Android 必须手动配置 windowLightStatusBar 才能让 black 生效
即使 JS 层调了 style: 'black'，若原生层没开启对应权限，状态栏文字仍为白色（尤其在深色背景上不可见）。必须修改 manifest.json → app-plus → android → permissions，添加：
"android.permission.WRITE_SETTINGS"
⚠️ 注意：该权限仅调试阶段可用，上线前必须移除。更稳妥的做法是：
- 使用 DCloud 官方推荐的
statusBar插件，并在manifest.json中显式配置："statusBarStyle": "dark" - 或直接在
unpackage/res/android/AndroidManifest.xml的<application>标签下加：android:windowLightStatusBar="true"
iOS 需启用 UIViewControllerBasedStatusBarAppearance
iOS 默认由系统统一管理状态栏样式，style 参数会被无视，除非你在原生工程中关闭全局控制。检查 Info.plist 是否有：
<key>UIViewControllerBasedStatusBarAppearance</key> <true/>
如果值为 false 或缺失，JS 调用全部无效。另外注意：
- 某些自定义基座的
AppDelegate.m里可能硬编码了[UIApplication sharedApplication].statusBarStyle = UIStatusBarStyleDefault，这会锁死样式 - iOS 13+ 引入了
overrideUserInterfaceStyle，若你的页面启用了暗黑模式但未透传，状态栏文字可能被系统覆盖
自定义导航栏（navigationStyle: "custom"）时，navigationBarTextStyle 失效
一旦设为 "custom"，navigationBarTextStyle 就不再控制状态栏文字颜色——它此时只影响你手写的 HTML 导航栏组件。真正起效的是：
- App 端：必须调用
plus.navigator.setStatusBarStyle("light")或"dark"（注意：这个 API 比uni.setNavigationBarColor更底层，且只在onReady后可用） - 微信小程序端：需确保
app.json全局设为"navigationStyle": "custom"，否则子页面配置不继承 - H5 端：完全不可控，所有“模拟”都是视觉欺骗，实际状态栏仍是系统默认
真机测试时，小米 MIUI、华为 EMUI 等厂商系统会强制跟随系统深色模式，JS 设置可能被覆盖——这时得监听系统变化并重设，而不是只依赖初始化一次。
