مدير الحزم سويفت
يوصي Firebase باستخدام Swift Package Manager للمشاريع الجديدة.
عبر اكس كود
يتطلب دعم Swift Package Manager الإصدار 14.1 أو أعلى.
في حالة الترحيل من مشروع يستند إلى CocoaPods، قم بتشغيل
pod deintegrate
لإزالة CocoaPods من مشروع Xcode الخاص بك. يمكن حذف ملف.xcworkspace
الذي تم إنشاؤه بواسطة CocoaPods بأمان بعد ذلك. إذا كنت تضيف Firebase إلى مشروع للمرة الأولى، فيمكن تجاهل هذه الخطوة.في Xcode، قم بتثبيت مكتبات Firebase بالانتقال إلى File > Add Packages
في المطالبة التي تظهر، حدد مستودع 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
بدون أي معلمات.
كاكاوبودس
يدعم 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 في تطبيقك عبر Carthage.
التكامل يدويا
يوفر Firebase توزيعة XCFramework الثنائية المعدة مسبقًا للمستخدمين الذين يرغبون في دمج Firebase دون استخدام مدير التبعية. لتثبيت Firebase:
قم بتنزيل إطار عمل SDK zip . يحتوي هذا الملف على شرائح معمارية لجميع البنيات المستهدفة المتاحة لجميع حزم Firebase SDK، وبالتالي قد يستغرق تنزيله بعض الوقت.
قم بفك ضغط الملف، ثم قم بمراجعة الملف التمهيدي
README
للتعرف على أطر العمل التي تريد تضمينها في تطبيقك.أضف علامة رابط
-ObjC
فيOther Linker Settings
في إعدادات إنشاء هدفك.