React Native의 native module이란 무엇인가요?

Question

Accepted Answer

**Native module**은 React Native(JavaScript)가 JavaScript로 접근할 수 없는 **네이티브 플랫폼 코드와 기능**(iOS/Android)에 접근하게 해줍니다 — 네이티브 API, SDK, 또는 커스텀 네이티브 기능으로 연결(bridge)합니다. 이는 JS만으로 제공되는 것을 넘어 React Native를 확장합니다.

## native module이 존재하는 이유

```text
React Native의 JavaScript는 모든 네이티브 기능에 직접 접근할 수 없음. NATIVE MODULE이
JS를 네이티브 코드로 연결함 (iOS의 Swift/Objective-C, Android의 Kotlin/Java):
  → JS에 노출되지 않은 네이티브 API/SDK 접근
  → 기존 네이티브 라이브러리 사용
  → 성능 중요 또는 플랫폼별 기능을 네이티브 코드로 구현
→ React Native의 JS와 네이티브 플랫폼 사이의 bridge.
```

## native module 사용 (대부분 라이브러리를 통해)

```text
→ 대부분의 네이티브 기능은 기존 라이브러리를 통해 사용 가능 (native module을
  포함한 npm 패키지): 카메라, 위치, 블루투스, 결제, 푸시 알림 등
  → 보통 직접 네이티브 코드를 작성하기보다 라이브러리를 설치함
→ EXPO는 네이티브 코드 작성 없이 많은 native API 제공 (managed module)
→ 필요에 맞는 라이브러리가 없을 때만 커스텀 native module을 작성함
```

## 커스텀 native module 작성 (개념적으로)

```text
→ JS에 메서드를 노출하는 네이티브 코드 작성 (Swift/Kotlin)
→ JS가 호출할 수 있도록 등록/노출 (bridge / 새 아키텍처의 TurboModule을 통해)
→ 일반 모듈처럼 JavaScript에서 호출
→ 네이티브 개발 지식 필요; OS별 플랫폼별 구현
→ 새 아키텍처 (JSI, TurboModule, Fabric)가 네이티브 상호운용 성능 개선
```

## 왜 중요한가

native module을 이해하는 것은 가치가 있는데, **JavaScript가 제공하는 것을 넘어 React Native가 네이티브 플랫폼 기능에 접근하는 방법**이고 네이티브 기능이 필요한 앱에 중요한 능력이므로 React Native 개발에 유용한 지식입니다.

핵심 필요 — React Native의 JavaScript는 모든 네이티브 기능에 직접 접근할 수 없으므로 **native module이 JS를 네이티브 코드로 연결**(Swift/Objective-C, Kotlin/Java) — 은 React Native가 기기 기능(카메라, 위치, 블루투스, 푸시 알림)에 접근하고, 네이티브 SDK를 사용하며, 성능 중요 또는 플랫폼별 기능을 구현하는 방법을 다룹니다.

**실용적 현실**을 이해하는 것은 중요합니다. **대부분의 네이티브 기능은 기존 라이브러리**(native module을 묶은 npm 패키지)나 **Expo의 managed native API**를 통해 사용 가능하므로, 보통 **직접 네이티브 코드를 작성하기보다 라이브러리를 설치**합니다 — 대부분의 개발자가 native module을 작성하기보다 라이브러리를 통해 소비한다는 의미로, 현실적 기대치를 설정하는 중요한 실용적 포인트입니다.

특정 필요에 맞는 **라이브러리가 없을 때만 커스텀 native module을 작성**(네이티브 개발 지식과 플랫폼별 구현 필요)한다는 것을 이해하면 언제 커스텀 네이티브 작업이 필요한지 명확해집니다.

**새 아키텍처**(JSI, TurboModule, Fabric)가 네이티브 상호운용 성능을 개선한다는 것을 아는 것은 React Native의 진화에 대한 인식을 반영합니다.

Native module은 React Native가 네이티브 플랫폼과 통합되는 방법으로, 네이티브 요구사항이 있는 앱에 중요하지만 대부분의 필요는 기존 라이브러리로 충족됩니다.

네이티브 기능 접근이 때로 필요(기기 기능과 네이티브 통합을 위해)하고 native module(대부분 라이브러리를 통해, 가끔 커스텀)이 이를 위한 React Native의 메커니즘이며, 그 동작 방식과 대부분의 필요가 기존 라이브러리로 충족된다는 것을 이해하는 것이 React Native 개발에 가치가 있으므로, native module을 이해하는 것은 가치 있고 실용적으로 관련된 지식입니다 — React Native가 네이티브 기능에 접근하게 하는 bridge로, 네이티브 요구가 있는 앱에 중요하면서 대부분의 기능이 커스텀 네이티브 코드가 아닌 기존 라이브러리에서 온다는 것을 명확히 하는, React Native의 네이티브 기능 작업에 유용한 맥락입니다.