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

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

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

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

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

المكتبة iOS نظام التشغيل macOS ماك
كتالون
نظام التشغيل tvOS نظام التشغيل visionOS ساعة
A/B Testing
Analytics الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث
Analytics بدون رقم تعريف الإعلان الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث الإصدار 8.9.0 أو الإصدارات الأحدث
إحالة ناجحة واحدة (Analytics) على الجهاز فقط
مزوّد خدمة "فحص الجهاز" (App Check) WatchOS 9 أو أحدث
موفِّر خدمة مصادقة التطبيق (App Check) الإصدار 14 من نظام التشغيل iOS أو الإصدارات الأحدث الإصدار 11 من نظام التشغيل macOS أو الإصدارات الأحدث المحفّز من 14 عامًا فما فوق نظام التشغيل tvOS 15 والإصدارات الأحدث WatchOS 9 أو أحدث
مزوّدان (App Check) مخصّصان ومزوّدا خدمة تصحيح الأخطاء
App Distribution
Authentication جزئية جزئية جزئية جزئية جزئية
Cloud Firestore توزيعات المصدر فقط
Cloud Functions
Cloud Messaging
Cloud Storage
Crashlytics
Dynamic Links
عمليتا تثبيت (Firebase)
أداة تنزيل نموذج Firebase ML
In-App Messaging
Performance Monitoring
Realtime Database
Remote Config
Vertex AI in Firebase الإصدار 15 من نظام التشغيل iOS أو الإصدارات الأحدث الإصدار 12 من نظام التشغيل macOS أو إصدار أحدث المحفّز من 15 عامًا فما فوق tvOS 15+ (فريق دعم المنتدى فقط) WatchOS 8+

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

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

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

يمكنك الاطّلاع على مستودع GitHub في Firebase للحصول على قائمة كاملة بمشاكل 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 الخاصة بلغة Swift. ومنذ ذلك الحين، تمت إضافة واجهات برمجة التطبيقات هذه إلى المكتبات الرئيسية مباشرةً ولن تحتاج إلى تضمينها بشكل منفصل. إذا كنت تمتلك سابقًا حزمة SDK لإضافة Swift في قاعدة التعليمات البرمجية، راجِع دليل نقل البيانات للحصول على تعليمات الترقية.

SwiftUI

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

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

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

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

أربعة منتجات من Firebase تستخدم ميزة تدوير "تفويض التطبيق": Analytics، App Distribution وAuthentication وFCM إذا عطلت الدوّار في تطبيقك وكنت تستخدم أيًا من المنتجات التالية، فراجع الدليل الخاص بالمنتج لمعرفة كيفية استخدام المنتج بدون تحريكه:

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

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

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

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

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

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

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

يتم تطوير جميع حِزم تطوير البرامج (SDK) لمنصة Firebase على أنظمة Apple الأساسية باستثناء Analytics. المكتبات مفتوحة المصدر في مستودع GitHub في Firebase

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

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

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

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

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