原生模块集成与调用工程实践 - 第1节

原生模块概述：什么是原生模块

说实话，我刚接触跨平台开发那会儿，也被「原生模块」这个概念绕得有点晕。你想想看，我们用 React Native 或 Flutter 写界面，不就是为了跨平台吗？怎么还要回头去写原生代码？

嗯，这里要讲清楚。原生模块，说白了就是一段用平台原生语言写的代码——iOS 上用 Objective-C 或 Swift，Android 上用 Java 或 Kotlin。它被封装成一个模块，供 JavaScript 或 Dart 这样的跨平台层调用。

我个人的理解是：原生模块就是跨平台框架的「外挂」。框架本身能处理大部分 UI 和业务逻辑，但遇到它搞不定的事情，就得请原生模块出马。

原生模块的工作原理

举个例子你就明白了。假设你在 React Native 里想读取手机通讯录。JS 层本身做不到，它得通过一个叫「桥接」的机制，把请求发给原生层。原生层拿到请求后，调用系统的通讯录 API，拿到数据再传回 JS 层。

这个过程有点像翻译官。JS 说中文，原生说英文，桥接就是那个翻译。我在项目中遇到过一个问题：桥接传大量数据时特别慢，因为每次通信都要序列化和反序列化。后来我改用直接传文件路径，而不是传文件内容，性能提升了好几倍。

// 一个典型的原生模块结构（iOS 端示例）
// RNMyModule.m
#import <React/RCTBridgeModule.h>

@interface RNMyModule : NSObject <RCTBridgeModule>
@end

@implementation RNMyModule

RCT_EXPORT_MODULE();

RCT_EXPORT_METHOD(readContacts:(RCTPromiseResolveBlock)resolve
                  rejecter:(RCTPromiseRejectBlock)reject) {
  // 这里调用 iOS 原生通讯录 API
  // 拿到数据后通过 resolve 回调传回 JS
}

@end

原生模块的应用场景

什么时候必须用原生模块？我总结了几个典型场景，都是我在实际项目中踩过的坑。

1. 访问系统级硬件

摄像头、蓝牙、NFC、指纹识别、陀螺仪……这些硬件接口，跨平台框架通常只提供基础封装。如果你想做更精细的控制，比如自定义相机参数、后台蓝牙扫描，就得自己写原生模块。

我记得有一次做扫码功能，框架自带的相机组件识别率太低。我只好写了个原生模块，直接调用系统相机 API，自己处理图像识别，识别率从 60% 提到了 95%。

2. 集成第三方原生 SDK

很多商业 SDK 只提供原生版本，比如支付宝支付、登录、高德地图。你不可能等框架社区帮你封装好，项目不等人。这时候就得自己写原生模块来桥接。

3. 高性能计算

图像处理、音视频编解码、机器学习推理——这些计算密集型任务，用 JS 跑太慢了。原生代码直接调用 CPU/GPU，性能能差一个数量级。

我曾经做过一个实时滤镜功能，JS 层处理一帧要 200ms，卡得没法用。改成原生模块后，每帧只要 8ms，流畅得很。

4. 后台任务与系统服务

跨平台框架对后台任务的支持普遍较弱。比如后台下载、地理位置持续监听、推送通知的点击处理——这些都得靠原生模块。

原生模块与 Web 模块的对比

很多人会问：为什么不直接用 Web 技术？反正都是跨平台。这个问题我思考过很久，下面这张表应该能说明问题。

对比维度	原生模块	Web 模块
性能	直接调用系统 API，无中间层损耗	受浏览器引擎限制，有性能瓶颈
硬件访问	完整访问所有硬件和系统服务	受 Web API 限制，很多硬件无法访问
离线能力	原生支持，可常驻后台	依赖 Service Worker，能力有限
更新方式	需要发版更新	热更新，无需发版
开发成本	需要掌握多平台语言	一套 Web 技术栈通吃
调试难度	需要原生开发工具链	浏览器 DevTools 即可

你看，各有优劣。我的建议是：能用 Web 解决的，尽量用 Web。只有 Web 搞不定的，才上原生模块。别为了炫技而用原生，那样只会增加维护成本。

什么时候选原生模块？

我给自己定了个判断标准，分享给你参考：

• 必须用原生：硬件访问、第三方 SDK、后台保活、高性能计算
• 建议用原生：复杂动画（60fps 以上）、大文件处理、实时音视频
• 别用原生：简单的 UI 展示、网络请求、数据存储、业务逻辑

说白了，原生模块是跨平台开发的「最后一张牌」。平时藏着不用，关键时刻能救命。但如果你每把都出这张牌，那还不如直接做原生开发呢。

嗯，这一章就讲到这里。下一章我会带你手把手写一个原生模块，从创建到调用，把坑都踩一遍。到时候你就知道，这东西其实没那么神秘。