认识 CPF-RN：React Native 鸿蒙官方社区与四大核心仓库

组织地址：https://atomgit.com/CPF-RN
数据抓取：2026-09-04（AtomGit 实时数据）
一句话定位：让 React Native 应用无缝运行于鸿蒙生态的官方开源社区

一、CPF-RN 是一个什么样的组织？

CPF-RN（Cross Platform Framework - React Native） 是 React Native 鸿蒙化的官方社区组织，由华为 OpenHarmony React Native SIG 发起并运营。它的使命在核心仓库首页写得很清楚：

将 React Native 开发体验完整带入鸿蒙生态（OpenHarmony）。高性能桥接、完整 Fabric 支持，让 RN 应用无缝运行于鸿蒙。

组织概况：

维度数据
组织类型官方社区（OpenHarmony React Native SIG）
成立时间2024-11-27（首个仓库创建）
成员规模43 位成员
关注者61 位
仓库形态1 个核心框架仓库 + 大量 rntpc_* 三方组件仓库 + 文档/skills 仓库

CPF-RN 承担着 RN 鸿蒙化「从框架到生态」的完整链条：框架适配（ohos_react_native）→ 三方库移植（rntpc_*）→ 使用文档（usage-docs）→ 智能开发（skills）→ 鸿蒙特色能力（rn_ohfeatures）。

二、四大重点仓库

1. ohos_react_native —— RNOH 框架本体（核心）

维度数据
仓库atomgit.com/CPF-RN/ohos_react_native
定位React Native for OpenHarmony（RNOH）框架主仓库
数据403★ / 494 fork / 53 open issues / MIT 协议
语言C++（桥接层）+ TypeScript/ArkTS
创建2024-11-27

这是什么：RNOH 框架的唯一事实来源，是 @react-native-oh/react-native-harmony 及相关 npm 包的上游工程。它让 RN 应用可以不改业务代码直接跑在鸿蒙设备上。

仓库亮点：

  • 中文文档体系完整：docs/zh-cn/ 覆盖设计（01-设计）、开发（02-开发）、调测（03-调测）、调优（04-调优）、运维（05-运维）、社区（06-社区）六大类
  • 版本管理清晰：以 0.XX-stable npm dist-tag（如 0.72-stable、0.84-stable）标注各版本线最新稳定版，命名对齐上游 react-native
  • AI 友好：RNOH 语料已进入 Gemini / DeepSeek / GLM 等主流 AI 模型；README 内置稳定性/性能/工程问题的定位工作流与 AI 提示词模板
  • 社区规范齐全：issue / commit / PR / changelog / 分支 / 包管理六类规范文件

适合谁：想在鸿蒙上跑 RN 的应用开发者（读使用文档）、想深入桥接层的库/框架开发者（读设计文档与源码）、想共建的贡献者（读社区规范）。

2. usage-docs —— 三方库使用文档中心（生态）

维度数据
仓库atomgit.com/CPF-RN/usage-docs
定位HarmonyOS 上 RNOH 三方库的使用指导与信息总览
数据19★ / 169 fork / 96 open issues / Apache-2.0 / 孵化标签
语言Markdown
创建2026-02-03

这是什么：一份持续更新的三方库「百科全书」，帮助开发者在鸿蒙平台使用 React Native OpenHarmony 的第三方库。它不重复框架文档，只专注「每个库在鸿蒙上怎么用」。

仓库亮点：

  • NPM 公仓坐标统一：@react-native-ohos（如 @react-native-ohos/async-storage）
  • 鸿蒙化原生库表格：上百个库逐行列出——原库名 ↔ 鸿蒙化库名 ↔ npm 发布地址 ↔ 文档链接 ↔ 各版本线支持情况（0.72 / 0.77 / 0.82）↔ 功能分类
    • 覆盖类别：数据库、图像、系统功能集成、媒体显示、性能、布局等
  • JS 三方库清单：axios、redux、mobx、dayjs、i18next 等 30+ 纯 JS 库——已在鸿蒙适配，无需改代码直接可用
  • 三个关键技术说明：Codegen（使用前需生成桥接代码）、C-API 架构（三方库后续只基于 RN C-API 演进）、补丁化移植（避免影响原库其他平台）

