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

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

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

من خلال Xcode

يتطلب دعم مدير الحزمة Swift الإصدار 15.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 استخدام 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. ثبِّت المجموعات، ثم افتح ملف .xcworkspace للاطّلاع على المشروع في Xcode:

   pod install --repo-update

   open your-project.xcworkspace

اعتبارات متعلقة بالمنتجات

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

Crashlytics

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

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

قرطاج

إنّ إتاحة Carthage ما زالت تجريبية. اطّلِع على التعليمات على GitHub لتضمين Firebase في تطبيقك عبر قرطاج.

الدمج يدويًا

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

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

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

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