إضافة Firebase إلى مشروعك على Apple

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

  • تثبيت ما يلي:

    • Xcode 14.1 أو إصدار أحدث

  • تأكد من أن مشروعك يلبي هذه المتطلبات:

    • يجب أن يستهدف مشروعك الإصدارات التالية من المنصة أو الإصدارات الأحدث:
      • الإصدار 11 من نظام التشغيل iOS
      • الإصدار 10.13 من نظام التشغيل macOS
      • الإصدار 12 من نظام التشغيل tvOS
      • نظام التشغيل WatchOS 6

  • عليك إعداد جهاز Apple فعلي أو استخدام جهاز محاكاة لتشغيل تطبيقك.

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

الخطوة 1: إنشاء مشروع على Firebase

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

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

لاستخدام Firebase في تطبيق Apple، يجب تسجيل تطبيقك في مشروع Firebase. غالبًا ما يُطلق على تسجيل تطبيقك "إضافة" تطبيقك إلى مشروعك.

  1. انتقِل إلى وحدة تحكُّم Firebase.

  2. في وسط صفحة النظرة العامة على المشروع، انقر على رمز iOS+ لبدء سير عمل الإعداد.

    إذا سبق لك إضافة تطبيق إلى مشروعك في Firebase، انقر على إضافة تطبيق لعرض خيارات النظام الأساسي.

  3. أدخِل معرِّف حزمة تطبيقك في حقل رقم تعريف الحزمة.

  4. (اختياري) أدخِل معلومات التطبيق الأخرى: اسم التطبيق ورقم تعريف متجر التطبيقات.

  5. انقر على تسجيل التطبيق.

الخطوة 3: إضافة ملف إعداد Firebase

  1. انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد Firebase Apple Platforms (GoogleService-Info.plist).

  2. انقل ملف التكوين إلى جذر مشروع Xcode. اختَر إضافة ملف الإعداد إلى جميع الأهداف، إذا طُلب منك ذلك.

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

الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك

استخدِم "مدير الحزم" في Swift لتثبيت تبعيات Firebase وإدارتها.

  1. في Xcode، بعد فتح مشروع التطبيق، انتقِل إلى ملف > إضافة حزم.
  2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصة Firebase من Apple عندما يُطلب منك ذلك:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.

  4. اختَر مكتبات Firebase التي تريد استخدامها.

    إذا كانت خدمة "إحصاءات Google" مفعّلة في مشروع Firebase، تأكَّد من إضافة السمة FirebaseAnalytics. وبالنسبة إلى "إحصاءات Google" بدون إمكانية جمع معرّف المعلِنين (IDFA)، أضِف FirebaseAnalyticsWithoutAdId بدلاً من ذلك.

عند الانتهاء، سيبدأ Xcode تلقائيًا في حل تبعياتك وتنزيلها في الخلفية.

الخطوة 5: إعداد Firebase في تطبيقك

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

  1. يمكنك استيراد وحدة FirebaseCore في UIApplicationDelegate، بالإضافة إلى أي وحدات أخرى من Firebase يستخدمها المفوَّضون في تطبيقك. على سبيل المثال، لاستخدام Cloud Firestore والمصادقة:

    واجهة SwiftUI

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. اضبط مثيلاً مشترَكًا في FirebaseApp في طريقة application(_:didFinishLaunchingWithOptions:) لمفوّض التطبيق:

    واجهة SwiftUI

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Swift

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. إذا كنت تستخدم SwiftUI، يجب إنشاء مفوَّض للتطبيق وإرفاقه ببنية App من خلال UIApplicationDelegateAdaptor أو NSApplicationDelegateAdaptor. يجب أيضًا إيقاف تبديل تفويض التطبيق. لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات SwiftUI.

    واجهة SwiftUI

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}
  4. إذا كنت قد ضمّنت حزمة تطوير البرامج (SDK) لمنصة Firebase لبرنامج "إحصاءات Google"، يمكنك تشغيل تطبيقك لإرسال عملية التحقق إلى وحدة تحكُّم Firebase في حال تثبيت Firebase بنجاح.

وهذا كل ما في الأمر! يمكنك الانتقال مباشرةً إلى الخطوات التالية.

ومع ذلك، إذا كنت تواجه مشكلة في الإعداد، يمكنك زيارة تحديد وحلّ المشاكل في أنظمة التشغيل Apple الأساسية والأسئلة الشائعة.

المكتبات المتاحة

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

  • المستندات المرجعية (Swift | Obj-C)

  • حِزم تطوير البرامج (SDK) لمنصّات Apple التي تعمل بمنصة Firebase مستودع GitHub

الخدمة أو المنتج الحجرات مكتبات SwiftPM هل تريد إضافة "إحصاءات Google"؟
AdMob pod 'Google-Mobile-Ads-SDK' لا ينطبق
إحصاءات Google pod 'FirebaseAnalytics' FirebaseAnalytics
فحص التطبيقات pod 'FirebaseAppCheck' FirebaseAppCheck
توزيع التطبيقات pod 'FirebaseAppDistribution' FirebaseAppDistribution
المصادقة pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
وظائف Cloud لحزمة تطوير البرامج (SDK) لعميل Firebase pod 'FirebaseFunctions' FirebaseFunctions
المراسلة عبر السحابة الإلكترونية pod 'FirebaseMessaging' FirebaseMessaging
التخزين في السحابة الإلكترونية pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
الروابط الديناميكية pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
المراسلة داخل التطبيق pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(مطلوبة)
عمليات تثبيت Firebase pod 'FirebaseInstallations' FirebaseInstallations
واجهات برمجة التطبيقات للنماذج المخصّصة لتعلُّم الآلة في Firebase pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
مراقبة الأداء pod 'FirebasePerformance' FirebasePerformance
قاعدة بيانات الوقت الفعلي pod 'FirebaseDatabase' FirebaseDatabase
الإعداد عن بُعد pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI for Firebase لا ينطبق FirebaseVertexAI-Preview

الدمج بدون استخدام Swift Package Manager

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

CocoaPods

يمكنك الاطّلاع على مزيد من المعلومات حول دمج CocoaPods في دليلنا.

أُطر العمل

بالإضافة إلى توفُّر نظام التشغيل iOS، يتضمّن الملف المضغوط الآن .xcframework ملف. لمعرفة التفاصيل، يمكنك الاطّلاع على README لحزمة تطوير البرامج (SDK) لمنصة Firebase على GitHub .

  1. نزِّل ملف SDK لإطار العمل بتنسيق zip. يبلغ حجم الملف 200 ميغابايت تقريبًا وقد يستغرق بعض الوقت لتنزيله.

  2. فك ضغط الملف، ثم ادمج أطر العمل التي تريد تضمينها في تطبيقك.

    يمكنك العثور على تعليمات الدمج في أيٍّ من المواضع التالية:

    للحصول على معلومات عن إصدارات إطار العمل أو التبعيات، يُرجى الرجوع إلى ملف METADATA.md ضمن توزيع ZIP الذي تم تنزيله.

  3. أضِف علامة رابط -ObjC في Other Linker Settings في إعدادات الإصدار المستهدَف.

الخطوات اللاحقة

التعرّف على Firebase:

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