Swift Package Manager
تنصح Firebase باستخدام أداة Swift Package Manager للمشاريع الجديدة.
عبر Xcode
يتطلّب استخدام Swift Package Manager الإصدار 16.2 أو إصدارًا أحدث.
في حال نقل البيانات من مشروع يستند إلى 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
يتطلّب 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 الإصدار 16.2 من Xcode والإصدار 1.12.0 أو إصدار أحدث من CocoaPods. إليك كيفية تثبيت Firebase باستخدام CocoaPods:
أنشِئ Podfile في حال عدم توفّره. من جذر دليل المشروع، نفِّذ الأمر التالي:
pod init
أضِف إلى ملف Podfile مجموعات Firebase التي تريد استخدامها في تطبيقك.
يمكنك إضافة أيّ من منتجات Firebase المتوافقة إلى تطبيقك.
تم تفعيل Analytics
# Add the Firebase pod for Google Analytics pod 'FirebaseAnalytics' # For Analytics without IDFA collection capability, use this pod instead # pod FirebaseAnalytics/Core # 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 حول خصوصية المستخدم واستخدام البيانات وشفافية تتبُّع التطبيقات.
لم يتم تفعيل Analytics
# 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'
ثبِّت وحدات Pod، ثم افتح ملف
.xcworkspace
للاطّلاع على المشروع في Xcode:pod install --repo-update
open your-project.xcworkspace
اعتبارات خاصة بالمنتجات
تتطلّب بعض منتجات Firebase خطوات دمج إضافية لكي تعمل بشكل صحيح.
Crashlytics
يطلب منك Crashlytics تحميل رموز تصحيح الأخطاء.
يمكنك استخدام مرحلة إنشاء نص برمجي قابل للتنفيذ في Xcode لتحميل رموز تصحيح الأخطاء تلقائيًا بعد عملية الإنشاء. يمكنك العثور على النص البرمجي لتشغيل التطبيق هنا:
"${PODS_ROOT}/FirebaseCrashlytics/run"
قرطاج
يتوفّر دعم Carthage في مرحلة تجريبية. اطّلِع على التعليمات على GitHub بشأن تضمين Firebase في تطبيقك من خلال Carthage.
دمج البيانات يدويًا
توفّر Firebase توزيعًا مسبق الإنشاء لملف XCFramework الثنائي للمستخدمين الذين يريدون دمج Firebase بدون استخدام أداة إدارة التبعيات. لتثبيت Firebase، اتّبِع الخطوات التالية:
نزِّل ملف zip الخاص بحزمة تطوير البرامج (SDK) للإطار. يحتوي هذا الملف على شرائح بنية لجميع البِنى المستهدَفة المتاحة لجميع حِزم تطوير البرامج (SDK) من Firebase، وبالتالي قد يستغرق تنزيله بعض الوقت.
فكّ ضغط الملف، ثم راجِع
README
للأُطر التي تريد تضمينها في تطبيقك.أضِف علامة
-ObjC
الرابط فيOther Linker Settings
ضمن إعدادات الإصدار الخاصة بالهدف.