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

أداة إدارة حِزم Swift

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

من خلال Xcode

يتطلب استخدام أداة Swift Package Manager الإصدار 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 Package Manager.

يتطلّب توزيع CocoaPods في Firebase استخدام Xcode 15.2 و CocoaPods 1.12.0 أو إصدار أحدث. في ما يلي كيفية تثبيت 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)، وهو المعرّف الإعلاني على مستوى الجهاز، في مستندات 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. ثبِّت وحدات 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. نزِّل ملف حزمة تطوير البرامج (SDK) لإطار العمل بتنسيق zip. يحتوي هذا الملف على شرائح معمارية لجميع التصاميم المعمارية المستهدَفة المتاحة لجميع حِزم تطوير البرامج (SDK) لبرنامج Firebase، وبالتالي قد يحتاج تنزيله إلى بعض الوقت.

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

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