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

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

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

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

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

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي التالية أو الإصدارات الأحدث:
      • الإصدار 11 من نظام التشغيل iOS
      • الإصدار 10.13 من نظام التشغيل macOS
      • نظام التشغيل tvOS 12
      • ساعة تعمل بنظام التشغيل 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 (GoogleService-Info.plist).

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

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

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

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

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى File > Add Packages (ملف > إضافة حِزم).
  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 والمصادقة:

    واجهة المستخدم

    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:) الخاصة بمفوَّض تطبيقك:

    واجهة المستخدم

    // 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.

    واجهة المستخدم

    @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 التي ثبَّتها بنجاح.

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

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

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

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

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

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

الخدمة أو المنتج اللوحات مكتبات 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
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج 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 لبرنامج Firebase لا ينطبق FirebaseVertexAI-Preview

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

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

CocoaPods

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

أُطر العمل

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

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

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

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

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

  3. أضِف علامة رابط -ObjC في Other Linker Settings ضمن إعدادات إنشاء هدفك.

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

تعرَّف على Firebase:

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