Apakah itu modul natif (native modules) dalam React Native?

Question

Accepted Answer

**Modul natif** membolehkan React Native (JavaScript) mengakses **kod dan ciri platform natif** (iOS/Android) yang tidak tersedia melalui JavaScript — menyambung ke API natif, SDK, atau fungsi natif tersuai. Ia memanjangkan React Native melangkaui apa yang disediakan oleh JS sahaja.

## Mengapa modul natif wujud

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

## Menggunakan modul natif (kebanyakannya melalui pustaka)

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

## Menulis modul natif tersuai (secara konsep)

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

## Mengapa ia penting

Memahami modul natif adalah berharga kerana ia **ialah cara React Native mengakses keupayaan platform natif** melangkaui apa yang disediakan oleh JavaScript, satu keupayaan penting untuk aplikasi yang memerlukan ciri natif, jadi ia merupakan pengetahuan yang berguna untuk pembangunan React Native.

Keperluan teras — JavaScript React Native tidak boleh mengakses setiap keupayaan natif secara terus, jadi **modul natif menyambungkan JS ke kod natif** (Swift/Objective-C, Kotlin/Java) — menangani cara React Native mengakses ciri peranti (kamera, geolokasi, Bluetooth, pemberitahuan tolak), menggunakan SDK natif, dan melaksanakan fungsi kritikal prestasi atau khusus platform.

Memahami **realiti praktikal** adalah penting: **kebanyakan fungsi natif tersedia melalui pustaka sedia ada** (pakej npm yang membungkus modul natif) atau **API natif terurus Expo**, jadi anda biasanya **memasang pustaka dan bukannya menulis kod natif sendiri** — bermakna kebanyakan pembangun mengguna modul natif melalui pustaka dan bukannya menulisnya, satu titik praktikal penting yang menetapkan jangkaan yang realistik.

Memahami bahawa anda **menulis modul natif tersuai hanya apabila tiada pustaka wujud** untuk keperluan khusus anda (memerlukan pengetahuan pembangunan natif dan pelaksanaan setiap platform) menjelaskan bila kerja natif tersuai diperlukan.

Mengetahui bahawa **seni bina baharu** (JSI, TurboModules, Fabric) meningkatkan prestasi interop natif mencerminkan kesedaran tentang evolusi React Native.

Modul natif ialah cara React Native berintegrasi dengan platform natif, penting untuk aplikasi dengan keperluan natif, walaupun kebanyakan keperluan dipenuhi oleh pustaka sedia ada.

Memandangkan mengakses keupayaan natif kadangkala perlu (untuk ciri peranti dan integrasi natif) dan modul natif (kebanyakannya melalui pustaka, kadangkala tersuai) ialah mekanisme React Native untuknya, dan memandangkan memahami cara ia berfungsi serta bahawa kebanyakan keperluan dipenuhi oleh pustaka sedia ada adalah berharga untuk pembangunan React Native, memahami modul natif adalah pengetahuan yang berharga dan relevan secara praktikal — jambatan yang membolehkan React Native mengakses ciri natif, penting untuk aplikasi dengan keperluan natif sambil menjelaskan bahawa kebanyakan fungsi datang daripada pustaka sedia ada dan bukannya kod natif tersuai, konteks berguna untuk bekerja dengan keupayaan natif React Native.