O que são módulos nativos no React Native?

Question

Accepted Answer

**Módulos nativos** permitem que React Native (JavaScript) acesse **código e recursos nativos da plataforma** (iOS/Android) que não estão disponíveis através de JavaScript — fazendo a ponte para APIs nativas, SDKs ou funcionalidades nativas customizadas. Eles estendem React Native além do que apenas JS oferece.

## Por que isso importa

```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.
```

## Usando módulos nativos (principalmente via bibliotecas)

```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
```

## Escrevendo um módulo nativo customizado (conceitualmente)

```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
```

## Por que isso importa

Entender módulos nativos é valioso porque são **como React Native acessa capacidades nativas da plataforma** além do que JavaScript oferece, uma capacidade importante para aplicativos que precisam de recursos nativos, então é conhecimento útil para desenvolvimento em React Native.

A necessidade central — o JavaScript do React Native não consegue acessar diretamente todas as capacidades nativas, então **módulos nativos fazem a ponte entre JS e código nativo** (Swift/Objective-C, Kotlin/Java) — aborda como React Native acessa recursos de dispositivo (câmera, geolocalização, Bluetooth, notificações push), usa SDKs nativos e implementa funcionalidade crítica de desempenho ou específica da plataforma.

Entender a **realidade prática** é importante: **a maioria das funcionalidades nativas está disponível através de bibliotecas existentes** (pacotes npm que incluem módulos nativos) ou **APIs nativas gerenciadas pelo Expo**, então você geralmente **instala uma biblioteca em vez de escrever código nativo você mesmo** — significando que a maioria dos desenvolvedores consome módulos nativos via bibliotecas em vez de escrevê-los, um ponto prático importante que estabelece expectativas realistas.

Entender que você **escreve um módulo nativo customizado apenas quando nenhuma biblioteca existe** para sua necessidade específica (exigindo conhecimento de desenvolvimento nativo e implementação por plataforma) clarifica quando trabalho nativo customizado é necessário.

Saber que a **nova arquitetura** (JSI, TurboModules, Fabric) melhora o desempenho da interoperabilidade nativa reflete consciência da evolução do React Native.

Módulos nativos são como React Native se integra com a plataforma nativa, importante para aplicativos com requisitos nativos, embora a maioria das necessidades seja atendida por bibliotecas existentes.

Já que acessar capacidades nativas é às vezes necessário (para recursos de dispositivo e integração nativa) e módulos nativos (principalmente via bibliotecas, ocasionalmente customizados) são o mecanismo do React Native para isso, e já que entender como eles funcionam e que a maioria das necessidades é atendida por bibliotecas existentes é valioso para desenvolvimento em React Native, entender módulos nativos é conhecimento valioso e praticamente relevante — a ponte que permite ao React Native acessar recursos nativos, importante para aplicativos com necessidades nativas enquanto clarifica que a maioria das funcionalidades vem de bibliotecas existentes em vez de código nativo customizado, contexto útil para trabalhar com as capacidades nativas do React Native.