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

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

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

    • الإصدار 26.2 من Xcode أو الإصدارات الأحدث
  • تأكَّد من أنّ مشروعك يستوفي المتطلبات التالية:

    • يجب أن يستهدف مشروعك إصدارات المنصات التالية أو الإصدارات الأحدث:
      • iOS 15
      • الإصدار 11 من نظام التشغيل macOS
      • tvOS 15
      • watchOS 8
  • اضبط جهاز 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. انقر على تسجيل التطبيق (Register app).

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

  1. انقر على تنزيل GoogleService-Info.plist للحصول على ملف إعداد 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
  4. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.
  5. اختَر مكتبات Firebase التي تريد استخدامها.

    إذا كانت ميزة "Google Analytics" مفعَّلة في مشروع Firebase، تأكَّد من إضافة FirebaseAnalytics. ويوفّر ذلك جميع ميزات الإحصاءات. يمكنك أيضًا اختيار ميزات فردية. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول أحدث تنظيم للوحدات في حزمة تطوير البرامج (SDK) لمنصة Google Analytics لبرنامج Firebase.

بعد الانتهاء، سيبدأ 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) الخاصة بمنصات Firebase Apple

الخدمة أو المنتج اسم المكتبة أو إطار العمل هل تريد إضافة "إحصاءات Google"؟
AdMob GoogleMobileAds
Firebase AI Logic 1
FirebaseAILogic
Analytics FirebaseAnalytics
App Check FirebaseAppCheck
App Distribution FirebaseAppDistribution
Authentication FirebaseAuth
Cloud Firestore FirebaseFirestore
Cloud Functions for Firebase Client SDK FirebaseFunctions
Cloud Messaging FirebaseMessaging
Cloud Storage FirebaseStorage
Crashlytics FirebaseCrashlytics
In-App Messaging FirebaseInAppMessaging (مطلوب)
عمليات تثبيت بقيمة ‎Firebase FirebaseInstallations
Performance Monitoring FirebasePerformance
Realtime Database FirebaseDatabase
Remote Config FirebaseRemoteConfig
SQL Connect 2 FirebaseDataConnect
المكتبات المتوقفة نهائيًا أو غير المتوافقة
Dynamic Links FirebaseDynamicLinks
واجهات برمجة التطبيقات للنماذج المخصّصة في "Firebase ML" FirebaseMLModelDownloader

1 Firebase AI Logic (FirebaseAILogic) كان يُعرف سابقًا باسم "Vertex AI في Firebase" وتم توزيعه ضمن وحدة FirebaseVertexAI. Firebase AI Logic كان يتم توزيعه سابقًا ضمن وحدة FirebaseAI.

2 كانت "Firebase SQL Connect" تُعرف سابقًا باسم "Firebase Data Connect".

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

إذا كنت لا تريد استخدام Swift Package Manager، سيظل بإمكانك دمج Firebase عن طريق استيراد أُطر العمل المُجمَّعة مسبقًا مباشرةً.

أُطر العمل

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

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

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

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

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

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

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

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

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

  • يمكنك إنشاء ميزات مستندة إلى الذكاء الاصطناعي التوليدي باستخدام نماذج Gemini من خلال Firebase AI Logic.

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

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

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

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

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

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

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