تحديد مشاكل خيارات الإعداد وحلّها

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

تُعد خيارات Firebase مجموعة من المعلمات التي تتطلبها الخدمات من أجل التواصل بنجاح مع واجهات برمجة تطبيقات خادم Firebase وربط بيانات العميل مع مشروعك على Firebase وتطبيق Firebase. تعتمد خدمات Firebase على توفُّر خيارات Firebase الصالحة من المكتبة الأساسية أو المكتبة المشتركة في Firebase تم إنشاؤه أثناء إعداد Firebase.

تتطلّب خدمات Firebase المختلفة خيارات مختلفة لتعمل في Firebase. بشكلٍ صحيح، ولكن تتطلب جميع خدمات Firebase خيارات Firebase التالية:

• مفتاح واجهة برمجة التطبيقات: ملاحظة: هذا ليس مفتاح خادم FCM. يُرجى الاطّلاع على مفاتيح خادم المراسلة عبر السحابة الإلكترونية من Firebase.
  مثال على القيمة: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
• رقم تعريف المشروع - مثال على القيمة: myapp-project-123.
• معرّف التطبيق ("AppID") - معرّف فريد لتطبيقك يعتمد تنسيقه على النظام الأساسي:
  • بالنسبة إلى نظام التشغيل Android: mobilesdk_app_id: ملاحظة: هذا ليس اسم حزمة Android.
    مثال على القيمة: 1:1234567890:android:321abc456def7890
  • بالنسبة إلى +iOS: GOOGLE_APP_ID: ملاحظة: هذا ليس معرِّف حزمة Apple.
    مثال على القيمة: 1:1234567890:ios:321abc456def7890

تحديد مشاكل تطبيقات Android وحلّها

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

تفرض Firebase عمليات تثبيت توفّر منصة Firebase الإلزامية وصلاحيتها. مفتاح واجهة برمجة التطبيقات ومعرّف المشروع ومعرّف التطبيق لربط العميل من خلال مشروع Firebase. الاطّلاع على FirebaseOptions للمزيد من المعلومات المعلومات.

خدمة المراسلة عبر السحابة الإلكترونية من Firebase (FCM) مع معرّف مثيل Firebase (IID)

إذا واجه مستخدمون جُدد لتطبيقك مشاكل بشأن FCM، إذا كنت تبدأ في إعداد Firebase بدون مجموعة Firebase المطلوبة الخيارات.

ربما يستخدم طلبك معلومات غير مكتملة أو خاطئة google-services.json ملف الإعداد؛ أو تطبيقك تهيئة Firebase آليًا بدون المجموعة الكاملة المطلوبة خيارات Firebase.

نتيجةً لذلك، سيتم إيقاف خدمات Firebase، مثل "المراسلة عبر السحابة الإلكترونية من Firebase". للمستخدمين النهائيين الذين ثبَّتوا تطبيقك بعد إصداره حِزم تطوير البرامج (SDK) لمنصّة Firebase بالإضافة إلى ذلك، قد يبطئ تعذُّر إرسال الطلبات المتكررة إلى Firebase. تجربة المستخدم النهائي لتطبيقك.

ما هو الإجراء الواجب اتّخاذه؟

لإصلاح خدمات Firebase المعطَّلة لتطبيقاتك:

1. يمكنك تعديل تطبيقك عن طريق إعداد Firebase باستخدام مفتاح واجهة برمجة تطبيقات صالح لمشروعك ورقم تعريف مشروع صالح ومعرّف تطبيق صالح (mobilesdk_app_id أو "رقم تعريف التطبيق").
   • عملية الإعداد التلقائية باستخدام ملف إعداد Firebase: عليك تنزيل ملف الإعداد google-services.json من وحدة تحكُّم Firebase، ثم استبدال الملف الحالي في تطبيقك.
   • الإعداد الآلي باستخدام عنصر FirebaseOptions: يمكنك تنزيل ملف الإعداد google-services.json من "وحدة تحكُّم Firebase" للعثور على مفتاح واجهة برمجة التطبيقات ومعرّف المشروع ومعرّف التطبيق، ثم تعديل هذه القيم في عنصر FirebaseOptions في تطبيقك.
