خيارات تثبيت 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 Package Manager.

يتطلب توزيع CocoaPods من Firebase استخدام Xcode 14.1 وCocoaPods 1.12.0 أو إصدارًا أحدث. في ما يلي طريقة تثبيت Firebase باستخدام CocoaPods:

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

   pod init

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

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

   تم تفعيل "إحصاءات Google"

   # 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، وشفافية تتبُّع التطبيقات.

   "إحصاءات Google" غير مفعّلة

   # 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. نزِّل ملف SDK لإطار العمل بتنسيق zip. يحتوي هذا الملف على شرائح بنية لكل البُنى المستهدفة المتاحة لجميع حزم SDK لمنصة Firebase، وبالتالي قد يستغرق تنزيله بعض الوقت.

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

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