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

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

قم بتثبيت ما يلي:
- Xcode 11.0 أو أحدث
- CocoaPods 1.4.0 أو أحدث
تأكد من أن مشروعك يلبي هذه المتطلبات:
- يجب أن يستهدف مشروعك نظام iOS 8 أو أحدث.

قم بإعداد جهاز 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 Platform (GCP) حالي ، يمكنك تحديد المشروع من القائمة المنسدلة لإضافة موارد 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 ، إذا كنت تستخدم مشروع GCP حالي).

يوفر 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 الخاص بك.
تم تمكين التحليلات
```
# 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'
```
لم يتم تمكين التحليلات
```
# 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'
```
يتم دمج 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 بنجاح.

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

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

يسرد هذا القسم منتجات 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 Vision	`pod 'Firebase/MLVision'`
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML	`pod 'Firebase/MLModelInterpreter'`
مراقبة الاداء	`pod 'Firebase/Performance'`
قاعدة بيانات الوقت الحقيقي	`pod 'Firebase/Database'`
التكوين عن بعد	`pod 'Firebase/RemoteConfig'`

إهمال:

الخدمة أو المنتج	القرون	تفاصيل
ML Kit for Firebase: نموذج تسمية الصورة	`pod 'Firebase/MLVisionLabelModel'`	دليل الهجرة
ML Kit for Firebase: نموذج مسح الباركود	`pod 'Firebase/MLVisionBarcodeModel'`	دليل الهجرة
ML Kit for Firebase: نموذج التعرف على النص	`pod 'Firebase/MLVisionTextModel'`	دليل الهجرة
ML Kit for Firebase: نموذج اكتشاف الوجه	`pod 'Firebase/MLVisionFaceModel'`	دليل الهجرة
ML Kit for Firebase: نموذج الكشف عن الأشياء وتتبعها	`pod 'Firebase/MLVisionObjectDetection'`	دليل الهجرة
ML Kit for Firebase: واجهات برمجة تطبيقات اللغة الطبيعية	`pod 'Firebase/MLNaturalLanguage'`	دليل الهجرة
ML Kit for Firebase: نموذج تعريف اللغة	`pod 'Firebase/MLNLLanguageID'`	دليل الهجرة
ML Kit for Firebase: نموذج الترجمة	`pod 'Firebase/MLNLTranslate'`	دليل الهجرة
ML Kit for Firebase: نموذج الرد الذكي	`pod 'Firebase/MLNLSmartReply'`	دليل الهجرة
ML Kit for Firebase: AutoML Vision Edge API	`pod 'Firebase/MLVisionAutoML'`	دليل الهجرة

الدمج بدون CocoaPods

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

إطار أعمال

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

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

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

دعم Swift Package Manager حاليًا في مرحلة تجريبية. اتبع الوثائق الموجودة على GitHub ، وقدم أي ملاحظات إلى متعقب مشاكل GitHub .

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

تعرف على Firebase:

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

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

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