@oh-expo/expo-network

让 expo-network（网络状态）在 HarmonyOS / OpenHarmony 上运行的适配包。 通过 expo-modules-core 体系提供 ExpoNetworkModule 原生模块（模块名 ExpoNetwork： 3 方法 + onNetworkStateChanged 事件，接口收口自 [email protected] 权威 d.ts）。

支持基线

| 项 | 值 | | --- | --- | | 适配目标 | [email protected] | | 运行时底座 | @expo-harmony/[email protected]（本地 HAR） | | 鸿蒙 SDK | API 26（SDK 26.0.0 锚定，@kit.NetworkKit connection + @kit.BasicServicesKit settings） | | 权限 | 无（网络状态读取为系统公开 API） |

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

• getNetworkStateAsync：getDefaultNet → getNetCapabilities（bearerTypes → CELLULAR/WIFI/ BLUETOOTH/ETHERNET/VPN/UNKNOWN；isInternetReachable = 已连接 && INTERNET+VALIDATED 双标志）；
• getIpAddressAsync：getConnectionProperties 链路地址取首个可用 IPv4（0.0.0.0 兜底）；
• isAirplaneModeEnabledAsync：settings.general.AIRPLANE_MODE_STATUS；
• onNetworkStateChanged 事件：createNetConnection（netAvailable/netLost/netUnavailable/ netCapabilitiesChange + 250ms 去抖 + 退避重试 5 次 + 退订隔离）。
• 诚实分级：WIMAX/OTHER 枚举无对应鸿蒙能力不映射；无默认网返回 UNKNOWN/NONE 语义对齐 iOS。

快速开始（宿主接入）

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

构建与校验

pnpm har:prepare    # hvigorw assembleHar → local-hars/expo_network.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-network.md。