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

مدير حزم Swift

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

عبر Xcode

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

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

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

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

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

   # 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 ضمن إعدادات إنشاء استهدافك.