فهم Firebase على منصات Apple الأساسية

أثناء تطوير تطبيق Apple باستخدام Firebase، قد تكتشف مفاهيم غير مألوفة أو خاصة بمنصّة Firebase. تهدف هذه الصفحة إلى الإجابة عن هذه الأسئلة أو توجيهك إلى الموارد لمعرفة المزيد.

إذا كانت لديك أسئلة حول موضوع لم يتم تناوله في هذه الصفحة، فلا تتردد في زيارة أحد منتدياتنا على الإنترنت. سنقوم أيضًا بتحديث هذه الصفحة بمواضيع جديدة بشكل دوري، لذا تحقق مرة أخرى لمعرفة ما إذا كنا قد أضفنا الموضوع الذي تريد التعرف عليه!

إتاحة مكتبة Firebase حسب النظام الأساسي

يوضّح الجدول التالي مكتبات Firebase المتوافقة مع أنظمة Apple الأساسية. في الوقت الحالي، لا يتوافق كل من visionOS وwatchOS إلا مع المنتدى. يمكنك الاطّلاع على مستودع GitHub لحزمة تطوير البرامج (SDK) لمنصّات Firebase Apple للحصول على تعليمات التثبيت والمشاكل المعروفة.

المكتبة iOS نظام التشغيل macOS ماك
محلل بيانات
نظام التشغيل tvOS نظام التشغيل visionOS ساعة
اختبار A/B
إحصاءات Google الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث
"إحصاءات Google" بدون رقم تعريف الإعلان الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث
الإحالة الناجحة على الجهاز فقط في "إحصاءات Google"
موفِّر خدمة فحص الجهاز (App Check DeviceCheck) WatchOS 9 أو أحدث
موفِّر خدمة المصادقة على تطبيق فحص التطبيقات الإصدار 14 من نظام التشغيل iOS أو الإصدارات الأحدث الإصدار 11 من نظام التشغيل macOS أو إصدار أحدث المحفِّز بعمر 14 عامًا وما فوق نظام التشغيل tvOS 15 والإصدارات الأحدث WatchOS 9 أو أحدث
موفّرو خدمة فحص التطبيقات المخصّص وتصحيح الأخطاء
App Distribution
المصادقة جزئية جزئية جزئية جزئية جزئية
Cloud Firestore توزيعات المصدر فقط
وظائف السحابة الإلكترونية
خدمة المراسلة عبر السحابة الإلكترونية
Cloud Storage
Crashlytics
الروابط الديناميكية
عمليات تثبيت Firebase
أداة تنزيل نماذج تعلُّم الآلة من Firebase
المراسلة داخل التطبيق
مراقبة الأداء
قاعدة بيانات الوقت الفعلي
الإعداد عن بُعد
‫Vertex AI لبرنامج Firebase

مقاطع التطبيقات

سيتم إنشاء معظم مكتبات Firebase وتشغيلها في هدف App Clip، إلا أنّ العديد منها سيتم فرض قيود عليه بسبب القيود المفروضة على نظام التشغيل. تشمل المشاكل المعروفة ما يلي:

  • لا يمكن للروابط الديناميكية توجيه المستخدمين إلى مقطع تطبيق إذا نقروا على رابط بدون تثبيت التطبيق.
  • لا يمكن لقاعدة بيانات Firestore والوقت الفعلي تحميل البيانات في App Clips بسبب تبعية CFStream الأساسية.

راجِع مستودع Firebase GitHub للحصول على قائمة كاملة بمشاكل App Clip المعروفة.

GoogleService-Info.plist

كجزء من إضافة Firebase إلى مشروع Apple، عليك إضافة ملف إعداد GoogleService-Info.plist إلى مشروعك. إذا أردت استخدام عدّة مشاريع على Firebase في تطبيق واحد، انتقِل إلى المستندات لضبط عدّة مشاريع.

اطّلِع على مستندات Swift المرجعية لمعرفة المزيد من التفاصيل عن عملية إعداد تطبيق Firebase.

مدير حزم Swift

اطّلع على مزيد من المعلومات حول دمج Swift Package Manager في دليلنا.

إضافات Swift

