قم بتثبيت Firebase في تطبيق Apple الخاص بك

مدير الحزم سويفت

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

عبر اكس كود

يتطلب دعم Swift Package Manager الإصدار 14.1 أو أعلى.

  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 إضافة علامة رابط -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 بدون أي معلمات.

كاكاوبودس

يدعم Firebase التثبيت مع CocoaPods بالإضافة إلى Swift Package Manager.

يتطلب توزيع CocoaPods الخاص بـ Firebase الإصدار Xcode 14.1 وCocoaPods 1.12.0 أو أعلى. إليك كيفية تثبيت Firebase باستخدام CocoaPods:

  1. قم بإنشاء ملف Podfile إذا لم يكن لديك واحد بالفعل. من جذر دليل مشروعك، قم بتشغيل الأمر التالي:

    pod init
  2. إلى ملف Podfile الخاص بك، أضف كبسولات Firebase التي تريد استخدامها في تطبيقك.

    يمكنك إضافة أي من منتجات Firebase المدعومة إلى تطبيقك.

    تم تمكين التحليلات

    # 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.

    التحليلات غير ممكّنة

    # 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"

قرطاج

دعم قرطاج تجريبي. راجع الإرشادات الموجودة على GitHub لتضمين Firebase في تطبيقك عبر Carthage.

التكامل يدويا

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

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

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

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