SuperAPI AI 工具集

react-native-native-modules

编程与开发

查看项目

更新于 11-06 21:03

技能介绍

本技能面向 React Native 0.8x 版本,此时新架构已是唯一架构。其定位是指导开发者如何为 React Native 编写原生代码,内容按“选择方案—Turbo Modules—Fabric 组件—库作者最佳实践”组织。

一、方案选择 技能首先要求区分不同原生扩展路径:Turbo Module、Fabric 组件、Expo Module 与 Nitro,并区分本地模块与发布为库两种形态。相关参考为 core-choosing。对于 Expo Modules API(Swift/Kotlin DSL、config plugins),技能指向 react-native-expo/features-expo-modules.md;JSI/Fabric 概念见 react-native-core/features-new-architecture.md;线程性能见 react-native-performance/features-native-performance.md。

二、Turbo Modules 参考 core-turbo-modules,覆盖 TypeScript 规范、Codegen 配置、类型映射、Kotlin 与 Objective-C++ 实现、Swift、Promise、事件以及应用内本地模块。核心原则是:TypeScript 规范即接口契约,Codegen 从 Native*.ts / *NativeComponent.ts 生成原生接口,生成代码不得手工编辑。

三、Fabric 组件 参考 features-fabric-components,涉及 codegenNativeComponent、props、直接事件、命令、Android view manager 与 iOS component view。

四、库作者最佳实践 参考 best-practices-library-authoring,涵盖 create-react-native-library、builder-bob、示例应用、线程、错误处理、测试、Expo config plugin 与发布。

五、关键建议

  1. 优先使用现有库或 Expo Module;需要直接控制或不希望引入 Expo 依赖时再写 Turbo Module。
  2. TypeScript 规范是契约,Codegen 据此生成原生接口,不手改生成代码。
  3. 同步方法仅用于廉价操作:同步方法会阻塞 JS 线程,I/O、磁盘、网络或任何耗时超过数毫秒的工作应返回 Promise。
  4. 用 create-react-native-library 搭建脚手架,它会正确配置 Codegen、podspec、Gradle、示例应用和 builder-bob;在应用内使用 --local。
  5. 原生线程保持显式:UI 工作放主线程,其余放后台队列/执行器。
  6. 在 release 构建下测试双平台:Codegen 与链接错误常只在干净的原生构建中暴露。

限制与范围:技能面向 React Native 0.8x 新架构;Expo Modules API、JSI/Fabric 概念与线程性能等细节在外部参考文档中,本页未展开。