تحديد المشاكل وحلّها والأسئلة الشائعة حول أنظمة Apple الأساسية وFirebase

تقدّم هذه الصفحة نصائح حول المشاكل الخاصة بالنظام الأساسي من Apple وحلّها. التي قد تواجهها عند استخدام Firebase.

هل لديك تحديات أخرى أو لم تظهر مشكلتك الموضّحة أدناه؟ احرص على التحقق من الأسئلة الشائعة حول Firebase للحصول على المزيد من خدمات Firebase الأسئلة الشائعة الخاصة بالمنتج.

يمكنك أيضًا الاطّلاع على مستودع GitHub لحزمة تطوير البرامج (SDK) لمنصّات Apple الأساسية من Firebase للحصول على قائمة مُحدّثة بالمشكلات التي تم الإبلاغ عنها واستكشاف الأخطاء وإصلاحها. ننصحك للإبلاغ عن المشاكل المتعلّقة بحزمة تطوير البرامج (SDK) لمنصات Apple الأساسية من Firebase أيضًا.

ما هي إصدارات Xcode المتوافقة مع Firebase؟

يدعم Firebase ما يصل إلى إصدارين رئيسيين من Xcode، ولا يشمل ذلك الإصدارات من Xcode لم تعد Apple تدعمه. على سبيل المثال، بدءًا من مارس 2019، تطلب Apple نظام تشغيل iOS 12 على الأقل في جميع التطبيقات، مما يعني أن دعم Xcode 9 كان وأن Xcode 10 هو الإصدار الرئيسي الوحيد المتوافق.

تغييرات على التوافق مع إصدارات ثانوية أو رموز تصحيح معيّنة من Xcode (على سبيل المثال، 9.2.0 إلى 9.4.1) يتم تحديدها بناءً على احتياجات حزمة تطوير البرامج (SDK) لمنصات Apple من Firebase واستطلاع حول استخدام المطوّرين. هذه التغييرات في ملاحظات إصدار حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple وفي صفحة إعداد حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple.

للاطّلاع على الحد الأدنى لإصدار Xcode الذي توفّره حزمة تطوير البرامج (SDK)، يُرجى الاطّلاع على المتطلبات المدرجة في إضافة Firebase إلى مشروع Apple

دعم Firebase للإصدارات التجريبية من Xcode يتوفّر "بأفضل جهد" بشكل أساسي. يمكن للمطوّرين تتبُّع المشاكل وإرسالها في مستودع حزمة تطوير البرامج (SDK) لمنصّات Firebase Apple على GitHub

يطلب التطبيق من المستخدم إدخال كلمة المرور للوصول إلى عناصر Keychain على نظام التشغيل macOS. كيف أصلح هذا؟

عليك ترقية اعتماد Firebase إلى الإصدار 9.6.0 أو إصدار أحدث وإضافة [إمكانية مشاركة سلسلة المفاتيح](/docs/ios/troubleshooting-faq#macos-keychain-sharing) لتحقيق هدفك.

لماذا يتطلب Firebase ميزة "مشاركة سلسلة المفاتيح" على نظام التشغيل macOS؟

تستخدم حِزم تطوير البرامج (SDK) لمنصة Firebase سلسلة المفاتيح لتخزين المعلومات مثل Firebase. معرّف التثبيت المستخدَم في خدمة FCM. بدون إمكانية الوصول إلى سلسلة المفاتيح، قد يتعذّر على حِزم تطوير البرامج (SDK) لمنصة Firebase يعمل بشكل صحيح. تعمل سلسلة مفاتيح macOS بشكل مختلف عن نظام التشغيل iOS. مستخدمة على أنظمة أساسية أخرى (iOS، وtvOS، وmacCatalyst، وwatchOS).

على نظام التشغيل macOS، تستخدم التطبيقات سلسلة مفاتيح مشتركة قد تعدّلها تطبيقات أخرى والعمليات. على عكس iOS، لا توجد سلسلة مفاتيح في وضع الحماية يحتوي عليها التطبيق ضمنيًا. لذلك، عندما يتفاعل تطبيق Mac مع سلسلة المفاتيح، فإن النظام يطلب من المستخدم إذنًا بالوصول لأنّ تطبيق Mac قد يعدِّل عنصرًا في سلسلة مفاتيح لأنه لم يبتكره. لمعالجة هذا التناقض، تستعلم منصة Firebase عن بسلسلة مفاتيح بمفتاح kSecUseDataProtectionKeychain الذي يخبر التطبيق للاستعلام عن عنصر سلسلة مفاتيح يمثل جزءًا من مجموعة وصول لسلسلة المفاتيح (هذا هو السلوك التلقائي على الأنظمة الأساسية الأخرى). إمكانية مشاركة سلسلة المفاتيح مطلوبة لأن التطبيق يحتاج إليها لتجميع مجموعة وصول يمكن مشتركة بين الأهداف، مما يمنح التطبيق الإذن بحرية الوصول إلى عناصر سلسلة المفاتيح في مجموعة الوصول.

لمزيد من المعلومات، راجع مستندات سلسلة المفاتيح .

في الإصدار 13 من Xcode والإصدارات الأحدث، لماذا لا يمكن لتطبيقات UIKit فتح بعض عناوين URL التي سجّلتها
في Info.plist؟

حدّدت Apple أنّ الحدّ الأقصى المسموح به هو 50 LSApplicationQueriesSchemes. الإدخالات في Info.plist ملف. في 2015، أطلقت شركة Apple LSApplicationQueriesSchemes للحدّ من عدد طلبات البحث عن عناوين URL التي يمكن أن يحققها كل تطبيق. مع إصدار Xcode 13، يتم فرض هذه الحدود، بينما في Xcode 12 وما قبله لم يكن هناك حد فعال لعدد المخططات.

بعض منتجات Firebase، مثل Firebase Authentication وFirebase Dynamic Links، تتطلب استخدام مخططات عناوين URL مخصصة لإعادة التوجيه إلى تطبيقك. هذه تتوافق عناوين URL مع نظام عناوين URL مختصر ومتسق يجب عدم احتسابه بشكل كبير مقابل حد مخطط الروابط البالغ 50 رابطًا.

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