@oh-expo/expo-battery

让 expo-battery（电池信息与状态事件）在 HarmonyOS / OpenHarmony 上运行的适配包。 通过 expo-modules-core 体系提供 ExpoBatteryModule 原生模块（模块名 ExpoBattery： 6 方法 + 3 事件，接口收口自 [email protected] 权威 d.ts）。

支持基线

| 项 | 值 | | --- | --- | | 适配目标 | [email protected] | | 运行时底座 | @expo-harmony/[email protected]（本地 HAR） | | 鸿蒙 SDK | API 26（SDK 26.0.0 锚定，@kit.BasicServicesKit：batteryInfo/power/commonEventManager） | | 权限 | 无 |

实现面（接口收口 + 诚实分级）

方法：isAvailableAsync（isBatteryPresent）/ getBatteryLevelAsync（batterySOC/100，无电池返回 -1）/ getBatteryStateAsync（chargingStatus → UNKNOWN/UNPLUGGED/CHARGING/FULL）/ isLowPowerModeEnabledAsync（power.getPowerMode：POWER_SAVE/EXTREME/CUSTOM）/ getPowerStateAsync（PowerState 组合）/ isBatteryOptimizationEnabledAsync （Android 专属 → 恒 false，诚实分级）。

事件（onStartObserving/onStopObserving + 订阅重试与退订隔离）： Expo.batteryLevelDidChange / Expo.batteryStateDidChange / Expo.powerModeDidChange （commonEventManager 订阅 COMMON_EVENT_BATTERY_CHANGED / COMMON_EVENT_POWER_SAVE_MODE_CHANGED， 后台暂停、前台恢复后补发快照）。

快速开始（宿主接入）

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

构建与校验

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

状态与来源

• ⚠️ 实现已落盘（参照 renbaoshuo/expo-harmony 的 expo-battery 适配，MIT，来源致谢）； 编译与宿主接入验证状态见 expo-harmony 主仓 [acceptance/ledger.md]（S4 前置门口径）。
• 适配细节与接口规格：expo-harmony 主仓 docs/adaptations/expo-battery.md。