Agent Skills
返回列表
💻

React Native 最佳实践

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/software-mansion-labs-skills-react-native-best-practices。

技能介绍

你在新架构里会卡在哪

React Native New Architecture 落地后,动画走 Reanimated、触摸走 Gesture Handler、重计算走 Worklets,再配上 SVG、音频 API 或 JSI 原生桥,文档和示例往往按库拆分,生产里怎么拼、怎么避坑并不集中。团队若在 120fps 动画、scheduleOnUI、Metro Bundle Mode 或 JSI HostObject 生命周期上反复踩坑,缺的是一套按专题拆开的实践索引,而不是泛泛的入门教程。

技能如何工作

本技能以 Software Mansion 的生产模式为主线:先按当前任务打开 references/ 下对应子技能(见主 SKILL 中的对照表),再在子文档里查具体 API 与约束。覆盖范围包括:

  • 动画(references/animations/):共享值、withSpring/withTiming、布局 entering/exiting、滚动驱动动画与性能
  • 手势(references/gestures/):Tap/Pan/Pinch、手势组合、Swipeable/DrawerLayout 等
  • Worklets 与多线程(references/multithreading/、references/enable-worklets-bundle-mode/):UI 线程调度、Bundle Mode 与 Metro 补丁、第三方库进 worklet runtime
  • 端侧 AI(references/on-device-ai/):VisionCamera 帧处理、ExecuTorch 自定义模型、STT/TTS/OCR 等
  • 其它专题:react-native-svg、富文本/Markdown、react-native-audio-api、JSI C++ 与 jsi::HostObject 互调

使用方式很简单:问题域 → 子技能路径 → 按文档实现,避免在主技能正文里堆无关章节。

边界与注意点

子技能偏 生产实现与库边界,不替代官方 RN 环境搭建或版本迁移清单;Worklets Bundle Mode、JSI 与原生补丁强依赖你当前的包管理器与模板(Expo / RN CLI / 棕地)。端侧 AI、音频与着色器类内容对设备能力与原生依赖要求高,需自行核对目标平台支持。

使用场景

  • 列表与详情页要用 Reanimated 4 做 entering 动画和滚动驱动过渡,并核对 120fps 与无障碍
  • 商品卡片需要 Pan + Swipeable 组合手势,要在真机上测 fling 与手势冲突
  • Expo 项目启用 react-native-worklets Bundle Mode,排查 SHA-1 与 Fast Refresh 对 worklet 代码失效
  • 相机预览帧上做 OCR 或加载 ExecuTorch 模型,同时管理模型内存与 VisionCamera 管线

适合人员

  • 维护已切新架构的 RN 棕地应用、要把重计算从 JS 线程迁到 worklet 的移动端工程师
  • 日常用 Reanimated / Gesture Handler 做复杂动效与手势、需要按专题查生产约束的 RN 开发者
  • 要在 RN 内接端侧 LLM、语音识别或 VisionCamera 实时推理的功能开发者
  • 写 JSI C++ 模块、需在 HostObject 析构与 CallInvoker 线程安全上对齐实践的 native 工程师