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

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

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

    • ‫Xcode 16.2 أو إصدار أحدث

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

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي هذه أو إصدارات أحدث:
      • ‫iOS 13
      • ‫macOS 10.15
      • 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 للحصول على ملف إعداد Firebase لتطبيقك (GoogleService-Info.plist).

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

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

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

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

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

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

    إذا كانت Google Analytics مفعّلة في مشروعك على Firebase، تأكَّد من إضافة FirebaseAnalytics. يوفّر هذا الخيار جميع ميزات الإحصاءات. يمكنك أيضًا اختيار ميزات فردية، ويُرجى الرجوع إلى الأسئلة الشائعة حول أحدث تنظيم للوحدات في Google Analytics لحزمة تطوير البرامج (SDK) لمنصة 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. مزيد من المعلومات حول مكتبات منصة Apple في Firebase:

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

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

الخدمة أو المنتج Pods مكتبات SwiftPM إضافة "إحصاءات Google"؟
AdMob pod 'Google-Mobile-Ads-SDK' لا ينطبق
Firebase AI Logic 1
 pod 'FirebaseAI' FirebaseAI
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
Data Connect لا ينطبق FirebaseDataConnect
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

1 كان اسم Firebase AI Logic في السابق "Vertex AI in Firebase" مع الحزمة pod 'FirebaseVertexAI' ومكتبة SwiftPM FirebaseVertexAI.

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

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

CocoaPods

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

أُطر العمل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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