React Native for OpenHarmony 开发者文档
本文档适合具有 React Native 基础的开发者使用。在阅读前，建议先学习 React Native 官方文档。
开发者旅程导航
| 旅程阶段 | 目录 | 核心内容 |
|---|---|---|
| 📐 设计 | 01-设计 | 接口规格、架构规划、通信机制 |
| 💻 开发 | 02-开发 | 环境搭建、功能开发、组件定制 |
| 🔍 调测 | 03-调测 | 调试方法、问题定位、FAQ |
| ⚡ 调优 | 04-调优 | 性能优化、实践案例 |
| 🔧 运维 | 05-运维 | 版本管理、稳定性管理、构建打包 |
| 🌐 社区 | 06-社区 | 社区规范、共建指南 |
目录结构
docs/zh-cn/
│
├── 01-设计/ # 设计阶段
│ ├── 框架介绍.md # RNOH 整体介绍
│ ├── 架构介绍.md # 技术架构详解
│ ├── 渲染三阶段.md # 渲染流程原理
│ ├── ArkTS与CPP之间通信.md # Native通信机制
│ ├── 两端通讯.md # JS-Native通信
│ ├── API接口说明.md # 接口规格文档
│ ├── 规格类FAQ.md # 规格相关问题
│ └── README.md
│
├── 02-开发/ # 开发阶段
│ ├── 01-环境与工具/ # 环境与工具 ⚡版本相关
│ │ ├── 环境搭建.md # 开发环境配置
│ │ ├── SDK版本配置指导.md # SDK版本选择
│ │ └── 示例工程索引.md # 示例工程列表
│ ├── 02-开发指南/ # 开发指南
│ │ ├── 功能开发.md # 开发流程指南
│ │ ├── 自定义组件.md # 组件开发指南
│ │ ├── Codegen.md # 代码生成工具
│ │ ├── TurboModule.md # TurboModule使用
│ │ ├── Autolinking.md # 自动链接配置 ⚡版本相关
│ │ ├── RN-Native接入.md # Native接入方案
│ │ ├── C-API组件混合方案的使用.md # C-API混合方案
│ │ └── 编译构建/
│ │ ├── 编译构建指南.md
│ │ └── RNOH构建与符号管理工程级指南.md
│ ├── 03-场景与实践/ # 场景与实践
│ │ ├── 常见开发场景.md # 场景化开发指南
│ │ ├── RN应用鸿蒙化开发指南.md # RN应用鸿蒙化开发全流程指南
│ │ ├── 场景化最佳实践.md # 最佳实践案例
│ │ └── 使用类FAQ.md # 开发相关问题
│ └── README.md
│
├── 03-调测/ # 调测阶段
│ ├── 调试调测.md # 调试工具与方法
│ ├── FAQ.md # FAQ总览
│ ├── 编译类FAQ.md # 编译问题排查
│ ├── 运行类FAQ.md # 运行问题排查
│ ├── 定位定界指导类FAQ.md # 问题定位方法
│ └── README.md
│
├── 04-调优/ # 调优阶段
│ ├── 性能调优.md # 性能优化指南
│ ├── 内存优化指导.md # 内存优化指导
│ └── 性能优化实践/
│ └── 页面转场与滑动场景优化.md
│ └── README.md
│
├── 05-运维/ # 运维阶段 ⚡版本相关
│ ├── 版本说明.md # 版本说明文档
│ ├── 版本升级指导.md # 版本升级指南
│ ├── RN升级需要开发者适配整理.md # RN升级适配清单
│ ├── 上游社区不兼容变更.md # 上游变更说明
│ ├── RN-JS打包.md # JS打包指南
│ ├── hvigorfile配置.md # 构建配置说明
│ ├── 多屏适配指导.md # 部署适配
│ ├── AI辅助问题定位指导.md # AI定位工具
│ ├── release-notes/ # 版本发布说明
│ ├── 稳定性历史修复/ # 稳定性修复汇总
│ ├── 稳定性编码规范/ # 稳定性编码规范
│ │ └── 稳定性编码规范.md
│ ├── 稳定性skill/ # 稳定性分析工具
│ │ ├── rnoh-stability-review/
│ │ └── rnoh-stability-triage/
│ ├── 稳定性问题介绍/ # 稳定性问题介绍
│ │ ├── 稳定性概览.md
│ │ ├── 稳定性分析方法.md
│ │ └── 稳定性案例.md
│ └── README.md
│
├── 06-社区/ # 社区治理
│ ├── 开发者文档共建指南.md # 文档共建规范
│ ├── roadmap.md # 社区路线图
│ ├── 社区规范/
│ │ ├── 社区issue管理规范.md
│ │ ├── 社区commit和pr规范.md
│ │ ├── 社区changelog规范.md
│ │ ├── 仓库分支管理规范.md
│ │ ├── rnoh包管理规范.md
│ │ └── 开发者共建指南.md
│ └── README.md
│
├── figures/ # 图片资源
└── public_sys-resources/ # 公共资源
⚡ 标记为「版本相关」的文档，随版本发布需同步更新
外部资源
- 三方库接入指南 - RNOH兼容的三方库列表
- 项目示例 Samples - 各类场景示例工程
- 维护者文档 - RNOH维护者专用文档
版本分类说明
| 类型 | 目录 | 维护策略 |
|---|---|---|
| 版本相关 | 02-开发/01-环境与工具（环境/SDK）、02-开发/02-开发指南（Autolinking）、05-运维（版本管理/稳定性历史修复） | 随版本发布同步更新 |
| 版本无关 | 01-设计、03-调测、04-调优、05-运维（稳定性编码规范/稳定性skill/稳定性问题介绍）、06-社区 | 独立维护，长期有效 |
贡献指南
参与文档共建请阅读 开发者文档共建指南。