أثناء تطوير تطبيقك المتوافق مع أجهزة Apple باستخدام Firebase، قد تتعرّف على مفاهيم غير مألوفة أو خاصة بمنصّة Firebase. تهدف هذه الصفحة إلى الإجابة عن هذه الأسئلة أو توجيهك إلى الموارد لمعرفة المزيد.
إذا كانت لديك أسئلة حول موضوع لم تتمّ مناقشته في هذه الصفحة، يُرجى الانتقال إلى أحد المنتديات على الإنترنت. سنقوم أيضًا بتحديث هذه الصفحة بمواضيع جديدة بشكل دوري، لذا تحقق مرة أخرى لمعرفة ما إذا كنا قد أضفنا الموضوع الذي تريد التعرف عليه!
توافق مكتبة Firebase حسب النظام الأساسي
يوضّح الجدول التالي مكتبات Firebase المتوافقة مع منصّات Apple المختلفة. في الوقت الحالي، يمكن للمنتدى فقط تقديم الدعم لنظامَي التشغيل visionOS وwatchOS. اطّلِع على مستودع حزمة تطوير البرامج (SDK) لمنصّات Apple من Firebase على GitHub للاطّلاع على تعليمات التثبيت والمشاكل المعروفة.
| المكتبة | iOS | نظام التشغيل macOS | ماك كتالون |
tvOS | visionOS | watchOS |
|---|---|---|---|---|---|---|
| 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 من Catalyst أو الإصدارات اللاحقة | نظام التشغيل 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 أو إصدار أحدث | Catalyst 15+ | tvOS 15+ (فريق دعم المنتدى فقط) | WatchOS 8+ |
مقاطع التطبيقات
وسيتم إنشاء معظم مكتبات Firebase وتشغيلها في أحد أهداف App Clip، إلا أنّ العديد منها سيتم فرض قيود عليه بسبب القيود المفروضة على نظام التشغيل. تشمل المشاكل المعروفة ما يلي:
- لا يمكن للروابط الديناميكية توجيه المستخدمين إلى مقطع تطبيق إذا نقروا على رابط بدون تثبيت التطبيق.
- لا يمكن لخدمة Firestore و"قاعدة بيانات في الوقت الفعلي" تحميل البيانات في "لقطات التطبيقات" بسبب الاعتماد على CFStream الأساسي.
يمكنك الاطّلاع على مستودع GitHub في Firebase للحصول على قائمة كاملة بالمشاكل المعروفة في ميزة "تطبيق مقتطف".
GoogleService-Info.plist
كجزء من إضافة Firebase إلى مشروعك على Apple، عليك إضافة ملف الإعدادات
GoogleService-Info.plist إلى مشروعك. إذا أردت استخدام عدّة مشاريع على Firebase في تطبيق واحد، انتقِل إلى المستندات
لإعداد مشاريع متعدّدة.
اطّلِع على مستندات مرجع Swift للتعرّف على عملية إعداد تطبيق Firebase بمزيد من التفصيل.
أداة إدارة حِزم Swift
يمكنك الاطّلاع على مزيد من المعلومات حول دمج Swift Package Manager في دليلنا.
إضافات Swift
كانت إضافات Swift لحزمة تطوير البرامج (SDK) لمنصّة Firebase على أجهزة Apple في السابق عبارة عن تكميلات صغيرة ومفتوحة المصدر لمكتبات منصة Firebase الحالية على أجهزة Apple، وهي تتيح لرمزك المبرمَج استخدام الميزات الخاصة بلغة Swift. ومنذ ذلك الحين، تمت إضافة واجهات برمجة التطبيقات هذه مباشرةً إلى المكتبات الرئيسية ولا يجب تضمينها بشكل منفصل. إذا كان لديك في السابق حزمة تطوير برامج (SDK) لإضافات Swift في قاعدة بياناتك البرمجية، يمكنك الاطّلاع على دليل نقل البيانات للحصول على تعليمات الترقية.
SwiftUI
تتوافق Firebase بالكامل مع SwiftUI، إلا أنّ عملية الإعداد ستكون مختلفة قليلاً عن تطبيقات UIKit لكي تعمل Firebase بشكل صحيح في بيئة SwiftUI بالكامل. يمكنك الاطّلاع على مشاركة المدوّنة التي نشرها "بيتر فرايز" لمعرفة المزيد من التفاصيل.
يجب إيقاف ميزة "تبديل الرموز البرمجية" في تطبيقات SwiftUI بسبب مشكلة معروفة. راجِع قسم تبديل مفوّض التطبيق للاطّلاع على مزيد من التفاصيل.
تبديل مفوّض التطبيق
تُغيّر Firebase بعض الطرق في فئة مثيل التطبيق لتطبيقك بهدف
ربط خدمات Firebase مع طلبات إعادة الاتصال بنظام التشغيل تلقائيًا، مثل
FCM ورمز APNs. يمكنك إيقاف التمرير السريع في تطبيقك من خلال إضافة علامة FirebaseAppDelegateProxyEnabled في ملف Info.plist للتطبيق وضبطها على NO.
تستخدِم أربعة منتجات من Firebase عملية تبديل مثيل رمز "مفوّض التطبيق": Analytics و App Distribution وAuthentication وFCM. إذا أوقفت ميزة التبديل في تطبيقك وكنت تستخدم أيًا من المنتجات التالية، يمكنك الرجوع إلى الدليل الخاص بالمنتج للتعرّف على كيفية استخدام المنتج بدون التبديل:
توافق مع الإصدار 14 من نظام التشغيل iOS
يتضمّن نظام التشغيل iOS 14 تغييرات جديدة على أذونات المستخدمين المتعلّقة بمعرّف الإعلان الخاص بالمستخدم. اطّلِع على دليل الاستعداد لنظام التشغيل iOS 14 لمزيد من التفاصيل حول ما إذا كان تطبيقك قد يتأثر بهذه التغييرات أم لا.
الدعم المستمر لتحقيق الهدف -C
لتسهيل صيانة مستندات منصّات Apple، قرّرت Firebase التركيز على مقتطفات Swift وعيّنات الرموز البرمجية في أدلةنا وغيرها من مواد المطوّرين. ستتم إزالة مقتطفات Objective-C من أدلةنا اعتبارًا من 1 كانون الثاني (يناير) 2024. سنواصل تحديث المستندات المرجعية الخاصة بـ Objective-C لجميع منتجات Firebase.
مراجع المصادر المفتوحة لحِزم تطوير البرامج (SDK) لمنصّة Apple من Firebase
تتوافق Firebase مع تطوير البرامج المفتوحة المصدر، ونحن نشجع المساهمات والملاحظات التي يقدّمها أفراد المنتدى.
حِزم تطوير البرامج (SDK) لمنصّة Apple من Firebase
تم تطوير جميع حِزم SDK لمنصة Firebase على أنظمة Apple الأساسية باستثناء Analytics كمكتبات مفتوحة المصدر في مستودع Firebase GitHub العام.
FirebaseUI
FirebaseUI هي مجموعة من مكتبات الأدوات التي تم إنشاؤها على Firebase، بما في ذلك مسار مستخدم سهل الاستخدام للمحاذة للمصادقة وأدوات البيانات لكل من Cloud Firestore و Realtime Database. يمكنك الاطّلاع على مزيد من التفاصيل حول FirebaseUI على صفحتنا على GitHub.
نماذج البدء السريع
تحتفظ منصة Firebase بمجموعة من نماذج البدء السريع لمعظم واجهات برمجة تطبيقات Firebase على نظام التشغيل iOS. يمكنك العثور على هذه الخطوات السريعة في مستودع quickstart العلني على GitHub ضمن Firebase.
ويمكنك فتح كل بداية سريعة في Xcode، ثم تشغيلها على جهاز جوّال أو محاكي. أو يمكنك استخدام هذه الخطوات السريعة كمثال على الرموز البرمجية لاستخدام حِزم تطوير البرامج (SDK) في Firebase.