أضف Firebase إلى مشروع iOS الخاص بك

المتطلبات الأساسية

قم بتثبيت ما يلي:
- Xcode 12.2 أو أحدث
- CocoaPods 1.10.0 أو أحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك نظام التشغيل iOS 10 أو إصدار أحدث.

قم بإعداد جهاز iOS فعليًا أو استخدم محاكي iOS لتشغيل تطبيقك.
هل تريد استخدام المراسلة السحابية؟
بالنسبة إلى Cloud Messaging على iOS ، إليك المتطلبات الأساسية:
- قم بإعداد جهاز iOS فعلي .
- احصل على مفتاح مصادقة Apple Push Notification لحساب Apple Developer الخاص بك.
- قم بتمكين دفع الإخطارات في Xcode ضمن التطبيق> القدرات .

سجّل الدخول إلى Firebase باستخدام حساب Google الخاص بك.

إذا لم يكن لديك بالفعل مشروع Xcode وتريد فقط تجربة أحد منتجات Firebase ، فيمكنك تنزيل إحدى عينات البدء السريع الخاصة بنا.

الخطوة 1 : أنشئ مشروع Firebase

قبل أن تتمكن من إضافة Firebase إلى تطبيق iOS الخاص بك ، تحتاج إلى إنشاء مشروع Firebase للاتصال بتطبيق iOS الخاص بك. تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase.

أنشئ مشروع Firebase

في وحدة تحكم Firebase ، انقر على إضافة مشروع ، ثم حدد أو أدخل اسم المشروع .
إذا كان لديك مشروع Google Cloud حالي ، فيمكنك تحديد المشروع من القائمة المنسدلة لإضافة موارد Firebase إلى هذا المشروع.
(اختياري) إذا كنت تقوم بإنشاء مشروع جديد ، يمكنك تعديل معرّف المشروع .
يعيّن Firebase تلقائيًا معرّفًا فريدًا لمشروع Firebase الخاص بك. تفضل بزيارة فهم مشاريع Firebase للتعرف على كيفية استخدام Firebase لمعرف المشروع.
بعد توفير Firebase للموارد لمشروع Firebase ، لا يمكنك تغيير معرّف مشروعك.
لاستخدام معرّف محدد ، يجب عليك تعديل معرّف المشروع أثناء خطوة الإعداد هذه.
انقر فوق متابعة .
(اختياري) قم بإعداد Google Analytics لمشروعك ، مما يتيح لك الحصول على تجربة مثالية باستخدام أي من منتجات Firebase التالية:
Firebase Crashlytics
توقعات Firebase
Firebase Cloud Messaging
المراسلة داخل تطبيق Firebase
تهيئة Firebase عن بُعد
اختبار Firebase A / B
عند المطالبة ، حدد استخدام حساب Google Analytics موجود أو لإنشاء حساب جديد.
إذا اخترت إنشاء حساب جديد ، فحدد موقع تقارير Analytics ، ثم اقبل إعدادات مشاركة البيانات وشروط Google Analytics لمشروعك.
يمكنك دائمًا إعداد Google Analytics لاحقًا في علامة التبويب " التكامل" في المشروع الخاصة بك.
انقر على إنشاء مشروع (أو إضافة Firebase ، إذا كنت تستخدم مشروع Google Cloud حالي).

يوفر Firebase الموارد تلقائيًا لمشروع Firebase. عند اكتمال العملية ، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في وحدة تحكم Firebase.

الخطوة 2 : تسجيل تطبيقك في Firebase

بعد أن يكون لديك مشروع Firebase ، يمكنك إضافة تطبيق iOS الخاص بك إليه.

تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول أفضل الممارسات والاعتبارات لإضافة تطبيقات إلى مشروع Firebase ، بما في ذلك كيفية التعامل مع متغيرات بناء متعددة.

انتقل إلى وحدة تحكم Firebase .
في وسط صفحة نظرة عامة على المشروع ، انقر فوق أيقونة iOS ( ) لبدء سير عمل الإعداد.
إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.
أدخل معرف حزمة التطبيق الخاص بك في حقل معرف حزمة iOS .
ما هو معرف الحزمة وأين تجده؟
- يحدد معرف الحزمة بشكل فريد تطبيقًا في نظام Apple البيئي.
- البحث ID الباقة: فتح نظام التشغيل iOS المشروع في كسكودي، حدد التطبيق المستوى الأعلى في الملاح المشروع، ثم حدد علامة التبويب عام.
  قيمة حقل معرف الحزمة هي معرف حزمة iOS (على سبيل المثال ، com.yourcompany.yourproject ).