2. أطلِق إصدارًا جديدًا من تطبيقك على "متجر Play".

تحديد مشاكل تطبيقات Apple وحلّها

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

تفرض Firebase عمليات تثبيت توفّر منصة Firebase الإلزامية وصلاحيتها. مفتاح واجهة برمجة التطبيقات ومعرّف المشروع ومعرّف التطبيق لربط العميل من خلال مشروع Firebase. الاطّلاع على FIROptions للمزيد من المعلومات المعلومات.

خدمة المراسلة عبر السحابة الإلكترونية من Firebase (FCM) مع معرّف مثيل Firebase (IID)

إذا واجه مستخدمون جُدد لتطبيقك مشاكل بشأن FCM، إذا كنت تبدأ في إعداد Firebase بدون مجموعة Firebase المطلوبة الخيارات.

ربما يستخدم طلبك صورة غير مكتملة أو غير صالحة ملف إعداد GoogleService-Info.plist أو تطبيقك إعداد Firebase آليًا بدون المجموعة الكاملة من خيارات Firebase المطلوبة

نتيجةً لذلك، سيتوقف عمل خدمات Firebase مثل Firebase Cloud Messaging في المستخدمون النهائيون الذين ثبّتوا تطبيقك بعد إصداره باستخدام الإصدار المحدَّث من Firebase حِزم تطوير البرامج (SDK). بالإضافة إلى ذلك، قد يؤدي إخفاق الطلبات المتكررة إلى Firebase إلى إبطاء عملية تجربة المستخدم لتطبيقك.

ما هو الإجراء الواجب اتّخاذه؟

لإصلاح خدمات Firebase المعطَّلة لتطبيقاتك:

1. يمكنك تعديل تطبيقك عن طريق إعداد Firebase باستخدام مفتاح واجهة برمجة تطبيقات صالح لمشروعك ورقم تعريف مشروع صالح ومعرّف تطبيق صالح (GOOGLE_APP_ID أو "رقم تعريف التطبيق").
   1. عملية الإعداد التلقائية باستخدام ملف إعداد Firebase: عليك تنزيل ملف الإعداد GoogleService-Info.plist من وحدة تحكُّم Firebase، ثم استبدال الملف الحالي في تطبيقك.
   2. الإعداد الآلي باستخدام عنصر FIROptions: يمكنك تنزيل ملف الإعداد GoogleService-Info.plist من "وحدة تحكُّم Firebase" للعثور على مفتاح واجهة برمجة التطبيقات ومعرّف المشروع ومعرّف التطبيق، ثم تعديل هذه القيم في عنصر FIROptions في تطبيقك.
2. أطلِق إصدارًا جديدًا من تطبيقك على App Store.

مفاتيح خادم "المراسلة عبر السحابة الإلكترونية من Firebase"

إذا كان تطبيقك يستخدم مفتاح خادم "المراسلة عبر السحابة الإلكترونية من Firebase" بدلاً من Cloud API، فقد يتسبب هذا في ثغرة أمنية في حال كنت تستخدم مفتاح خادم FCM نفسه لإرسال الإشعارات الفورية عبر FCM. وفي هذه الحالة، ننصحك بشدة بمراجعة آلية عمل الخادم يصادق على إرسال الطلبات إلى خدمة "المراسلة عبر السحابة الإلكترونية من Firebase".

يُرجى ملاحظة أنّ مفاتيح خادم FCM (وهي مختلفة عن Firebase/Cloud API) يجب ألا يتم تضمينها في التطبيقات، حيث يمكن إساءة استخدام لإرسال إشعارات فورية باسم مشروعك.