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