ما هي الوحدات الأصلية (Native Modules) في React Native؟

Question

Accepted Answer

**الوحدات الأصلية** تسمح لـ React Native (JavaScript) بالوصول إلى **كود وميزات المنصة الأصلية** (iOS/Android) التي لا تتوفر عبر JavaScript — الربط مع واجهات برمجية أصلية (APIs)، أو مجموعات أدوات (SDKs)، أو وظائف أصلية مخصصة. تمدد هذه الوحدات React Native إلى ما وراء ما يوفره JavaScript وحده.

## لماذا توجد الوحدات الأصلية

```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 لا يمكنه الوصول مباشرة إلى كل القدرات الأصلية، لذا **تربط الوحدات الأصلية JavaScript مع الكود الأصلي** (Swift/Objective-C، Kotlin/Java) — يعالج كيف يصل React Native إلى ميزات الجهاز (الكاميرا، تحديد الموقع الجغرافي، البلوتوث، إشعارات الدفع)، استخدام مجموعات الأدوات الأصلية، وتنفيذ الوظائف الحرجة للأداء أو الخاصة بالمنصة.

فهم **الواقع العملي** مهم: **معظم الوظائف الأصلية متاحة عبر المكتبات الموجودة** (حزم npm التي تتضمن وحدات أصلية) أو **واجهات برمجية Expo المُدارة**، لذا عادة ما **تثبت مكتبة بدلاً من كتابة كود أصلي بنفسك** — مما يعني أن معظم المطورين يستخدمون الوحدات الأصلية عبر المكتبات بدلاً من كتابتها، وهذه نقطة عملية مهمة تضع توقعات واقعية.

فهم أنك **تكتب وحدة أصلية مخصصة فقط عندما لا توجد مكتبة** لحاجتك المحددة (مما يتطلب معرفة بالتطوير الأصلي وتنفيذ لكل منصة) يوضح متى تكون هناك حاجة لعمل أصلي مخصص.

معرفة أن **العمارة الجديدة** (JSI، TurboModules، Fabric) تحسن أداء التفاعل الأصلي تعكس الوعي بتطور React Native.

الوحدات الأصلية هي كيفية تكامل React Native مع المنصة الأصلية، مهمة للتطبيقات التي لها متطلبات أصلية، رغم أن معظم الاحتياجات يتم تلبيتها من قبل المكتبات الموجودة.

لأن الوصول إلى القدرات الأصلية ضروري أحياناً (لميزات الجهاز والتكامل الأصلي) والوحدات الأصلية (في الغالب عبر المكتبات، وأحياناً مخصصة) هي آلية React Native لهذا، ولأن فهم كيف تعمل وأن معظم الاحتياجات يتم تلبيتها من قبل المكتبات الموجودة مفيد لتطوير React Native، فهم الوحدات الأصلية معرفة مفيدة وعملية ذات صلة — الجسر الذي يسمح لـ React Native بالوصول إلى الميزات الأصلية، مهم للتطبيقات التي لها احتياجات أصلية مع توضيح أن معظم الوظائف تأتي من المكتبات الموجودة بدلاً من الكود الأصلي المخصص، سياق مفيد للعمل مع قدرات React Native الأصلية.