最近用 React Native 把一个小型 TodoList 完整跑到了 OpenHarmony 设备上,任务卡片的阴影效果前后调了两天。这个项目本身不复杂,复杂的是“RN + OpenHarmony”这个组合。React Native 在 Android 和 iOS 上已经非常成熟,但到了 OpenHarmony 上,你会发现很多“想当然能用”的写法都处于薛定谔状态——尤其是阴影这种纯视觉的东西,看起来很基础,真落地时却处处是坑。这篇文章就围绕这个 TodoList 项目,把三件事讲透:RN for OpenHarmony 的工程怎么搭、任务增删改怎么做、阴影效果为什么要在 OpenHarmony 上单独处理。
如果你是第一次在 OpenHarmony 上跑 RN,或者你只是好奇阴影这类样式在非 Android/iOS 平台上的表现差异,这篇实战记录应该都能帮你省点时间。
1. 为什么我会在 OpenHarmony 上跑 React Native
1.1 从跨端选型说起:为什么不是 ArkUI 原生
先说结论:能用 ArkUI 原生写,就用 ArkUI 原生写。我这次选 RN,纯粹是因为团队里已经有大量现成的 React Native 业务代码,前端同学不需要为了一个小项目重学 ArkTS 和 ArkUI 的声明式写法,迁移成本是决定性因素。
如果你是从零开始做一个 OpenHarmony 应用,没必要绕一圈跑到 RN 上来。ArkUI 原生对系统能力的调用最直接,性能也最有保障,而且 DevEco Studio 对 ArkUI 的调试支持明显比 RN 适配层要完整。但如果你像我一样,手里已经有一个跨端 RN 项目,想低成本跑上 OpenHarmony 设备,那么 RN for OpenHarmony 这套社区方案值得一试。
Flutter 在 OpenHarmony 上也有社区适配,但发布节奏和工具链成熟度目前都要打个问号。相比之下,RN 的 JavaScript 生态更庞大,前端工程师的上手门槛更低,而且 Metro 打包、热更新这些基础设施在 OpenHarmony 上已经有可用的实现。所以我的选型排序是:ArkUI 原生 > RN > Flutter。
1.2 新老架构的坑:选对 RN 版本比写代码更重要
RN 圈最近最热的词之一就是新老架构对比。老架构通过 Bridge 做异步序列化通信,新架构用 JSI 实现 JS 和原生之间的直接调用,性能提升明显,但代价是原生模块必须按 JSI 的规范重新封装。
这个对比在 OpenHarmony 上意味着什么?意味着适配层的工作量会差一个量级。OpenHarmony 的 RN 适配仓库通常优先支持老架构,因为老架构的 Bridge 协议稳定、实现简单。而新架构的 Fabric 渲染器、TurboModules、CodeGen 这套东西对原生侧的要求高很多,适配层需要为 OpenHarmony 的 ArkUI 组件做专门映射,进度自然慢。
我当时选型的原则很简单:用社区适配仓库明确支持的稳定版本,不追求最新也不碰新架构特性。RN 不是越新越好,在 OpenHarmony 上,适配层的支持情况才是真正的版本天花板。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 搭一个能跑起来的 RN 开发环境
2.1 工程骨架与依赖版本锁定
RN for OpenHarmony 的开发流程和标准 RN 略微不同。标准 RN 里,react-native 包自带 Android 和 iOS 工程;但 OpenHarmony 上你要额外引入一个 ArkTS 壳工程,这个壳工程负责创建 HarmonyOS 的 Ability 和页面,然后在里面加载 RN 的 JS 运行时。
我这次的项目结构大致长这样:
text复制RNTodo
├── app.json
├── index.js
├── src
│ ├── components
│ │ └── TaskCard.js
│ ├── screens
│ │ └── TodoScreen.js
│ └── store
│ └── todoReducer.js
├── harmony
│ ├── entry
│ │ └── src
│ │ └── main
│ │ ├── ets
