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

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

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

    • Xcode 15.2 أو إصدار أحدث
  • تأكد من أن مشروعك يلبي هذه المتطلبات:

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي التالية أو الإصدارات الأحدث:
      • الإصدار 13 من نظام التشغيل iOS
      • الإصدار 10.15 من نظام التشغيل macOS
      • نظام التشغيل tvOS 13
      • ساعة تعمل بنظام التشغيل WatchOS 7
  • يمكنك إعداد جهاز Apple فعلي أو استخدام محاكي لتشغيل تطبيقك.

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

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

عليك إنشاء منصّة Firebase لتتمكّن من إضافة منصة Firebase إلى تطبيق Apple. مشروعك لربطه بتطبيقك. زيارة الموقع يمكنك فهم مشاريع 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 (ملف) > بعد فتح مشروع التطبيق الخاص بك. إضافة حِزم
  2. أضِف مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple عندما يُطلب منك ذلك:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.
  5. اختَر مكتبات 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

الخدمة أو المنتج اللوحات مكتبات 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 لا ينطبق FirebaseVertexAI-Preview

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

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

CocoaPods

مزيد من المعلومات حول دمج CocoaPods في دليلنا.

أُطر العمل

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

  1. نزِّل ملف ZIP لحزمة تطوير البرامج (SDK) لإطار العمل. يبلغ حجم هذا الملف 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