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

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

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

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

  • تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية:

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو الإصدارات الأحدث:
      • الإصدار 13 من نظام التشغيل iOS
      • الإصدار 10.15 من نظام التشغيل macOS
      • نظام التشغيل tvOS 13
      • watchOS 7

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

استخدِم أداة Swift Package Manager لتثبيت تبعيات Firebase وإدارتها.

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

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

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

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

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

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

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

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

    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 Analytics، يمكنك تشغيل تطبيقك لإرسال إثبات إلى وحدة تحكّم Firebase بأنّك ثبّت Firebase بنجاح.

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

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

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

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

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

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

الخدمة أو المنتج Pods مكتبات SwiftPM إحصاءات Google.">هل تريد إضافة Analytics؟
AdMob pod 'Google-Mobile-Ads-SDK' لا ينطبق
Analytics pod 'FirebaseAnalytics' FirebaseAnalytics
App Check pod 'FirebaseAppCheck' FirebaseAppCheck
App Distribution pod 'FirebaseAppDistribution' FirebaseAppDistribution
Authentication pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions for Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
Cloud Messaging pod 'FirebaseMessaging' FirebaseMessaging
Cloud Storage pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Dynamic Links pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
In-App Messaging pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(مطلوبة)
Firebase عملية تثبيت pod 'FirebaseInstallations' FirebaseInstallations
Firebase ML واجهات برمجة التطبيقات للنماذج المخصّصة pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Performance Monitoring pod 'FirebasePerformance' FirebasePerformance
Realtime Database pod 'FirebaseDatabase' FirebaseDatabase
Remote Config pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI in Firebase pod 'FirebaseVertexAI' FirebaseVertexAI

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

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

CocoaPods

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

أُطر العمل

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

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

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

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

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

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

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

مزيد من المعلومات عن Firebase:

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

  • يمكنك الحصول على إحصاءات عن سلوك المستخدِم باستخدام Analytics.

  • إعداد مصادقة المستخدم باستخدام Authentication

  • تخزين البيانات، مثل معلومات المستخدمين، باستخدام Cloud Firestore أو Realtime Database

  • تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage

  • يمكنك تنشيط رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions.

  • إرسال الإشعارات باستخدام Cloud Messaging

  • يمكنك معرفة حالات تعطُّل تطبيقك وسببها باستخدام Crashlytics.