Что такое нативные модули в 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.

Основная необходимость — JavaScript в React Native не может напрямую получать доступ к каждой нативной возможности, поэтому **нативные модули создают мост между JS и нативным кодом** (Swift/Objective-C, Kotlin/Java) — решая, как React Native получает доступ к функциям устройства (камера, геолокация, Bluetooth, push-уведомления), использует нативные SDK и реализует критически важную для производительности или специфичную для платформы функциональность.

Понимание **практической реальности** важно: **большинство нативной функциональности доступно через существующие библиотеки** (пакеты npm, которые включают нативные модули) или **управляемые нативные API Expo**, поэтому обычно вы **устанавливаете библиотеку вместо написания нативного кода самостоятельно** — это означает, что большинство разработчиков используют нативные модули через библиотеки, а не пишут их сами, важный практический момент, который задает реалистичные ожидания.

Понимание того, что вы **пишете пользовательский нативный модуль только когда не существует библиотеки** для вашей конкретной потребности (требуя знаний нативной разработки и реализации для каждой платформы), уточняет, когда необходима пользовательская нативная работа.

Знание того, что **новая архитектура** (JSI, TurboModules, Fabric) улучшает производительность нативного взаимодействия, отражает осведомленность об эволюции React Native.

Нативные модули — это то, как React Native интегрируется с нативной платформой, важно для приложений с нативными требованиями, хотя большинство потребностей удовлетворяются существующими библиотеками.

Поскольку доступ к нативным возможностям иногда необходим (для функций устройства и нативной интеграции) и нативные модули (в основном через библиотеки, иногда пользовательские) — это механизм React Native для этого, а понимание того, как они работают и что большинство потребностей удовлетворяется существующими библиотеками, ценно для разработки на React Native, понимание нативных модулей — это ценное, практически релевантное знание — мост, позволяющий React Native получать доступ к нативным функциям, важный для приложений с нативными потребностями, и при этом уточняющий, что большинство функциональности поступает из существующих библиотек, а не из пользовательского нативного кода, полезный контекст для работы с нативными возможностями React Native.