在 OpenHarmony 系统上跑 React Native,再把一个经典 TodoList 做出漂亮的任务卡片阴影效果,这件事听起来像给自己找麻烦,但实际上是检验跨端框架适配水平的最佳方式。我花了两周时间,把 RN 工程从项目初始化一路做到 OpenHarmony 真机运行,期间反复打磨的核心细节正是任务卡片的阴影效果。最终结论有点出乎意料:阴影这个看起来只是一个 style 属性的东西,在 iOS、Android、OpenHarmony 三端背后走的是完全不同的渲染路径。你把这一条链路吃透了,基本就搞清楚了 RN 在 OpenHarmony 上的渲染适配现状。
这篇文章会把能运行的 TodoList 代码、阴影效果的踩坑过程、RN 新老架构对适配的影响,以及与电话拨打、图片裁剪库联动的经验一并整理出来。不论你是想评估 OpenHarmony 生态落地难度的移动端开发者,还是正在处理 React Native 跨端方案的团队,都可以把这篇当作一份能直接参考的实操笔记。
1. 项目选型与整体设计:为什么用 RN 在 OpenHarmony 上做 TodoList
1.1 从业务痛点出发:现有 RN 项目如何拥抱 OpenHarmony
先交代一下背景。我手头有一个已经同时在 iOS 和 Android 运行的 React Native 项目,业务逻辑基本共用一套 JS 代码,原生扩展通过公共模块管理。当设备侧需要支持 OpenHarmony 时,团队当时面临两条路线:一条是用 ArkTS 重新写一套界面,这个方向文档成熟、工具链完善,但意味着双套 UI、双份维护成本,而且之前积累的 RN 生态组件基本全部作废;另一条是评估 RN for OpenHarmony 的适配进度,尽量复用现有代码和组件库。
两条路我都做了技术预研。ArkTS 那条路走到一半,我发现业务逻辑迁移倒还好办,真正难的是 RN 生态里那些成熟库——图片裁剪、电话拨号、图表绘制等等——在 ArkUI 里往往没有现成对应物,要么自己封原生,要么从零写。而 RN 适配路线虽然也存在兼容性不确定性,但至少能把状态管理、网络层、UI 描述这些大部分业务代码原样带过去,性价比明显更高。
其实现在社区里问“OpenHarmony 能不能直接跑 RN”,答案不是非黑即白,关键看你对“能跑”的定义是什么。弹一个 Hello World 是一回事,跑一个完整业务模块是另一回事。从我实测的结论来看,凡是托管在 JS 层的逻辑——状态管理、网络请求、基础列表渲染——可用度已经相当不错;涉及原生侧自定义视图或者系统能力,就需要逐个模块去验证适配。所以项目一开场我就做了一个决策:不把一堆原生依赖一次性塞进工程,先用最少的原生模块跑通核心 UI 链路。这个决策后面被证明非常关键,它让排查范围始终聚焦在渲染和样式上,而不是在几十个原生依赖之间互相甩锅。
整个项目我用的是最经典的 TodoList 形态,但刻意把“任务卡片的阴影效果”作为主攻方向。选这个切入点是有意的:阴影够简单,任何做过移动端的开发者都能看懂;又够复杂,背后牵扯样式解析、渲染管线、原生绘制差异和性能优化一整条链路,刚好是评估 RN on OpenHarmony 成熟度的一个抓手。
1.2 RN 新老架构对比:OpenHarmony 适配走到了哪一步
聊到 RN 在 OpenHarmony 上的适配,新老架构的问题是绕不开的。React Native 的架构在近几年变化非常大,我用同一个项目分别跑过旧架构适配版本以及部分新架构特性的版本,体验差异值得展开。
旧架构的核心是 Bridge 桥接机制。JS 层和原生层之间隔了一条异步通道,所有跨层通信都要先序列化成消息队列,再逐条投递。你可以把 Bridge 理解成两栋楼之间的信件滑梯:请求封装成信丢进滑梯,原生处理完再把响应封装成信丢回来。好处是边界清晰、稳定安全,坏处是吞吐量有明显天花板。快速滚动列表这种高频交互场景,命令经过桥接排队后,帧率很容易被拖下来。RN for OpenHarmony 的早期适配正是在这条基线上做的,遇到复杂列表加动态样式,性能压力肉眼可见。
新架构则是另一种思路。Fabric 渲染器让 JS 直接持有 C++ 层对象的引用,TurboModule 让 JS 调用原生方法时不再做 JSON 序列化,改走 JSI(JavaScript Interface)直调。还是用前面的类比:旧架构是来回递信,新架构是面对面直连。效率提升非常大,但也对底层渲染引擎的集成提出了高得多的要求。
那么 OpenHarmony 适配目前落在哪里?从我的实践看,RN for OpenHarmony 当前以旧架构的工作方式为稳定性基线,核心组件比如 View、Text、ScrollView、FlatList 以及样式系统,已经有相当完整的映射。新架构在 OpenHarmony 上的落地进度相对靠后,因为需要把 Fabric 的渲染协调器接入到 OpenHarmony 的原生组件树上,这是一个工程量很大的底层工作,不是简单换个编译目标就能完成。
这个背景和阴影效果计划有直接关系。老架构适配版本里,样式解析走的是统一映射逻辑,新的渲染器则可能在阴影属性的计算方式上有差异。我的建议是:在把阴影样式从 iOS/Android 搬到 OpenHarmony 之前,先确认你用的 RN 适配版本采用的是哪套渲染管线,然后针对性查阅该版本对 shadow 系列属性的支持说明。这个工作不值得跳过,跳过了后面大概率会花几倍时间来排查“阴影怎么不生效”。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. TodoList 核心功能拆解与状态管理实现
2.1 任务数据模型与本地持久化
TodoList 看着简单,但真正写起来需要认真拆层。我把它分成三个层次:数据模型层、状态管理层、本地持久化层。
数据模型方面,任务对象我定义了五个字段:
typescript复制interface TodoItem {
id: string;
