Czym są natywne moduły w React Native?

Question

Accepted Answer

**Natywne moduły** pozwalają React Native (JavaScript) uzyskać dostęp do **natywnego kodu platformy i funkcjonalności** (iOS/Android), które nie są dostępne przez JavaScript — łącząc się z natywnymi API, SDK-ami lub niestandardową natywną funkcjonalnością. Rozszerzają React Native poza to, co zapewnia sam JavaScript.

## Dlaczego to ważne

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

## Używanie natywnych modułów (głównie przez biblioteki)

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

## Pisanie niestandardowego natywnego modułu (koncepcyjnie)

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

## Dlaczego to ważne

Zrozumienie natywnych modułów jest cenne, ponieważ są to **sposób, w jaki React Native uzyskuje dostęp do natywnych możliwości platformy** poza tym, co zapewnia JavaScript — ważna funkcjonalność dla aplikacji wymagających natywnych funkcji, więc jest to użyteczna wiedza dla React Native development.

Potrzeba — JavaScript w React Native nie może bezpośrednio uzyskać dostępu do każdej natywnej możliwości, więc **natywne moduły łączą JS z kodem natywnym** (Swift/Objective-C, Kotlin/Java) — rozwiązuje to, jak React Native uzyskuje dostęp do funkcji urządzenia (aparat, geolokalizacja, Bluetooth, powiadomienia push), korzysta z natywnych SDK-ów i implementuje funkcjonalność krytyczną dla wydajności lub specyficzną dla platformy.

Zrozumienie **praktycznej rzeczywistości** jest ważne: **większość natywnej funkcjonalności jest dostępna przez istniejące biblioteki** (pakiety npm zawierające natywne moduły) lub **zarządzane natywne API Expo**, więc zwykle **instalujesz bibliotekę zamiast pisać natywny kod samodzielnie** — oznacza to, że większość developerów korzysta z natywnych modułów przez biblioteki zamiast pisać je, ważny praktyczny punkt ustawiający realistyczne oczekiwania.

Zrozumienie, że **piszesz niestandardowy natywny moduł tylko wtedy, gdy nie istnieje biblioteka** dla Twojej konkretnej potrzeby (wymagająca wiedzy o rozwoju natywnym i implementacji dla każdej platformy) wyjaśnia, kiedy potrzebna jest niestandardowa praca natywna.

Wiedza, że **nowa architektura** (JSI, TurboModules, Fabric) poprawia wydajność interoperacyjności natywnej odzwierciedla świadomość ewolucji React Native.

Natywne moduły to sposób, w jaki React Native integruje się z platformą natywną — ważne dla aplikacji z wymaganiami natywnymi, choć większość potrzeb jest zaspokajana przez istniejące biblioteki.

Ponieważ dostęp do natywnych możliwości jest czasami konieczny (dla funkcji urządzenia i integracji natywnej) a natywne moduły (głównie przez biblioteki, czasami niestandardowe) są mechanizmem React Native do tego, i ponieważ zrozumienie, jak działają i że większość potrzeb jest zaspokajana przez istniejące biblioteki, jest cenne dla React Native development, zrozumienie natywnych modułów jest cenne, praktycznie istotne — most umożliwiający React Native dostęp do natywnych funkcji, ważne dla aplikacji z natywnymi potrzebami, jednocześnie wyjaśniając, że większość funkcjonalności pochodzi z istniejących bibliotek niż z niestandardowego kodu natywnego, użyteczny kontekst do pracy z natywnymi możliwościami React Native.