React Native for OpenHarmony (RNOH)

本项目为 React Native 跨平台应用开发框架添加 OpenHarmony 平台支持

角色 / Role	中文文档	English Docs
应用开发者 / Application Developer	README.md	README.md
库开发者 / Library Developer	—	README.md
维护者或贡献者 / Maintainer or Contributor	启动开发	README.md

RNOH版本演进规划和分支策略

💡 该用哪个版本：本仓库默认分支 main 为版本演进分支（当前承载新版本探索开发，不保证稳定性），生产环境请勿直接依赖；生产接入请安装 npm dist-tag 0.XX-stable 形式的稳定版（如 @react-native-oh/react-native-harmony@0.82-stable，命名对齐上游 react-native，随迭代自动前移）。当前推荐：新项目生产接入首选 0.82-stable（最新 GA）。各版本线状态一览见 稳定版本识别与安装 · 推荐版本判定表。

您可以在 RNOH 社区版路线图 中了解更多关于我们对 React Native 的 OpenHarmony 适配版本的说明。

启动开发

前置条件

1. HarmonyOS NEXT 模拟器或真机：本项目需要在HarmonyOS NEXT上进行测试
2. 华为开发者账号：运行应用程序时，需要用到华为开发者账号对应用进行签名
3. DevEco Studio：从官网下载并安装最新版本 DevEco Studio
4. 参考官网指导安装 Node.js >= 18的版本

框架开发

您可以连接测试机或模拟器后在bash中执行如下命令，之后直接从第8步开始

git clone https://atomgit.com/CPF-RN/ohos_react_native.git && cd ohos_react_native && git switch 0.82-main && npm install -g pnpm@latest-10 && pnpm init-ws && pnpm dev

1. 拉取本项目代码 git clone https://atomgit.com/CPF-RN/ohos_react_native.git
2. 进入项目目录 cd ohos_react_native
3. 对 React Native 0.82 版本的适配当前在特性分支上进行，切换到该分支 git switch 0.82-main
4. 安装pnpm npm install -g pnpm@latest-10
5. 进行项目初始化 pnpm init-ws （过程中会拉取一批submodule和安装npm依赖，受网速影响可能耗时较长）
6. 连接设备并开启usb调试功能，或启动模拟器
7. 启动 metro 和测试工具 pnpm dev
8. 在 DevEco Studio 中打开 packages/tester/harmony 项目并等待后台同步完成
9. 点击 File > Project Structure > Signing Configs，登录并完成签名
10. 在右上角选择项目配置下拉中选中 entry
11. 点击右上角绿色三角箭头【Run 'entry'】按钮，运行项目

说明： tester项目主要在开发过程中用于自测试，如在运行tester中的用例时遇到问题，请提issue咨询。

使用说明

• React Native的使用问题可查阅React Native 官网或React Native 中文网。
• RNOH的使用问题可查阅中文文档或英文文档。