适合谁：所有在鸿蒙上用 RN 的开发者——「我的库鸿蒙支持吗？」来这里一查便知。

3. skills —— RNOH AI Agent 技能库（智能开发）

维度数据
仓库atomgit.com/CPF-RN/skills
定位RNOH AI agent skills（@react-native-oh/kit）
数据7★ / 15 fork / 2 open issues / MIT
语言Markdown（skill 定义）
创建2026-04-15

这是什么：把 RNOH 社区验证过的良好实践固化成了 14 个 AI skills，经 npx 安装后由 opencode 等 agent 自动发现使用。核心理念是——让 agent 不再凭训练数据猜测、不再因版本错位给错建议。

仓库亮点：

  • 安装即用：npx @react-native-oh/kit add（装全部）/ add <skill>（装单个）/ init（探测项目版本生成 AGENTS.md 上下文）/ list
  • 14 个 skill 覆盖 RNOH 开发者全旅程：
    • 版本升级（rnoh-dev-version-upgrade）
    • 环境配置（如 rnoh-dev-env-setup）
    • 脚手架初始化
    • 稳定性/崩溃定位
    • 三方库鸿蒙化流水线
    • PR 提交规范等
  • 工程化质量保障：自带 make lint（PR 门禁）+ make eval（基线场景运行器，确定性 checker），确保 skill 质量可评估
  • 完整文档：overview（是什么/为什么/14 清单/架构）、usage（安装/使用）、contributing（共建）、skill-standard（frontmatter/命名/正文规范）

适合谁：用 AI 辅助开发 RNOH 项目的开发者；想把鸿蒙化经验沉淀成 AI 技能的布道者。

4. rn_ohfeatures —— 鸿蒙特色能力封装（差异化）

维度数据
仓库atomgit.com/CPF-RN/rn_ohfeatures
定位为 RN 页面提供 OpenHarmony 特征的接口与组件库
数据11★ / 20 fork / 2 open issues / Apache-2.0
语言TypeScript
创建2025-03-17

这是什么：解决「React Native 页面与 OpenHarmony 特性不一致」问题的官方方案——让 RN 开发者在不动原生代码的前提下，在 JS/TS 侧用上鸿蒙独有的系统能力。

仓库亮点（packages/ 下 9 个开箱即用能力包）：

包名能力
react_native_picker鸿蒙系统选择器（日期/时间/文本）
react_native_intents鸿蒙意图框架（跨应用能力调用）
react_native_vibrator鸿蒙系统振动
react_native_moving_photo动态照片（实况照片）能力
react_native_media_processing媒体处理
react_native_distributed_pasteboard分布式剪贴板（跨设备共享）
react_native_knock_share碰一碰分享
react_native_geometry_transition几何转场（连续过渡动画）
react_native_folderstack文件夹堆叠效果

另有配套 samples/ 示例工程，每个包都有对应 Demo，真正做到「开箱即用」。

适合谁：想让鸿蒙 App 有「鸿蒙味」的 RN 开发者——这些是 RN 生态里找不到等价物的差异化能力。

三、完整仓库版图（四大仓库之外）

类别代表仓库说明
E2E 测试detoxdetox for harmony
存储rntpc_react-native-mmkv微信 MMKV 鸿蒙适配（C++）
列表rntpc_flash-listShopify flash-list 鸿蒙版（23 fork，无白屏省内存）
手势rntpc_react-native-gesture-handler原生手势系统（27 fork）
媒体rntpc_react-native-video视频播放器（21 fork，ArkTS）
分页rntpc_react-native-pager-view分页视图容器（16 fork）
二维码rntpc_react-native-qrcode二维码生成（6★）
轮播rntpc_react-native-swiper-flatlistSwiper + FlatList
安全区rntpc_react-native-safe-area-view刘海/状态栏适配
图片react-native-image-zoom图片平移缩放

四、总结：从「能用」到「好用」到「智能」

CPF-RN 的仓库矩阵，恰好对应 RN 鸿蒙化的四个阶段：

ohos_react_native（框架本体）——让 RN 跑在鸿蒙上
   ↓
