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

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

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

    • Xcode 14.1 أو إصدار أحدث

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

    • يجب أن يستهدف مشروعك إصدارات النظام الأساسي التالية أو الإصدارات الأحدث:
      • الإصدار 11 من نظام التشغيل iOS
      • الإصدار 10.13 من نظام التشغيل macOS
      • نظام التشغيل tvOS 12
      • ساعة تعمل بنظام التشغيل WatchOS 6

  • يمكنك إعداد جهاز 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
  3. اختَر إصدار حزمة تطوير البرامج (SDK) الذي تريد استخدامه.

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

    في حال تفعيل "إحصاءات Google" في مشروع Firebase، تأكّد من لإضافة FirebaseAnalytics. بالنسبة إلى "إحصاءات Google" بدون جمع معرّف المعلِنين (IDFA) هذه الميزة، يُرجى إضافة FirebaseAnalyticsWithoutAdId بدلاً منها.

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

الخطوة 5: إعداد Firebase في تطبيقك

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

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

    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"، يمكنك تشغيل لتطبيقك بإرسال إثبات الملكية إلى وحدة تحكُّم Firebase التي تم تثبيت Firebase بنجاح.

وهذا كل ما في الأمر! ويمكنك التخطّي إلى الخطوات التالية.

إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل أنظمة Apple الأساسية وحلّها الأسئلة الشائعة:

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

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

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

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

الخدمة أو المنتج اللوحات مكتبات SwiftPM هل تريد إضافة "إحصاءات Google"؟
AdMob pod 'Google-Mobile-Ads-SDK' لا ينطبق
إحصاءات Google pod 'FirebaseAnalytics' FirebaseAnalytics
فحص التطبيقات pod 'FirebaseAppCheck' FirebaseAppCheck
توزيع التطبيقات pod 'FirebaseAppDistribution' FirebaseAppDistribution
المصادقة pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase pod 'FirebaseFunctions' FirebaseFunctions
المراسلة عبر السحابة الإلكترونية pod 'FirebaseMessaging' FirebaseMessaging
التخزين في السحابة الإلكترونية pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
الروابط الديناميكية pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
المراسلة داخل التطبيق pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(مطلوب)
عمليات تثبيت Firebase pod 'FirebaseInstallations' FirebaseInstallations
واجهات برمجة التطبيقات للنماذج المخصّصة لتعلُّم الآلة من Firebase pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
مراقبة الأداء pod 'FirebasePerformance' FirebasePerformance
قاعدة بيانات الوقت الفعلي pod 'FirebaseDatabase' FirebaseDatabase
الإعداد عن بُعد pod 'FirebaseRemoteConfig' FirebaseRemoteConfig
Vertex AI لبرنامج Firebase لا ينطبق FirebaseVertexAI-Preview

الدمج بدون استخدام مدير الحِزم Swift

إذا كنت لا ترغب في استخدام مدير الحزم 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 إلى تطبيقك: