سويفت مدير الحزم
يوصي Firebase باستخدام Swift Package Manager للمشاريع الجديدة.
عبر Xcode
يتطلب دعم Swift Package Manager 14.1 أو أعلى.
في حالة الترحيل من مشروع قائم على CocoaPods ، قم بتشغيل
pod deintegrate
لإزالة CocoaPods من مشروع Xcode الخاص بك. يمكن حذف ملف.xcworkspace
الذي تم إنشاؤه من CocoaPods بأمان بعد ذلك. إذا كنت تضيف Firebase إلى مشروع للمرة الأولى ، فيمكن تجاهل هذه الخطوة.في Xcode ، ثبّت مكتبات Firebase بالانتقال إلى ملف> إضافة حزم
في المطالبة التي تظهر ، حدد مستودع Firebase GitHub:
https://github.com/firebase/firebase-ios-sdk.git
حدد إصدار Firebase الذي تريد استخدامه. بالنسبة للمشاريع الجديدة ، نوصي باستخدام أحدث إصدار من Firebase.
اختر مكتبات 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 14.1 و CocoaPods 1.10.0 أو أعلى. إليك كيفية تثبيت Firebase باستخدام CocoaPods:
قم بإنشاء ملف Podfile إذا لم يكن لديك واحد بالفعل. من جذر دليل المشروع الخاص بك ، قم بتشغيل الأمر التالي:
pod init
إلى 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'
ثبّت البودات ، ثم افتح ملف
.xcworkspace
لترى المشروع في Xcode:pod install --repo-update
open your-project.xcworkspace
اعتبارات خاصة بالمنتج
تتطلب بعض منتجات Firebase خطوات تكامل إضافية حتى تعمل بشكل صحيح.
Crashlytics
تتطلب Crashlytics تحميل رموز التصحيح.
يمكنك استخدام مرحلة إنشاء البرنامج النصي للتشغيل لـ Xcode لتحميل رموز تصحيح الأخطاء تلقائيًا بعد الإنشاء. ابحث عن البرنامج النصي للتشغيل هنا:
"${PODS_ROOT}/FirebaseCrashlytics/run"
قرطاج
دعم قرطاج تجريبي. راجع التعليمات الموجودة على GitHub لتضمين Firebase في تطبيقك عبر قرطاج.
دمج يدويًا
يوفر Firebase توزيع XCFramework ثنائي مبني مسبقًا للمستخدمين الذين يرغبون في دمج Firebase دون استخدام مدير التبعية. لتثبيت Firebase:
قم بتنزيل إطار SDK zip . يحتوي هذا الملف على شرائح معمارية لجميع البنى الهدف المتاحة لجميع مجموعات Firebase SDK ، وبالتالي قد يستغرق تنزيله بعض الوقت.
قم بفك ضغط الملف ، ثم قم بمراجعة
README
للأطر التي تريد تضمينها في تطبيقك.أضف علامة رابط
-ObjC
فيOther Linker Settings
في إعدادات بناء الهدف.