- اعلم أن قيمة معرّف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase iOS هذا بعد تسجيله في مشروع Firebase الخاص بك.
تأكد من إدخال معرف الحزمة الذي يستخدمه تطبيقك بالفعل. قيمة معرّف الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase iOS هذا بعد تسجيله في مشروع Firebase.
(اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق ومعرف متجر التطبيقات .
كيف يتم استخدام لقب التطبيق ومعرّف متجر التطبيقات داخل Firebase؟
- لقب التطبيق : معرّف داخلي ملائم يكون مرئيًا لك فقط في وحدة تحكم Firebase
- معرّف متجر التطبيقات : تستخدمه روابط Firebase الديناميكية لإعادة توجيه المستخدمين إلى صفحة App Store الخاصة بك وبواسطة Google Analytics لاستيراد أحداث التحويل إلى إعلانات Google . إذا لم يكن لتطبيقك معرّف متجر التطبيقات حتى الآن ، يمكنك إضافة المعرّف لاحقًا في إعدادات المشروع .
انقر فوق تسجيل التطبيق .

الخطوة 3 : أضف ملف تكوين Firebase

انقر فوق تنزيل GoogleService-Info.plist للحصول على ملف تهيئة GoogleService-Info.plist iOS ( GoogleService-Info.plist ).
ماذا تريد أن تعرف عن ملف التكوين هذا؟
- يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .
- يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
- تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل (2) .
انقل ملف التكوين الخاص بك إلى جذر مشروع Xcode الخاص بك. إذا طُلب منك ذلك ، فحدد لإضافة ملف التكوين لجميع الأهداف.

إذا كان لديك عدة معرّفات حِزمة في مشروعك ، فيجب عليك إقران معرّف كل حزمة GoogleService-Info.plist مسجل في وحدة تحكم Firebase بحيث يمكن أن يكون لكل تطبيق ملف GoogleService-Info.plist الخاص به.

الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك

نوصي باستخدام CocoaPods لتثبيت مكتبات Firebase . ومع ذلك ، إذا كنت تفضل عدم استخدام CocoaPods ، فيمكنك دمج أطر عمل SDK مباشرةً أو استخدام Swift Package Manager بدلاً من ذلك.

هل تستخدم إحدى عينات البدء السريع ؟ ومشروع Xcode وPodfile (مع القرون) موجودة بالفعل، ولكن عليك لا تزال بحاجة إلى إضافة ملف التكوين Firebase بك وتثبيت القرون.

قم بإنشاء ملف Podfile إذا لم يكن لديك واحد بالفعل:
```
cd your-project-directory
```
```
pod init
```
إلى Podfile الخاص بك ، أضف بودات Firebase التي تريد استخدامها في تطبيقك.
يمكنك إضافة أي من منتجات Firebase المدعومة إلى تطبيق iOS الخاص بك.
تم تمكين التحليلات
```
platform :ios, ‘10.0’

# Add the Firebase pod for Google Analytics
pod 'Firebase/Analytics'

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'
```
لم يتم تمكين التحليلات
```
platform :ios, ‘10.0’

# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'Firebase/Auth'
pod 'Firebase/Firestore'
```
هل تستخدم جهاز Mac بمعالج Apple السيليكون؟ هناك حاجة إلى حل مؤقت عند استخدام Analytics. راجع هذه التعليمات على GitHub .
يتم دمج تبعيات Binary Firebase كإطارات ثابتة بشكل افتراضي. إذا كنت تستخدم Firebase كعنصر تبعية لإطار عمل ديناميكي ، فتأكد من قراءة الوثائق المتعلقة باستخدام Firebase من إطار عمل أو مكتبة .
ثبّت .xcworkspace ، ثم افتح ملف .xcworkspace لترى المشروع في Xcode:
```
pod install
```
```
open your-project.xcworkspace
```

الخطوة 5 : تهيئة Firebase في تطبيقك

الخطوة الأخيرة هي إضافة رمز التهيئة إلى التطبيق الخاص بك. ربما تكون قد قمت بذلك بالفعل كجزء من إضافة Firebase إلى تطبيقك. إذا كنت تستخدم مشروع نموذج سريع البدء ، فقد تم القيام بذلك نيابة عنك.

استيراد وحدة Firebase في UIApplicationDelegate :
سويفت
```
import Firebase
```
ج موضوعية
```
@import Firebase;
```
قم FirebaseApp مثيل FirebaseApp المشترك ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:
سويفت
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
ج موضوعية
```
// Use Firebase library to configure APIs
[FIRApp configure];
```
إذا قمت بتضمين Firebase Analytics ، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.

هذا هو! يمكنك الانتقال إلى الخطوات التالية .

إذا كنت تواجه مشكلة في الإعداد ، فقم بزيارة استكشاف الأخطاء وإصلاحها والأسئلة الشائعة لنظام iOS .

القرون المتاحة

يسرد هذا القسم منتجات Firebase المدعومة لنظام iOS وأقراصها. تعرف على المزيد حول مكتبات Firebase iOS هذه:

الوثائق المرجعية ( Swift | Obj-C )
Firebase iOS SDK GitHub repo

الخدمة أو المنتج	القرون	إضافة تحليلات؟
AdMob	`pod 'Google-Mobile-Ads-SDK'`
تحليلات	`pod 'Firebase/Analytics'`
توزيع التطبيق	`pod 'Firebase/AppDistribution'`
المصادقة	`pod 'Firebase/Auth'`
سحابة Firestore	`pod 'Firebase/Firestore'`
وظائف السحابة لـ Firebase Client SDK	`pod 'Firebase/Functions'`
المراسلة السحابية	`pod 'Firebase/Messaging'`
سحابة التخزين	`pod 'Firebase/Storage'`
Firebase Crashlytics	`pod 'Firebase/Crashlytics'`
روابط ديناميكية	`pod 'Firebase/DynamicLinks'`
المراسلة داخل التطبيق	`pod 'Firebase/InAppMessaging'`	(مطلوب)
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML	`pod 'Firebase/MLModelDownloader'`
مراقبة الاداء	`pod 'Firebase/Performance'`
قاعدة بيانات الوقت الحقيقي	`pod 'Firebase/Database'`
التكوين عن بعد	`pod 'Firebase/RemoteConfig'`

الدمج بدون CocoaPods

إذا كنت لا ترغب في استخدام Cocoapods ، فلا يزال بإمكانك الاستفادة من Firebase SDKs عن طريق استيراد الإطارات مباشرة أو باستخدام Swift Package Manager.

إطار أعمال

بالإضافة إلى دعم نظام iOS الأساسي ، يتضمن ملف zip الآن ملفات .xcframework التي تضيف دعم Catalyst المستند إلى المجتمع. للحصول على تفاصيل ، راجع Firebase iOS SDK README على GitHub .

قم بتنزيل إطار SDK zip . هذا ملف ~ 200 ميغا بايت وقد يستغرق بعض الوقت للتنزيل.
قم بفك ضغط الملف ، ثم قم بمراجعة README for the Frameworks التي تريد تضمينها في تطبيقك.
أضف علامة رابط ObjC في Other Linker Settings في إعدادات بناء الهدف.

سويفت مدير الحزم

تعرف على المزيد حول تكامل Swift Package Manager في دليلنا .

الخطوات التالية

تعرف على Firebase:

تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase وأفضل الممارسات للمشاريع.
استكشاف نماذج تطبيقات Firebase .
احصل على خبرة عملية مع Firebase iOS Codelab .
استكشف الكود مفتوح المصدر في GitHub .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- راجع قائمة التحقق من إطلاق Firebase .
هل تواجه مشكلة في Firebase ومشروع iOS الخاص بك؟ قم بزيارة استكشاف أخطاء iOS والأسئلة الشائعة .

أضف خدمات Firebase إلى تطبيقك:

احصل على رؤى حول سلوك المستخدم باستخدام Analytics .
قم بإعداد مصادقة المستخدم مع المصادقة .
قم بتخزين البيانات ، مثل معلومات المستخدم ، باستخدام Cloud Firestore أو Realtime Database .
قم بتخزين الملفات ، مثل الصور ومقاطع الفيديو ، باستخدام Cloud Storage .
تشغيل رمز الواجهة الخلفية الذي يعمل في بيئة آمنة باستخدام وظائف السحابة .
إرسال الإخطارات مع Cloud Messaging .
اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .