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

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

بدءا v8.0.0 من Firebase أبل SDK، Firebase و سويفت حزمة مدير الدعم من بيتا، وتتوفر عادة للاستخدام. CocoaPods غير مطلوب لمستخدمي Swift Package Manager.

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

عبر Xcode

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

  1. إذا الترحيل من المشروع بناء CocoaPods، تشغيل pod deintegrate لإزالة CocoaPods من مشروع Xcode. ولدت CocoaPods- .xcworkspace يمكن بأمان يتم حذف الملف بعد ذلك. إذا كنت تضيف Firebase إلى مشروع للمرة الأولى ، فيمكن تجاهل هذه الخطوة.

  2. في كسكودي، تثبيت مكتبات Firebase قبل الانتقال إلى ملف> حزم سويفت> إضافة حزمة التبعية ...

  3. في المطالبة التي تظهر ، حدد مستودع Firebase GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. حدد إصدار Firebase الذي تريد استخدامه. بالنسبة للمشاريع الجديدة ، نوصي باستخدام أحدث إصدار من Firebase.

  5. اختر مكتبات Firebase التي تريد تضمينها في تطبيقك.

بمجرد الانتهاء ، سيبدأ Xcode في حل تبعيات الحزمة الخاصة بك وتنزيلها في الخلفية.

عبر Package.swift

لدمج Firebase على مجموعة سويفت عبر Package.swift واضح، يمكنك إضافة Firebase إلى dependencies مجموعة من الحزمة الخاصة بك. لمزيد من المعلومات، راجع وثائق سويفت إدارة الحزم .

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 خطوات تكامل إضافية حتى تعمل بشكل صحيح.

تحليلات كوكل

جوجل تحليلات يتطلب إضافة -ObjC العلم رابط لإعدادات الإنشاء الهدف الخاص بك إذا تضمنت transitively.

كراشليتيك

تتطلب 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 بالإضافة إلى سويفت مدير الحزم.

يتطلب توزيع CocoaPods من Firebase Xcode 12.5 و CocoaPods 1.10.0 أو أعلى ، وإليك كيفية تثبيت Firebase باستخدام CocoaPods:

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

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

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

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

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    معرفة المزيد عن IDFA، معرف الإعلانات على مستوى الجهاز، في أبل خصوصية المستخدم واستخدام البيانات و التطبيقات تتبع الشفافية الوثائق.

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

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. تثبيت القرون، ثم فتح الخاص بك .xcworkspace ملف لرؤية المشروع في كسكودي:

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

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

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

كراشليتيك

تتطلب Crashlytics تحميل رموز التصحيح.

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

"${PODS_ROOT}/FirebaseCrashlytics/run"

قرطاج

دعم قرطاج تجريبي. اطلع على إرشادات حول جيثب لإدراج Firebase في التطبيق الخاص بك عن طريق قرطاج.

دمج يدويًا

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

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

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

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