@oh-expo/expo-application
v55.0.19-harmony.0
Published
expo-application 的 HarmonyOS 适配包(ExpoModule 原生模块,expo-modules-core 体系)
Maintainers
Readme
@oh-expo/expo-application
让 expo-application(应用信息)在 HarmonyOS / OpenHarmony 上运行的适配包。
通过 expo-modules-core 体系提供 ExpoApplicationModule 原生模块(模块名 ExpoApplication:
4 常量 + 2 方法,接口收口自 [email protected] 权威 d.ts)。
支持基线
| 项 | 值 |
| --- | --- |
| 适配目标 | [email protected] |
| 运行时底座 | @expo-harmony/[email protected](本地 HAR) |
| 鸿蒙 SDK | API 26(SDK 26.0.0 锚定,@ohos.bundle.bundleManager + @ohos.deviceInfo + resourceManager) |
| 权限 | 无 |
实现面(接口收口 + 诚实分级)
- 常量:
applicationName(labelResource/labelId 资源解析,label 兜底)/applicationId(BundleInfo.name)/nativeApplicationVersion(versionName)/nativeBuildVersion(versionCode 字符串化); - 方法:
getInstallationTimeAsync(firstInstallTime,API 18+ 收窄)/getLastUpdateTimeAsync(updateTime),时间戳安全整数校验。 - 诚实分级:
getAndroidId/getInstallReferrerAsync(Android 专属)、getIosIdForVendorAsync/getIosApplicationReleaseTypeAsync/getIosPushNotificationServiceEnvironmentAsync(iOS 专属)无对应鸿蒙能力,harmony 侧不注册。
快速开始(宿主接入)
- 安装(npm):
npm install @oh-expo/expo-application(peer 自动带 expo-application 原包与 expo-modules-core); - 从
node_modules/@oh-expo/expo-application/local-hars/拷贝expo_application.har到宿主harmony/local-hars/,宿主oh-package.json5依赖"@oh-expo/expo-application": "file:local-hars/expo_application.har"(ohpm 公共源无 @oh-expo scope,本地 HAR 必须用相对路径); - expo-modules 体系模块经 expo-modules-core 运行时注册(无需改 RNOHPackagesFactory);
- JS 侧直接
import * as Application from 'expo-application'(对外契约由原包提供)。
构建与校验
pnpm har:prepare # hvigorw assembleHar → local-hars/expo_application.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-application.md。
