إضافة 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، مع فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة حِزم.
  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:

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