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

Swift Package Manager

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

عبر Xcode

يتطلّب استخدام Swift Package Manager الإصدار 26.2 أو إصدار أحدث.

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

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

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

   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 Package Manager.

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

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

   pod init

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

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

   تم تفعيل Analytics

   # Add the Firebase pod for Google Analytics
   pod 'FirebaseAnalytics'
   
   # For Analytics without IDFA collection capability, use this pod instead
   # pod FirebaseAnalytics/Core
   
   # 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 حول خصوصية المستخدم واستخدام البيانات وشفافية تتبُّع التطبيقات.

   لم يتم تفعيل 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. ثبِّت مجموعات الرموز البرمجية، ثم افتح ملف .xcworkspace للاطّلاع على المشروع في 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) لإطار العمل. يحتوي هذا الملف على أجزاء من البنية لجميع البُنى المستهدَفة المتاحة لجميع حِزم Firebase SDK، وبالتالي قد يستغرق تنزيله بعض الوقت.

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

3. أضِف علامة الربط -ObjC في Other Linker Settings في إعدادات الإنشاء الخاصة بالهدف.