了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

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

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

بدءًا من الإصدار 8.0.0 من Firebase Apple SDK ، فإن دعم Swift Package Manager من Firebase خارج الإصدار التجريبي ومتاح للاستخدام بشكل عام. CocoaPods غير مطلوب لمستخدمي Swift Package Manager.

بالنسبة للإصدارات 8 من Firebase والإصدارات الأحدث ، فإن Swift Package Manager هو طريقة التثبيت الموصى بها.

عبر Xcode

يتطلب دعم Swift Package Manager 13.3.1 أو أعلى.

  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 إضافة علامة رابط -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 13.3.1 و CocoaPods 1.10.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 في تطبيقك عبر قرطاج.

دمج يدويًا

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

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

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

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