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

مدير حزم Swift

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

عبر Xcode

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

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

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

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

    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

تتطلب "إحصاءات Google" إضافة علامة الربط -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 14.1 الإصدار 1.12.0 من CocoaPods أو إصدار أحدث إليك كيفية التثبيت Firebase باستخدام CocoaPods:

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

    pod init

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

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

    تفعيل الإحصاءات 

    # 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)، وهو معرِّف الإعلانات على مستوى الجهاز، في خصوصية المستخدم واستخدام البيانات أو شفافية تتبُّع التطبيقات التوثيق.

    عدم تفعيل الإحصاءات 

    # 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. ثبِّت اللوحات، ثم افتح ملف .xcworkspace للاطّلاع على المشروع. Xcode:

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

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

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

قرطاج

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

الدمج يدويًا

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

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

  2. عليك فكّ ضغط الملف، ثم مراجعة README بحثًا عن إطارات العمل المطلوب. تضمينها في تطبيقك.

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