usage-docs（文档/三方库总览）+ rntpc_*（组件适配）——让常用能力可用
   ↓
rn_ohfeatures（鸿蒙特色能力）——让 App 有鸿蒙味、有差异化
   ↓
skills（AI 技能库）——让开发者与 AI 都能高效共建

对于开发者：查文档去 usage-docs、找组件看 rntpc_*、要特色用 rn_ohfeatures、想提效装 skills、要深入读 ohos_react_native。无论你处于哪个阶段，都能在 CPF-RN 找到自己的位置——这也正是它作为「React Native 鸿蒙官方社区」的价值所在。

附录：重点仓库链接

组织入口

  • CPF-RN 组织主页：https://atomgit.com/CPF-RN

四大核心仓库

仓库定位链接
ohos_react_nativeRNOH 框架本体（核心）https://atomgit.com/CPF-RN/ohos_react_native
usage-docs三方库使用文档中心（生态）https://atomgit.com/CPF-RN/usage-docs
skillsRNOH AI Agent 技能库（智能开发）https://atomgit.com/CPF-RN/skills
rn_ohfeatures鸿蒙特色能力封装（差异化）https://atomgit.com/CPF-RN/rn_ohfeatures

rntpc_* 三方组件仓库（正文提及）

类别仓库链接
E2E 测试detoxhttps://atomgit.com/CPF-RN/detox
存储rntpc_react-native-mmkvhttps://atomgit.com/CPF-RN/rntpc_react-native-mmkv
列表rntpc_flash-listhttps://atomgit.com/CPF-RN/rntpc_flash-list
手势rntpc_react-native-gesture-handlerhttps://atomgit.com/CPF-RN/rntpc_react-native-gesture-handler
媒体rntpc_react-native-videohttps://atomgit.com/CPF-RN/rntpc_react-native-video
分页rntpc_react-native-pager-viewhttps://atomgit.com/CPF-RN/rntpc_react-native-pager-view
二维码rntpc_react-native-qrcodehttps://atomgit.com/CPF-RN/rntpc_react-native-qrcode
轮播rntpc_react-native-swiper-flatlisthttps://atomgit.com/CPF-RN/rntpc_react-native-swiper-flatlist
安全区rntpc_react-native-safe-area-viewhttps://atomgit.com/CPF-RN/rntpc_react-native-safe-area-view
图片react-native-image-zoomhttps://atomgit.com/CPF-RN/react-native-image-zoom

rn_ohfeatures 鸿蒙特色能力组件（正文提及）

能力包链接
react_native_picker（系统选择器）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_picker
react_native_intents（意图框架）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_intents
react_native_vibrator（系统振动）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_vibrator
react_native_moving_photo（动态照片）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_moving_photo
react_native_media_processing（媒体处理）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_media_processing
react_native_distributed_pasteboard（分布式剪贴板）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_distributed_pasteboard
react_native_knock_share（碰一碰分享）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_knock_share
react_native_geometry_transition（几何转场）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_geometry_transition
react_native_folderstack（文件夹堆叠）https://atomgit.com/CPF-RN/rn_ohfeatures/tree/master/packages/react_native_folderstack

本文基于 AtomGit 2026-09-04 实时数据整理，各仓库版本与数据随社区迭代持续更新。

# react native # harmonyos # react.js
Logo
人工智能6S服务平台

作为“人工智能6S店”的官方数字引擎，为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐

cover

【共创稿事节】空间设计工具链：从Figma到DevEco Studio的协作流

avatar 人工智能6S服务平台
cover

【共创稿事节】从“像素级还原“到“体验级设计“：空间设计价值跃迁

avatar 人工智能6S服务平台

从 0 到 1：用 CJMP 开发「每日早报」鸿蒙应用完整实战

从零到真机运行，最大的成本不在写功能，而在理解 Cangjie 与 HarmonyOS Kit 的对接约定。坑一句话解法1后符号 undeclared逐符号导入2回调参数报错/类型对不上回调是3请求抛异常闪退request()声明，需try/catch4闪退先查是否声明INTERNET权限5网络回调里更新@State要包6枚举成员写错（驼峰），不是POST7响应是字节数组，兜底8match 报 n

avatar 人工智能6S服务平台