عرض مصدر ReactNative/linking libraries ios

<noinclude>{{DISPLAYTITLE: ربط المكتبات لنظام iOS في React Native}}</noinclude>
لا تستخدم جميع التطبيقات جميع الإمكانيات الأصيلة، وتضمين الشيفرة لدعم جميع هذه الميزات سيؤثّر على حجم الثنائيّة (binary size). لكن من السّهل إضافة هذه الميّزات إذا احتجت إليها.

مع هذا في الحسبان، أصبحت الكثير من هذه الميزات متوفّرة كمكتبات ساكنة مستقلة (independent static libraries).

بالنسبة لمعظم المكتبات، سيكون الأمر ببساطةِ سحبِ ملفّين فقط، وأحيانًا ستحتاج إلى خطوةٌ ثالثة، لكن ليس أكثر من ذلك.

جميع المكتبات التي تُشحَن مع React Native تكون في مجلد <code>Libraries</code> في جذر المستودع. بعضها مكتوب بلغة JavaScript خالصة، وتحتاج فقط إلى طلبِها ‎‎<code>require</code>‎‎. تعتمد بعض المكتبات الأخرى على بعض الشيفرات الأصيلة كذلك، وفي هذه الحالة سيكون عليك إضافة هذه الملفات إلى التطبيق الخاص بك، وإلا فإن التطبيق سيرمي خطأً بمجرد محاولة استخدام المكتبة.
== خطوات ربط المكتبات التي تحتوي على شيفرات أصيلة==
===الربط التلقائي===
====الخطوة 1====
ثبّت مكتبةً ذات اعتماديّات أصيلة:
<syntaxhighlight lang="javascript">
npm install <library-with-native-dependencies> --save
</syntaxhighlight>

'''ملاحظة''': الراية ‎‎<code>--save</code>‎‎ أو ‎‎<code>--save-dev</code>‎‎ مهمّة جدا لهذه الخطوة. سيربط React Native المكتبات بناءً على خانتي ‎‎<code>dependencies</code>‎‎ و‎‎<code>devDependencies</code>‎‎ في ملف <code>package.json</code> الخاص بك.

====الخطوة 2====

اربط اعتماديّاتك الأصيلة:
<syntaxhighlight lang="javascript">
npx react-native link
</syntaxhighlight>

انتهينا! يجب أن تُربَط الآن جميع المكتبات ذات الاعتماديات الأصيلة بنجاحٍ بمشروع iOS أو Android الخاص بك.

'''ملاحظة:''' إذا كان مشروع iOS الخاص بك يستخدم CocoaPods (يحتوي على ملف Podfile) وكان للمكتبة المربوطة ملف <code>podspec</code>، فإن الأمر ‎‎<code>react-native link</code>‎‎ سيربط المكتبة باستخدام ملفّ <code>Podfile</code>. لدعم ملفات <code>Podfile</code> المهمّة، أضف التعليق ‎‎<code># Add new pods below this line</code>‎‎ إلى الأماكن التي تتوقع أن تُضاف فيها ملفّات pod.

==الربط اليدوي==
===الخطوة 1===
إذا كانت في المكتبة شيفرةٌ أصيلة، فيجب أن يكون هناك ملف ‎‎<code>.xcodeproj</code>‎‎ داخل مجلدها. اسحب هذا الملف إلى مشروعك على Xcode (عادةً ضمن مجموعة <code>Libraries</code> في Xcode).
[[ملف:AddToLibraries.png|مركز|لاإطار|بديل=|680x680بك]]
===الخطوة 2===
انقر فوق ملف المشروع الرئيسي (الملف الذي يمثل ‎‎<code>.xcodeproj</code>‎‎) وحدّد <code>Build Phases</code> واسحب المكتبة الساكنة من مجلد <code>Products</code> داخل المكتبة التي تقوم باستيرادها إلى <code>Link Binary With Libraries</code>
[[ملف:AddToBuildPhases.png|مركز|لاإطار|بديل=|680x680بك]]

===الخطوة 3===

لن تحتاج كل المكتبات إلى هذه الخطوة، عليك الإجابة على السؤال التالي:

هل أحتاج إلى معرفة محتويات المكتبة في وقت الترجمة (compile time)؟

بعبارة أخرى، هل تستخدم هذه المكتبة في الجانب الأصيل أم في JavaScript فقط؟ إذا كنت تستخدمها فقط في JavaScript، فأنت على ما يرام!

إذا كنت بحاجة إلى استدعائها من الجهة الأصيلة، فعلينا معرفة ترويسات (headers) المكتبة. لتحقيق ذلك، عليك الانتقال إلى ملف مشروعك، حدّد <code>Build Settings</code> وابحث عن ‎‎<code>Header Search Paths</code>‎‎. يجب عليك هناك تضمين المسار الذي يُشير إلى مكتبتك. (كان هذا التوثيق يوصي باستخدام ‎‎<code>recursive</code>‎‎، ولكن هذا لم يعد مستحسنًا، لأنه قد يسبب حالات فشلٍ في البناء (build failures)، خاصة مع CocoaPods.)

[[ملف:AddToSearchPaths-7b278a6ea5ef28cfa94e8d22da5a8b13.png|مركز|تصغير|بديل=|680x680بك]]

== مصادر ==
* [https://facebook.github.io/react-native/docs/linking-libraries-ios صفحة Linking Libraries في توثيق React Native الرسمي.]
[[تصنيف:ReactNative]]
[[تصنيف:React Native Docs]]