خيارات تثبيت 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. في الطلب الذي يظهر، اختر مستودع 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 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.

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

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

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