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

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

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

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

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

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

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

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

  • لا يمكن للروابط الديناميكية إرسال المستخدمين إلى 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

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

واجهة SwiftUI

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

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

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

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

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

تتوافق مع الإصدار 14 من نظام التشغيل iOS

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

الدعم المستمر لـ Objective-C

لتسهيل صيانة وثائق منصات Apple، قرر Firebase التركيز على مقتطفات Swift وعينات التعليمات البرمجية في الأدلّة التي نوفرها ومواد المطورين الأخرى. ستتم إزالة مقتطفات Objective-C من أدلةنا اعتبارًا من 1 كانون الثاني (يناير) 2024. وسنواصل تحديث المستندات المرجعية المحدّثة بشأن الهدف "ج" لجميع منتجات 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.