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

Swift Package Manager

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

عبر Xcode

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

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

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

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