OpenHarmony React Native Performance

核心用法

ohos-react-native-performance 是一套面向 OpenHarmony 平台 React Native（RNOH） 的性能优化静态检查技能，源自 OpenHarmony-SIG 官方性能调优文档。它通过可落地的规则前缀体系（rnoh-render-*、rnoh-bundle-*、rnoh-lifecycle-* 等），为开发者提供从代码编写到构建发布的全链路性能检查能力。

五大规则类别

| 优先级 | 类别 | 典型场景 |

|--------|------|---------|

| **CRITICAL** | 渲染优化 | `setState` 合并、避免重复渲染、PureComponent/Memo 使用、状态不可变更新 |

| **HIGH** | Bundle & 原生配置 | `--dev=false --minify=true` 生产构建、Hermes 字节码（HBC）、Release 模式、BiSheng 编译器 |

| **HIGH** | 生命周期与监控 | `RNAbility` 的 `onForeground/onBackground` 管理、FCP 首帧监控 |

| **MEDIUM** | TurboModule | 耗时模块（JSON/加密/图片/网络）放 Worker 线程执行 |

| **MEDIUM** | 列表与 Key | 稳定 key 策略，避免 index 作为 key |

典型应用场景

• 代码审查时扫描 setState 滥用、props 重复创建、组件拆分合理性
• CI/CD 阶段校验 bundle 构建参数（dev/minify/HBC）是否符合生产要求
• TurboModule 设计阶段识别主线程阻塞风险
• 性能分析前置：配合 Trace、React Marker、FCP 等指标进行优化验证

显著优点

1. 官方权威背书：直接源自 OpenHarmony-SIG ohos_react_native 性能文档，规则与平台实现深度绑定
2. 场景化分级：CRITICAL/HIGH/MEDIUM 三级优先级，资源紧张时可聚焦高影响规则
3. 前缀化规则体系：rnoh-* 命名空间清晰，便于集成到 ESLint、CodeReview 工具链
4. 双端覆盖：既包含 JS/TS 层渲染优化，也涵盖原生构建配置（CMake、BiSheng、Hermes）
5. 生产导向：明确区分 Dev/Release 构建差异，降低线上性能事故风险

潜在缺点与局限性

• 平台专属性强：规则仅适用于 OpenHarmony 的 React Native 运行时，跨平台（Android/iOS）项目需额外配置
• 静态检查边界：无法捕获运行时动态性能问题（如特定机型上的 JS 线程阻塞），需配合 Trace 工具使用
• 文档依赖：部分规则需查阅 rules/ 目录下的详细说明，快速上手成本略高
• Worker 线程复杂度：TurboModule 的 Worker 调度需要开发者理解 RNOH 线程模型，误用可能导致逻辑错误

适合人群

• OpenHarmony RN 应用开发者：需系统性提升应用帧率、启动速度、内存占用
• 性能专项工程师：负责 RNOH 项目性能基线建立与 CI 卡口配置
• 架构师/Reviewer：在代码审查中建立可量化的性能检查清单

常规风险

• 构建参数误配：忘记 --dev=false 或 HBC 会导致线上包体膨胀、执行效率下降
• 并发模式假设：RNOH 默认 concurrentRoot: true，若手动关闭会丧失 Automatic Batching 性能收益
• Worker 线程滥用：ImageLoader 等 UI 相关操作放入 Worker 可能引发渲染异常
• 生命周期遗漏：RNAbility 未正确转发前台/后台事件，可能导致资源泄漏或统计失真

安全等级说明

本技能仅提供静态检查规则与文档指引，不执行代码、不访问网络、不收集数据，属于纯知识型技能。但需注意：若将其集成到自动化构建流程，应确保 rules/ 文件来源可信，防止供应链污染。

核心用法

本 Skill 为纯文档型静态检查指南，旨在为开发者在编写或审查 React Native for OpenHarmony（RNOH）代码时提供系统化的性能优化规则参考。使用场景涵盖：RNOH 应用代码开发、页面渲染与 setState 优化、bundle-harmony 构建配置、Hermes 字节码编译、RNAbility 生命周期管理、TurboModule 线程设计，以及性能分析准备（Trace、React Marker、FCP 等）。

规则按优先级分为五类：
1. Render 优化（关键级）：避免相同状态重复 setState、使用 PureComponent/React.memo、回调函数缓存、状态合并更新等；
2. Bundle 与原生配置（高优先级）：Release 模式构建、Hermes 字节码编译、BiSheng 编译器可选配置；
3. 生命周期与监控（高优先级）：onForeground/onBackground 正确调用、首帧（FCP）监控实现；
4. TurboModule（中优先级）：重计算模块应在 Worker 线程执行，避免 ImageLoader 阻塞；
5. 列表与 Key（中优先级）：提供稳定的列表 key，避免使用索引作为 key。

显著优点

• 官方权威来源：直接源自 OpenHarmony-SIG 官方性能优化文档，与鸿蒙原生能力深度绑定；
• 系统性覆盖：从 React 渲染层到原生 Bundle 构建、从生命周期到 TurboModule 线程，形成完整性能优化闭环；
• 优先级清晰：按关键/高/中三级划分，帮助团队集中资源解决核心瓶颈；
• 零运行时依赖：纯 Markdown 文档，无代码执行风险，可无缝嵌入代码审查流程；
• 与通用 RN 最佳实践互补：在通用 React Native 性能优化基础上，补充鸿蒙特有的 RNAbility、HBC、Trace 等关键细节。

潜在缺点与局限性

• 平台限定性强：规则仅适用于 OpenHarmony 平台的 React Native 开发，无法直接用于 iOS/Android 纯血应用；
• 静态指引性质：仅提供检查规则和建议，无自动修复或实时性能监控工具集成；
• 英文唯一输出：为降低 Token 消耗，Skill 内容仅提供英文，中文参考需跳转外部链接；
• 需配合性能分析工具使用：FCP、Trace、React Marker 等监控建议需开发者自行配置相应工具链。

适合的目标群体

• 鸿蒙原生应用开发者：使用 React Native for OpenHarmony 构建鸿蒙原生应用的前端工程师；
• 性能优化专项团队：负责 RNOH 应用性能调优、首帧优化、流畅度提升的技术专家；
• Code Review 参与者：需要在代码审查阶段识别性能反模式、确保性能规范落地的团队成员；
• 架构设计人员：设计 TurboModule 线程模型、Bundle 构建策略、RNAbility 生命周期管理的系统架构师。

使用风险说明

作为纯文档型 Skill，本技能无代码执行、网络请求或数据收集行为，常规风险极低。需注意：

• 外部链接依赖：部分详细文档指向 gitcode.com 官方仓库，网络可达性需确保；
• 版本同步：OpenHarmony 生态快速迭代，建议定期同步 homecheck 仓库以获取最新规则；
• 规则理解门槛：部分优化建议（如 Concurrent Root、TurboModule Worker 线程）需对 React 18+ 及鸿蒙原生机制有深入理解，误用可能导致预期外行为。