React Native 中的原生模块是什么？

Question

Accepted Answer

**原生模块**让 React Native (JavaScript) 访问**原生平台代码和功能**(iOS/Android)，这些功能通过 JavaScript 无法获得 — 桥接到原生 API、SDK 或自定义原生功能。它们扩展了 React Native 超越 JS 单独提供的功能。

## 原生模块存在的原因

```text
React Native's JavaScript can't directly access every native capability. NATIVE MODULES
bridge JS to native code (Swift/Objective-C on iOS, Kotlin/Java on Android):
  → access native APIs/SDKs not exposed to JS
  → use existing native libraries
  → implement performance-critical or platform-specific functionality in native code
→ The bridge between React Native's JS and the native platform.
```

## 使用原生模块（主要通过库）

```text
→ MOST native functionality is available via EXISTING LIBRARIES (npm packages that
  include native modules): camera, geolocation, Bluetooth, payments, push notifications, etc.
  → you usually INSTALL a library rather than writing native code yourself
→ EXPO provides many native APIs without writing native code (managed modules)
→ You WRITE a custom native module only when no library exists for your need
```

## 编写自定义原生模块（概念上）

```text
→ Write native code (Swift/Kotlin) exposing methods to JS
→ Register/expose it so JS can call it (via the bridge / new architecture's TurboModules)
→ Call it from JavaScript like a regular module
→ Requires native development knowledge; platform-specific implementation per OS
→ The NEW ARCHITECTURE (JSI, TurboModules, Fabric) improves native interop performance
```

## 为什么这很重要

理解原生模块很有价值，因为它们是 **React Native 访问原生平台功能的方式**，超越了 JavaScript 提供的功能，这对需要原生功能的应用来说是一项重要能力，所以对 React Native 开发很有用。

核心需求 — React Native 的 JavaScript 无法直接访问每个原生功能，所以**原生模块将 JS 桥接到原生代码**(Swift/Objective-C、Kotlin/Java) — 说明了 React Native 如何访问设备功能(摄像头、地理定位、蓝牙、推送通知)、使用原生 SDK 以及实现性能关键或平台特定的功能。

理解**实际情况**很重要：**大多数原生功能通过现有库**(捆绑原生模块的 npm 包)或 **Expo 的托管原生 API** 获得，所以你通常**安装一个库而不是自己编写原生代码** — 这意味着大多数开发者通过库使用原生模块，而不是自己编写它们，这是一个重要的实际要点，它设定了现实的期望。

理解你**只有在不存在库来满足特定需求时才编写自定义原生模块**(需要原生开发知识和每个平台的实现)说明了何时需要自定义原生工作。

了解**新架构**(JSI、TurboModules、Fabric)改进原生互操作性能反映了对 React Native 演进的认识。

原生模块是 React Native 与原生平台集成的方式，对具有原生需求的应用很重要，尽管大多数需求由现有库满足。

由于访问原生功能有时是必要的(用于设备功能和原生集成)，而原生模块(主要通过库，偶尔自定义)是 React Native 实现这一目的的机制，而且由于理解它们如何工作以及大多数需求由现有库而非自定义原生代码满足对 React Native 开发很有价值，理解原生模块是有价值的、实际相关的知识 — 使 React Native 能够访问原生功能的桥接，对具有原生需求的应用很重要，同时澄清了大多数功能来自现有库而不是自定义原生代码，这是使用 React Native 原生功能的有用背景。