@oh-expo/expo-system-ui

让 expo-system-ui（根视图背景色/界面风格）在 HarmonyOS / OpenHarmony 上运行的适配包。 通过 expo-modules-core 体系提供 ExpoSystemUIModule 原生模块 + ExpoSystemUIRootView rootViewComponents（模块名 ExpoSystemUI：setBackgroundColorAsync/getBackgroundColorAsync， 接口收口自 [email protected] 权威 d.ts）。

支持基线

| 项 | 值 | | --- | --- | | 适配目标 | [email protected] | | 运行时底座 | @expo-harmony/[email protected]（本地 HAR） | | 鸿蒙 SDK | API 26（SDK 26.0.0 锚定，@kit.ArkUI window + @kit.AbilityKit + @kit.ArkData preferences） | | 权限 | 无 |

实现面（接口收口 + 集成形态）

• setBackgroundColorAsync(color)（processed 32 位 ARGB 颜色；null 复位跟随系统）/ getBackgroundColorAsync()（hex 暴露色）；
• 集成形态：ExpoSystemUIModule（模块）+ ExpoSystemUIRootView（rootViewComponents， 预 JS 阶段 attachSystemUIRoot 即应用背景/界面风格）；
• 界面风格（manifest 元数据 expo.harmony.userInterfaceStyle：light/dark/automatic → setColorMode，API 18+ 收窄）+ 背景持久化（preferences）+ environment 回调自动刷新。

快速开始（宿主接入）

0. 安装（npm）：npm install @oh-expo/expo-system-ui（peer 自动带 expo-system-ui 原包与 expo-modules-core）；
1. 从 node_modules/@oh-expo/expo-system-ui/local-hars/ 拷贝 expo_system_ui.har 到宿主 harmony/local-hars/，宿主 oh-package.json5 依赖 "@oh-expo/expo-system-ui": "file:local-hars/expo_system_ui.har" （ohpm 公共源无 @oh-expo scope，本地 HAR 必须用相对路径）；
2. expo-modules 体系模块经 expo-modules-core 运行时注册（含 rootViewComponents，无需改 RNOHPackagesFactory）；
3. JS 侧直接 import * as SystemUI from 'expo-system-ui'（对外契约由原包提供）。

构建与校验

pnpm har:prepare    # hvigorw assembleHar → local-hars/expo_system_ui.har
pnpm har:prepack    # 发布前校验（必需文件 / scope / -harmony.N 版本 / HAR 产物）

状态与来源

• ⚠️ 实现已落盘（接口收口自 npm 实包权威 d.ts，锚定 SDK 26 真实 API）； 编译与宿主接入验证状态见 expo-harmony 主仓 [acceptance/ledger.md]（S4 前置门口径）。
• 适配细节与接口规格：expo-harmony 主仓 docs/adaptations/expo-system-ui.md。