خيارات تثبيت 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 تتطلّب إضافة علامة الر101ابط -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. في ملف Podfile، أضِف وحدات CocoaPods من 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. ثبِّت وحدات CocoaPods، ثم افتح ملف .xcworkspace للاطّلاع على المشروع في Xcode:

    pod install --repo-update
     
    open your-project.xcworkspace

اعتبارات خاصة بالمنتج

تتطلّب بعض منتجات Firebase خطوات دمج إضافية لكي تعمل بشكل صحيح.

Crashlytics

يتطلّب Crashlytics تحميل رموز تصحيح الأخطاء.

يمكنك استخدام مرحلة إنشاء نص برمجي للتنفيذ في Xcode لتحميل رموز تصحيح الأخطاء تلقائيًا بعد الإصدار. يمكنك العثور على النص البرمجي للتنفيذ هنا:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

لا يزال دعم Carthage تجريبيًا. اطّلِع على التعليمات على GitHub لتضمين Firebase في تطبيقك من خلال Carthage.

الدمج يدويًا

توفّر منصة Firebase توزيعًا ثنائيًا مُنشأ مسبقًا من XCFramework للمستخدمين الذين يريدون دمج Firebase بدون استخدام أداة لإدارة التبعيات. لتثبيت Firebase:

  1. نزِّل ملف zip الخاص بحزمة تطوير البرامج (SDK) لإطار العمل . يحتوي هذا الملف على شرائح بنية لجميع البنى المستهدَفة المتاحة لجميع حِزم تطوير البرامج (SDK) من Firebase، لذا قد يستغرق تنزيله بعض الوقت.

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

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