أضف Firebase إلى مشروع Apple الخاص بك

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

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

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

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو الإصدارات الأحدث:
      • دائرة الرقابة الداخلية 11
      • ماك 10.13
      • تي في او اس 12
      • واتش او اس 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. انقر فوق Download GoogleService-Info.plist للحصول على ملف تكوين منصات Firebase Apple ( GoogleService-Info.plist ).

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

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

الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك

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

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

    إذا تم تمكين Google Analytics في مشروع Firebase الخاص بك، فتأكد من إضافة FirebaseAnalytics . بالنسبة إلى Analytics التي لا تتمتع بإمكانية جمع IDFA، أضف FirebaseAnalyticsWithoutAdId بدلاً من ذلك.

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

الخطوة 5 : تهيئة Firebase في تطبيقك

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

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

    سويفتويي

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

    سويفت

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    ج موضوعية

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

    سويفتويي

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

    سويفت

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

    ج موضوعية

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

    سويفتويي

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          
  4. إذا قمت بتضمين Firebase SDK لبرنامج Google Analytics، فيمكنك تشغيل تطبيقك لإرسال التحقق إلى وحدة تحكم Firebase بأنك قمت بتثبيت Firebase بنجاح.

هذا كل شيء! يمكنك التخطي للأمام إلى الخطوات التالية .

إذا كنت تواجه مشكلة في الإعداد، فتفضل بزيارة استكشاف أخطاء أنظمة Apple الأساسية وإصلاحها والأسئلة الشائعة .

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

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

الخدمة أو المنتج القرون مكتبات SwiftPM إضافة التحليلات؟
ادموب pod 'Google-Mobile-Ads-SDK' لا يوجد
التحليلات pod 'FirebaseAnalytics' FirebaseAnalytics
فحص التطبيق pod 'FirebaseAppCheck' FirebaseAppCheck
توزيع التطبيق pod 'FirebaseAppDistribution' FirebaseAppDistribution
المصادقة pod 'FirebaseAuth' FirebaseAuth
سحابة فايرستور pod 'FirebaseFirestore' FirebaseFirestore
وظائف السحابة لـ Firebase Client SDK pod 'FirebaseFunctions' FirebaseFunctions
المراسلة السحابية pod 'FirebaseMessaging' FirebaseMessaging
سحابة التخزين pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
الروابط الديناميكية pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
المراسلة داخل التطبيق pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(مطلوب)
منشآت Firebase pod 'FirebaseInstallations' FirebaseInstallations
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
مراقبة الاداء pod 'FirebasePerformance' FirebasePerformance
قاعدة بيانات الوقت الحقيقي pod 'FirebaseDatabase' FirebaseDatabase
التكوين عن بعد pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

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

إذا كنت لا ترغب في استخدام Swift Package Manager، فلا يزال بإمكانك الاستفادة من Firebase SDKs باستخدام CocoaPods أو عن طريق استيراد أطر العمل مباشرةً.

كاكاوبودس

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

إطار أعمال

بالإضافة إلى دعم نظام التشغيل iOS، يتضمن الملف المضغوط الآن ملفات .xcframework . للحصول على التفاصيل، راجع الملف التمهيدي لـ SDK الخاص بأنظمة Firebase Apple على GitHub .

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

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

    يمكنك العثور على تعليمات التكامل في أي من الأماكن التالية:

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

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

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

تعرف على Firebase:

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

  • احصل على رؤى حول سلوك المستخدم باستخدام Analytics .

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

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

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

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

  • إرسال الإخطارات مع خدمة المراسلة السحابية .

  • اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .