ReactNative/native modules intro
مقدمة إلى الوحدات الأصيلة Native Modules
يحتاج تطبيق React Native أحيانًا إلى الوصول إلى واجهة API للمنصة الأصيلة غير المتوفرة افتراضيًا في JavaScript ، مثل واجهات API الأصيلة للوصول إلى Apple Pay أو Google Pay. قد ترغب في إعادة استخدام بعض مكتبات لغات Objective-C أو Swift أو Java أو C ++ القائمة دون الحاجة إلى إعادة تطبيقها في لغة JavaScript، أو كتابة بعض الشيفرات عالية الأداء ومتعددة الخيوط multi-threaded لأمور معينة كمعالجة الصور.
يظهر نظام الوحدات الأصيلة NativeModule نسخًا من أصناف Java/Objective-C/C++ (الأصيلة) إلى JavaScript (اختصارًا JS) ككائنات JS، مما يتيح لك تنفيذ شيفرة أصيلة عشوائية من داخل JS. لا نتوقع أن تكون هذه الميزة جزءًا من عملية التطوير المعتادة، لكن يجب أن تكون موجودة. إن لم يصدّر إطار عمل React Native واجهة API أصيلة يحتاجها تطبيق JS الخاص بك، فيجب أن تكون قادرًا على تصديرها بنفسك.
إعداد الوحدة الأصيلة
هناك طريقتان لكتابة وحدة أصيلة لتطبيق React Native الخاص بك:
- مباشرةً ضمن مشاريع iOS أو Android لتطبيق React Native.
- كحزمة NPM يمكن تثبيتها كاعتمادية بواسطة تطبيقك أو تطبيقات React Native الأخرى.
سنوضّح طريقة تطبيق وحدة أصيلة مباشرةً داخل تطبيق React Native، ولكن يمكن توزيع الوحدة الأصيلة كحزمة NPM. يمكنك الاطلاع على صفحة إعداد الوحدات الأصيلة في React Native كحزمة NPM إن كنت مهتمًا بذلك.
البداية
سنوضّح في الصفحات التالية كيفية إنشاء وحدة أصيلة مباشرة داخل تطبيق React Native، لكن ستحتاج إلى تطبيق React Native للعمل. يمكنك اتباع الخطوات الموضّحة في صفحة مدخل إلى React Native إذا لم يكن لديك تطبيق بالفعل.
لنفترض أنك تريد الوصول إلى واجهات API الأصيلة لتطبيق التقويم في نظامي التشغيل iOS / Android من شيفرة JavaScript داخل تطبيق React Native بهدف إنشاء أحداث التقويم. لا يظهر React Native واجهة برمجة تطبيقات JavaScript للتواصل مع مكتبات التقويم الأصيلة، ولكن يمكنك من خلال الوحدات الأصيلة كتابة شيفرة أصيلة تتواصل مع واجهات API التقويم الأصيلة، ثم يمكنك استدعاء هذه الشيفرة الأصيلة من خلال JavaScript في تطبيق React Native الخاص بك.
سننشئ في الصفحات القادمة وحدة تقويم أصيلة لكل من نظامي Android و iOS.