@expo-oh/expo-constants 18.0.14 → 18.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +79 -17
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,36 +1,98 @@
1
1
  # @expo-oh/expo-constants
2
2
 
3
- HarmonyOS adaptation of expo-constants@18.0.14.
3
+ Expo Constants 的 HarmonyOS 适配版本，提供嵌入应用配置以及设备、窗口和运行环境信息。
4
4
 
5
- Install using the original dependency key:
5
+ 上游基线：`expo-constants@18.0.14`。本包由 [expo-harmony-cli](https://github.com/stonehill-2345/expo-harmony-cli) 项目维护，非 Expo 官方发行版本。
6
6
 
7
- `npm install --save-exact expo-constants@npm:@expo-oh/expo-constants@18.0.14`
7
+ [鸿蒙快速开始](https://github.com/stonehill-2345/expo-harmony-cli/blob/main/docs/harmony/getting-started.md) · [适配源码](https://github.com/stonehill-2345/expo-harmony-cli/tree/main/packages/expo-constants) · [验收记录](https://github.com/stonehill-2345/expo-harmony-cli/blob/main/docs/releases/2026-10-09-sdk54-expo-oh-candidate.md) · [问题反馈](https://github.com/stonehill-2345/expo-harmony-cli/issues)
8
8
 
9
- Release: sdk54-expo-oh-harmony.0. See the repository release plan for supported capabilities. Upstream documentation follows.
9
+ ## 安装
10
10
 
11
- # expo-constants
11
+ 以下命令适用于已经配置好 `@expo-oh` SDK54 依赖组合的项目。普通 Expo 项目请先阅读[鸿蒙快速开始](https://github.com/stonehill-2345/expo-harmony-cli/blob/main/docs/harmony/getting-started.md)；仅安装此包不会自动完成 RNOH 和原生工程配置。
12
12
 
13
- Provides system information that remains constant throughout the lifetime of your app.
13
+ ```bash
14
+ # npm
15
+ npm install --save-exact expo-constants@npm:@expo-oh/expo-constants@18.0.15
14
16
 
15
- # API documentation
17
+ # pnpm
18
+ pnpm add --save-exact expo-constants@npm:@expo-oh/expo-constants@18.0.15
19
+ ```
20
+
21
+ 保留原依赖键：
16
22
 
17
- - [Documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/constants/)
18
- - [Documentation for the main branch](https://docs.expo.dev/versions/unversioned/sdk/constants/)
23
+ ```json
24
+ {
25
+ "dependencies": {
26
+ "expo-constants": "npm:@expo-oh/expo-constants@18.0.15"
27
+ }
28
+ }
29
+ ```
19
30
 
20
- # Installation in managed Expo projects
31
+ 本包的鸿蒙适配已包含在 npm 产物中，无需额外应用本包的本地 patch。使用完整依赖组合及 overrides，保留锁文件；不要混装另一组 SDK 版本。
21
32
 
22
- For [managed](https://docs.expo.dev/archive/managed-vs-bare/) Expo projects, please follow the installation instructions in the [API documentation for the latest stable release](https://docs.expo.dev/versions/latest/sdk/constants/).
33
+ ## 使用方式
23
34
 
24
- # Installation in bare React Native projects
35
+ 在 `app.json` 中定义公开应用配置：
36
+
37
+ ```json
38
+ {
39
+ "expo": {
40
+ "name": "My Harmony App",
41
+ "slug": "my-harmony-app"
42
+ }
43
+ }
44
+ ```
25
45
 
26
- For bare React Native projects, you must ensure that you have [installed and configured the `expo` package](https://docs.expo.dev/bare/installing-expo-modules/) before continuing.
46
+ 业务代码继续从原包名读取配置：
27
47
 
28
- ### Add the package to your npm dependencies
48
+ ```tsx
49
+ import Constants from "expo-constants";
50
+ import { Text } from "react-native";
29
51
 
52
+ export default function App() {
53
+ return <Text>{Constants.expoConfig?.name ?? "未配置应用名称"}</Text>;
54
+ }
30
55
  ```
31
- npx expo install expo-constants
56
+
57
+ 配置由构建流程生成并嵌入 `app.config`，修改后需要重新生成并构建原生工程。公开配置会进入客户端，请勿放入服务端密钥。
58
+
59
+ ## 鸿蒙支持范围
60
+
61
+ | API / 字段 | HarmonyOS 实现与限制 |
62
+ | --- | --- |
63
+ | expoConfig | 公共 JS 读取嵌入配置；缺少 app.config 时原生 manifest 为 null，格式错误会报错 |
64
+ | deviceName / systemVersion | 分别来自设备型号与系统版本信息 |
65
+ | statusBarHeight | 从窗口系统避让区域读取，并转换为布局单位 |
66
+ | systemFonts | 从系统字体接口读取 |
67
+ | sessionId / debugMode | 原生模块会话 UUID 和 RNOH 调试状态 |
68
+ | getWebViewUserAgentAsync | 从 ArkWeb 获取默认 User Agent |
69
+ | Expo Go 专属信息 | 不合成 Expo Go 数据；expoVersion、expoRuntimeVersion 等原生值为 null |
70
+
71
+ 以上是当前源码行为。发布组合已完成模板安装与运行验证，不代表所有字段均已逐项完成设备验收。
72
+
73
+ ## 生成和运行原生工程
74
+
75
+ 从已配置项目根目录执行：
76
+
77
+ ```bash
78
+ npx expo prebuild --platform harmony
79
+ npx expo run:harmony
32
80
  ```
33
81
 
34
- # Contributing
82
+ 日常开发启动 Metro：`npx expo start`。安装或更新原生依赖、应用配置后，需要重新生成并构建；重启 Metro 不能替代原生构建。
83
+
84
+ 兼容基线为 Expo SDK54、React 19.1.1、React Native 0.82.1、RNOH 0.82.30。设备、DevEco、签名要求见[快速开始](https://github.com/stonehill-2345/expo-harmony-cli/blob/main/docs/harmony/getting-started.md)。普通 Expo Go 不能作为本组合的鸿蒙运行容器。
85
+
86
+ ## 排查与反馈
87
+
88
+ - 安装后版本或功能不符：检查 package.json alias、overrides 和锁文件，使用 `npx expo install --check` 核对受管组合。
89
+ - 原生模块缺失或更新无效：确认使用同组合的 Core/Autolinking，重新 prebuild、构建并安装。
90
+ - 旧 patch 项目不会自动迁移；保留原项目，按指南新建项目后迁移业务代码，不叠加旧补丁。
91
+
92
+ 请在[本仓库 Issues](https://github.com/stonehill-2345/expo-harmony-cli/issues) 提供包版本、RNOH/系统版本、设备类型、最小复现及日志。已记录的模板运行结果不代表全部 API 或所有设备均已验证。
93
+
94
+ ## 上游与许可证
35
95
 
36
- Contributions are very welcome! Please refer to guidelines described in the [contributing guide](https://github.com/expo/expo#contributing).
96
+ - [上游参考](https://docs.expo.dev/versions/v54.0.0/sdk/constants/)：用于通用 API 或原始包说明；HarmonyOS 支持以本文为准。
97
+ - 原始来源：[Expo 源码](https://github.com/expo/expo/tree/main/packages/expo-constants)。
98
+ - 保留上游许可证和来源声明，详见包内 `LICENSE`。遵循 Expo 上游 MIT 许可证。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expo-oh/expo-constants",
3
- "version": "18.0.14",
3
+ "version": "18.0.15",
4
4
  "private": false,
5
5
  "description": "Provides system information that remains constant throughout the lifetime of your app.",
6
6
  "main": "build/Constants.js",
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "author": "650 Industries, Inc.",
39
39
  "license": "MIT",
40
- "homepage": "https://github.com/stonehill-2345/expo-harmony-cli#readme",
40
+ "homepage": "https://github.com/stonehill-2345/expo-harmony-cli/blob/main/packages/expo-constants/README.md",
41
41
  "jest": {
42
42
  "preset": "expo-module-scripts"
43
43
  },