خيارات تثبيت Firebase في تطبيق Apple

مدير حزم Swift

يوصي Firebase باستخدام Swift Package Manager للمشروعات الجديدة.

عبر Xcode

يتطلب دعم مدير الحزمة Swift الإصدار 15.2 أو إصدارًا أحدث.

  1. في حال نقل البيانات من مشروع يستند إلى CocoaPods، يمكنك تشغيل pod deintegrate لإزالة CocoaPods من مشروع Xcode. .xcworkspace من إنشاء شركة CocoaPods ويمكنك حذف ملف بأمان بعد ذلك. في حال إضافة Firebase إلى مشروع لأول مرة، يمكن تجاهل هذه الخطوة.

  2. في Xcode، ثبِّت مكتبات Firebase من خلال الانتقال إلى ملف > إضافة حِزم

  3. في الطلب الذي يظهر، اختَر مستودع GitHub في Firebase:

    https://github.com/firebase/firebase-ios-sdk.git

  4. اختَر إصدار Firebase الذي تريد استخدامه. بالنسبة إلى المشاريع الجديدة، ننصحك باستخدام أحدث إصدار من Firebase.

  5. اختَر مكتبات Firebase التي تريد تضمينها في تطبيقك.

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

عبر Package.swift

لدمج Firebase في حزمة Swift من خلال ملف بيان Package.swift، يمكنك: أضِف Firebase إلى مصفوفة dependencies من حزمتك. لمزيد من التفاصيل، يُرجى مراجعة الـ مستندات حول أداة Swift Package Manager

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

بعد ذلك، في أي استهداف يعتمد على منتج في Firebase، أضِفه إلى مصفوفة dependencies لهذا الهدف.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

الاعتبارات الخاصة بالمنتج

تتطلّب بعض منتجات Firebase خطوات دمج إضافية حتى تعمل بشكل صحيح.

Google Analytics

تتطلب الدالة Google Analytics إضافة علامة الربط -ObjC إلى استهدافك. وإنشاء الإعدادات إذا تم تضمينها بشكل متبادل.

Crashlytics

يطلُب Crashlytics منك تحميل رموز تصحيح الأخطاء.

يمكنك استخدام مرحلة تشغيل إنشاء النص البرمجي لـ Xcode لتحميل تصحيح الأخطاء تلقائيًا. والرموز بعد الإنشاء. يمكنك العثور على النص البرمجي للتشغيل هنا:

${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run

هناك خيار آخر لتحميل الرموز وهو استخدام رمز برمجي upload-symbols . ضع النص البرمجي في دليل فرعي من ملف مشروعك (على سبيل المثال scripts/upload-symbols)، ثم تأكَّد من أنّ النص البرمجي قابل للتنفيذ:

chmod +x scripts/upload-symbols

يمكن استخدام هذا النص البرمجي لتحميل ملفات dSYM يدويًا. لملاحظات الاستخدام وتعليمات إضافية للنص البرمجي، شغِّل upload-symbols بدون المعلَمات.

CocoaPods

تتيح منصة Firebase إجراء التثبيت باستخدام CocoaPods بالإضافة إلى مدير الحزم Swift.

يتطلب توزيع CocoaPods من Firebase توفّر Xcode 15.2 الإصدار 1.12.0 من CocoaPods أو إصدار أحدث في ما يلي كيفية تثبيت Firebase باستخدام CocoaPods:

  1. أنشئ ملف Podfile إذا لم يكن لديك ملف بالفعل. من جذور دليل المشروع، شغّل الأمر التالي:

    pod init

  2. إلى Podfile، إضافة مجموعات Firebase التي تريد استخدامها في تطبيقك.

    يمكنك إضافة أي من التطبيقات منتجات Firebase إلى تطبيقك.

    تم تفعيل Analytics 

    # Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'

# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’

# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

    اطّلِع على مزيد من المعلومات عن معرّف المعلِنين (IDFA)، وهو معرِّف الإعلانات على مستوى الجهاز، في خصوصية المستخدم واستخدام البيانات أو شفافية تتبُّع التطبيقات التوثيق.

    لم يتم تفعيل Analytics 

    # Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'

  3. ثبِّت وحدات pod، ثم افتح ملف .xcworkspace للاطّلاع على المشروع في IDE Xcode:

    pod install --repo-update
     
    open your-project.xcworkspace

الاعتبارات الخاصة بالمنتج

تتطلّب بعض منتجات Firebase خطوات تكامل إضافية حتى تعمل بشكل صحيح.

Crashlytics

يطلُب Crashlytics منك تحميل رموز تصحيح الأخطاء.

يمكنك استخدام مرحلة إنشاء نص برمجي لتشغيل Xcode لتحميل رموزال تصحيح الأخطاء تلقائيًا بعد عملية الإنشاء. يمكنك العثور على البرنامج النصي للتشغيل هنا:

"${PODS_ROOT}/FirebaseCrashlytics/run"

قرطاج

إنّ إتاحة Carthage ما زالت تجريبية. اطّلِع على التعليمات على GitHub لتضمين Firebase في تطبيقك من خلال Carthage.

الدمج يدويًا

يوفر Firebase توزيع XCFramework ثنائي الإنشاء مسبقًا للمستخدمين الذين يريدون دمج Firebase بدون استخدام مدير تبعية. لتثبيت Firebase:

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

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

  3. إضافة رابط -ObjC إبلاغ في Other Linker Settings في إعدادات الإصدار المستهدَف.