كانت إضافات Firebase لمنصة Apple SDK Swift في السابق عبارة عن إضافات صغيرة ومفتوحة المصدر لمكتبات أنظمة Firebase الأساسية الحالية من Apple والتي تمكّن رمزك من استخدام ميزات Swift الخاصة باللغة. ومنذ ذلك الحين، تمت إضافة واجهات برمجة التطبيقات هذه مباشرةً إلى المكتبات الرئيسية ولا يجب تضمينها بشكل منفصل. إذا كانت لديك سابقًا حزمة SDK لإضافة Swift في قاعدة الرموز، يمكنك الاطّلاع على دليل نقل البيانات للحصول على تعليمات الترقية.

واجهة المستخدم

يتوافق Firebase بشكل كامل مع واجهة SwiftUI، إلا أنّ الإعداد سيختلف قليلاً عن تطبيقات UIKit لكي يعمل Firebase بشكل صحيح في بيئة SwiftUI بالكامل. ويمكنك الاطّلاع على مشاركة المدونة هذه التي كتبها "بيتر فريز" لمعرفة مزيد من التفاصيل.

يجب أن توقِف تطبيقات SwiftUI التمرير بسبب مشكلة معروفة. يمكنك الاطّلاع على قسم تغيير تفويض التطبيق للحصول على مزيد من التفاصيل.

تعديل تفويض التطبيق

يعرض Firebase بعض الطرق في فئة تفويض التطبيق في تطبيقك من أجل ربط خدمات Firebase معيّنة تلقائيًا باستدعاءات نظام التشغيل، مثل خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" ورمز APNs المميز. يمكنك إيقاف التمرير السريع في تطبيقك من خلال إضافة علامة FirebaseAppDelegateProxyEnabled في ملف Info.plist للتطبيق وضبطها على NO.

تستخدم أربعة منتجات من Firebase ميزة "تبديل تفويض التطبيقات"، وهي: "إحصاءات Google" و"توزيع التطبيقات" و"المصادقة" و"المراسلة عبر السحابة الإلكترونية من Firebase". إذا عطلت الدواسة في تطبيقك وكنت تستخدم أيًا من المنتجات التالية، فراجع الدليل الخاص بالمنتج لمعرفة كيفية استخدام المنتج دون تأثير خاطف:

التوافق مع نظام التشغيل iOS 14

يتضمّن الإصدار iOS 14 تغييرات جديدة على أذونات المستخدمين المرتبطة بالمعرِّف الإعلاني للمستخدم. راجِع دليل الاستعداد للإصدار 14 من نظام التشغيل iOS للحصول على مزيد من التفاصيل حول ما إذا كان سيتأثر تطبيقك أم لا.

الدعم المستمر لتحقيق الهدف -C

لتسهيل عملية صيانة وثائق أنظمة Apple الأساسية، قرّر Firebase التركيز على مقتطفات Swift وعينات التعليمات البرمجية في أدلتنا ومواد المطوّرين الأخرى. ستتم إزالة مقتطفات Objective-C من أدلةنا اعتبارًا من 1 يناير 2024. سنواصل تحديث المستندات المرجعية الخاصة بـ Objective-C لجميع منتجات Firebase.

مراجع مفتوحة المصدر لحِزم تطوير البرامج (SDK) لمنصة Firebase من Apple

يدعم Firebase تطوير البرامج مفتوحة المصدر، ونحن نشجع مساهمات المنتدى والملاحظات.

حِزم تطوير البرامج (SDK) لمنصة Firebase من Apple

يتم تطوير جميع حِزم تطوير البرامج (SDK) لمنصة Firebase لمنصات Apple، باستثناء "إحصاءات Google"، كمكتبات مفتوحة المصدر في مستودع Firebase GitHub العام.

واجهة مستخدم Firebase

إنّ FirebaseUI هي مجموعة من مكتبات الأدوات المساعدة التي تم إنشاؤها استنادًا إلى Firebase، بما في ذلك تدفق واجهة المستخدم الثابتة لأدوات المصادقة والبيانات في Cloud Firestore و"قاعدة البيانات في الوقت الفعلي". يمكنك الاطّلاع على مزيد من التفاصيل حول FirebaseUI على صفحة GitHub.

نماذج البدء السريع

يحتفظ Firebase بمجموعة من نماذج البدء السريع لمعظم واجهات برمجة تطبيقات Firebase على نظام التشغيل iOS. يمكنك العثور على هذه البدايات السريعة في مستودع البدء السريع لمنصّة Firebase GitHub.

ويمكنك فتح كل بداية سريعة في Xcode، ثم تشغيلها على جهاز جوّال أو محاكي. أو يمكنك استخدام نقاط البدء السريعة هذه كمثال على الرمز لاستخدام حِزم تطوير البرامج (SDK) من Firebase.