قائمة التحقّق الخاصة بإطلاق Firebase

يحتوي هذا المستند على قائمة تحقّق من أفضل الممارسات والاعتبارات قبل إطلاق تطبيق Firebase في مرحلة الإنتاج.

أفضل الممارسات العامة لإصدار التطبيقات

  • تأكَّد من اختبار جميع التغييرات في Firebase Local Emulator Suite (للمنتجات المتوافقة) قبل نشرها في بيئة الإنتاج. يمكن أن يساعد الاختبار الشامل في منع الأخطاء المكلفة.

  • ابدأ فرض Firebase App Check لكل خدمة تتيح ذلك. يساعد App Check في التأكّد من أنّ تطبيقاتك الفعلية فقط هي التي يمكنها الوصول إلى خدمات الخلفية ومواردها.

  • راجِع قائمة التحقّق العامة من الأمان في Firebase.

  • استخدِم عمليات طرح Firebase Remote Config لإصدار ميزات وتحديثات جديدة في تطبيقك بشكل آمن وتدريجي.

  • ننصحك بإعداد Firebase Crashlytics إذا لم يسبق لك ذلك. وهي أداة بسيطة لإعداد تقارير الأعطال في الوقت الفعلي، وتساعدك في تتبُّع مشاكل الثبات التي تؤثر سلبًا في جودة تطبيقك وتحديد أولوياتها وحلّها.

التعرّف على حدود خطة الأسعار وضبط تنبيهات الميزانية

  • تأكَّد من عدم تجاوز حدود الاستخدام والحصص بعد الانتقال إلى مرحلة الإنتاج، خاصةً إذا كنت تستخدم خطة Spark المجانية. ننصحك بالترقية إلى خطة Blaze المَرِنة.

  • إعداد تنبيهات بشأن الميزانية لمشروعك

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

    • ننصحك بإعداد التنبيهات والإجراءات المتقدّمة، مثل الدوال التي ستوقف الفوترة استجابةً للتنبيهات.

    • إذا كنت تستخدم Firebase AI Logic وFirebase App Hosting وCloud Functions for Firebase وFirebase Extensions، ننصحك بشدة بإعداد حدود الإنفاق أيضًا، ما سيؤدي إلى إيقاف الخدمة المعنيّة مؤقتًا إذا وصل مشروعك إلى الميزانية المحدّدة لتلك الخدمة.

  • يمكنك تتبُّع استخدامك في لوحات البيانات الخاصة بالمنتجات أو في لوحة البيانات المركزية الاستخدام والفوترة في وحدة تحكّم "Firebase".

التأكّد من أنّ مشاريع Firebase وتطبيقاتك تتّبع أفضل الممارسات

سواء كنت مطوّرًا واحدًا أو فريقًا على مستوى المؤسسة، من المهم التأكّد من أنّ مشاريع Firebase وتطبيقاتك ومواردك محمية وآمنة ويمكن أن تتطوّر مع التغييرات في فريقك.

من المفيد تذكُّر أنّ مشروع Firebase هو مجرّد مشروع على Google Cloud تم تفعيل خدمات وإعدادات Firebase له. وهذا يعني أنّ العديد من أفضل الممارسات التي تنصح بها Google Cloud تنطبق أيضًا على Firebase.

  • استخدِم مشاريع Firebase مختلفة للتطوير والاختبار والإنتاج.

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

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

    • استخدِم قيود المشروع للحماية من حذف المشروع عن طريق الخطأ.

    • أضِف علامة "Prod" ضمن وحدة تحكّم Firebase لتسهيل تحديد بيئة التشغيل الفعلي.

  • إذا لم يسبق لك ذلك، ننصحك بإعداد مؤسسة على Google Cloud وإضافة مشاريع Firebase الخاصة بك إليها.

  • أضِف أكثر من مالك واحد إلى مشاريعك على Firebase، خاصةً إذا كان مشروعك غير تابع لمؤسسة على Google Cloud. مزيد من المعلومات عن حالات وكيفية تعيين مالكين لمشروع Firebase

  • أضِف أعضاء المشروع (المعروفين أيضًا باسم "المبادئ") كمجموعات Google بدلاً من إضافتهم بشكل فردي.

    يؤدي استخدام المجموعات إلى تسهيل إسناد الأدوار إلى أعضاء الفريق بشكل مجمّع، بالإضافة إلى إدارة المستخدمين الذين لديهم إذن الوصول إلى مشروعك على Firebase، خاصةً إذا كان أعضاء الفريق يتناوبون أو يغادرون.

  • امنح كل عضو في المشروع (المعروف أيضًا باسم "المستخدم الأساسي") مستوى الوصول المناسب إلى مشاريعك ومواردك على Firebase. مزيد من المعلومات حول إدارة الوصول إلى المشروع باستخدام "إدارة الهوية وإمكانية الوصول" في Firebase

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

    يمكنك أيضًا اختياريًا تخصيص "جهات الاتصال الأساسية" لمشروعك إذا أردت أن يتلقّى أعضاء محدّدون أو إضافيون في المشروع الإشعارات. ويُعدّ ذلك مفيدًا بشكل خاص لضمان تلقّي إشعارات بشأن الفوترة والتغييرات القانونية وتغييرات المنتجات من قِبل أكثر من مالك المشروع.

  • يجب فرض قيود على مفاتيح واجهة برمجة تطبيقات Firebase بحيث لا يتم السماح إلا لواجهات برمجة التطبيقات التي يجب أن تكون مدرَجة في القائمة المسموح بها لمفاتيح واجهة برمجة التطبيقات. يمكنك أيضًا الاطّلاع على المعلومات حول مفاتيح واجهة برمجة التطبيقات في قائمة التحقّق من الأمان في Firebase.

تجهيز خدمات معيّنة مستخدَمة في تطبيقك

قد يكون لكل منتج وخدمة مستخدَمة في تطبيقك اعتبارات محدّدة عند استخدامها في مرحلة الإنتاج.

Firebase AI Logic

Google Analytics

  • حدِّد شروط الجمهور لـ Google Analytics لبدء جمع بيانات الإحصاءات منذ إطلاق تطبيقك.

  • ننصحك بتفعيل تصدير بيانات "Google Analytics" إلى BigQuery لتتمكّن من تحليل بياناتك باستخدام لغة الاستعلامات البنيوية (SQL) في BigQuery أو تصدير البيانات لاستخدامها مع أدواتك الخاصة.

  • يجب حصر خصائص المستخدمين في المعلومات التي ستكون ذات صلة بدورة حياة تطبيقك بالكامل، لأنّ هناك حدًّا أقصى لعدد الخصائص التي يمكنك إنشاؤها، ولا يمكن أرشفتها.

  • راجِع إعدادات أدوار "Google Analytics" لمواقع وحسابات "Google Analytics". تتم إدارة هذه الأذونات بشكل منفصل عن أذونات وأدوار "إدارة الهوية وإمكانية الوصول" في مشروع Firebase.

  • تأكَّد من صحة معرّف متجر التطبيقات ومعرّف الفريق (إذا لزم الأمر) في إعدادات المشروع ضمن وحدة تحكّم Firebase.

App Check

  • تأكَّد من صحة رقم تعريف الفريق في إعدادات المشروع ضمن وحدة تحكّم "Firebase".

  • إذا لم يسبق لك ذلك، ابدأ فرض Firebase App Check لكل خدمة تتيح استخدامه. يساعد App Check في التأكّد من أنّ تطبيقاتك الفعلية فقط هي التي يمكنها الوصول إلى خدمات الخلفية ومواردها.

Authentication

  • أوقِف أي موفّري خدمات لا تستخدمهم (خاصةً المصادقة المجهولة).

  • إذا كان تطبيقك يستخدم ميزة "تسجيل الدخول باستخدام حساب Google"، يمكنك تخصيص شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.

  • يمكنك تخصيص النطاق والمرسِل في خدمة إرسال الرسائل الإلكترونية من "Authentication".

  • إذا كنت تستخدم خدمات التحقّق من الرسائل القصيرة في Identity Platform، يُرجى البدء في فرض Firebase App Check وضبط سياسة منطقة الرسائل القصيرة لحماية تطبيقك من إساءة استخدام الرسائل القصيرة.

  • اتّبِع إجراءات معالجة الأخطاء على أنظمة Apple الأساسية للأخطاء الشائعة في Authentication.

  • أضِف تجزئة SHA-1 لإصدار شهادة توقيع تطبيقك في إعدادات المشروع في وحدة تحكّم Firebase. يجب استخدام تجزئة SHA-1 إذا كان تطبيقك يستخدم ميزة تسجيل الدخول باستخدام رقم الهاتف أو ميزة "تسجيل الدخول باستخدام حساب Google" (التي تتطلّب عميل OAuth).

  • أضِف عناصر التحكّم في الوصول إلى نطاقاتك لمنع الاستخدام غير المصرَّح به. على وجه التحديد، يمكنك السماح بالوصول إلى نطاق الإنتاج في قسم Authentication في وحدة تحكّم Firebase (مهم بشكل خاص إذا كنت تستخدم منتجات تعتمد على Firebase Security Rules).

Cloud Firestore

  • اضبط إعدادات Cloud Firestore Security Rules لمنع الوصول غير المقصود إلى البيانات.

  • استخدِم ProGuard لتقليص حجم الرموز في بنية الإصدار. بدون ProGuard، يمكن أن تؤدي حزمة تطوير البرامج (SDK) لـ "Cloud Firestore" والتبعيات الخاصة بها إلى زيادة حجم حزمة APK.

Cloud Messaging

  • ننصحك بتفعيل تصدير بيانات "Cloud Messaging" إلى BigQuery لتتمكّن من تحليل بياناتك باستخدام لغة الاستعلامات البنيوية (SQL) في BigQuery أو تصدير البيانات لاستخدامها مع أدواتك الخاصة.

  • يُرجى تحميل مفتاح مصادقة APNS لـ "Cloud Messaging" على تطبيقات Apple في وحدة تحكّم "Firebase". في حال استخدام شهادات APNS، تأكَّد من تحميل شهادة APNS الخاصة بالإنتاج.

  • ننصحك بتفعيل تسجيل تدقيق السحابة الإلكترونية في "Cloud Messaging" لتتمكّن من إنشاء سجلّات تدقيق تسجّل الأنشطة الإدارية وأنشطة الوصول ضمن موارد Google Cloud.

  • احرص على تحديث حزمة تطوير البرامج (SDK) بشكل دوري إلى أحدث إصدار للاستفادة من الميزات الجديدة وتحديثات الأمان.

  • اتّبِع أفضل ممارسات إدارة الرموز المميّزة للتسجيل في Cloud Messaging على خادم تطبيقك. احفظ رموز التسجيل المميّزة مع طابع زمني، وعدِّلها عند حدوث تغييرات، وأزِل الرموز المميّزة القديمة (غير النشطة لأكثر من شهر) لضمان إعداد تقارير دقيقة عن التسليم واستهداف الرسائل بكفاءة.

  • اتّباع أفضل الممارسات عند إرسال رسائل Cloud Messaging على نطاق واسع استخدِم الإصدار 1 من واجهة برمجة التطبيقات HTTP أو Firebase Admin SDK، ونفِّذ استراتيجية الانتظار الأسي مع تفاوت في محاولات إعادة الإرسال، والتزم بعناوين Retry-After لتجنُّب الارتفاعات المفاجئة في عدد الزيارات والحدود القصوى لمعدّل الإرسال.

Cloud Storage

Crashlytics

  • تأكَّد من أنّ كل عضو معنيّ في المشروع (يُعرف أيضًا باسم "المبدأ") يضبط إعداداته المفضّلة لتلقّي تنبيهات حول Crashlytics أو حالة المشروع (مثل تغييرات خطة الفوترة أو حدود الحصة). يمكنك الاطّلاع على مزيد من المعلومات في مقالة تلقّي تنبيهات Firebase.

  • ننصحك بتفعيل تصدير بيانات "Crashlytics" إلى BigQuery لتتمكّن من تحليل بياناتك باستخدام لغة الاستعلامات البنيوية (SQL) في BigQuery أو تصدير البيانات لاستخدامها مع أدواتك الخاصة.

  • (لأجهزة Android وiOS فقط) ننصحك بتفعيل المساعدة المستندة إلى الذكاء الاصطناعي في Crashlytics للمساعدة في تسريع الوقت الذي يستغرقه فهم سبب حدوث عُطل والإجراءات التي يجب اتّخاذها.

  • يُرجى تحميل ملف dSYM لبُنى الإصدارات لاستخدامه في Crashlytics. تأكَّد من أنّ Xcode يمكنه معالجة dSYM وتحميل الملفات تلقائيًا.

  • يجب تحميل ملف ربط ProGuard لبُنى الإصدارات من أجل استخدامها في Crashlytics. يمكنك تحميل الملفات باستخدام واجهة سطر الأوامر (CLI) في Firebase.

  • اربط Firebase بـ "Google Play" للحصول على عرض أكثر تفصيلاً لحالة تطبيق Android. على سبيل المثال، يمكنك فلترة تقارير الأعطال في تطبيقك حسب قناة الإصدار Google Play، ما يتيح لك التركيز بشكل أفضل على إصدارات محدّدة في لوحة البيانات.

  • بالنسبة إلى الإصدارات التي تستهدف نظام التشغيل Android وتستخدم IL2CPP، تأكَّد من تحميل الرموز الأصلية لكل عملية تشغيل إصدار فردي تريد الحصول على رموز له بغض النظر عمّا إذا كانت هناك أي تغييرات في الرمز أو الإعدادات.

Firebase ML

Performance Monitoring

  • تأكَّد من أنّ كل عضو معنيّ في المشروع (يُعرف أيضًا باسم "المبدأ") يضبط إعداداته المفضّلة لتلقّي تنبيهات حول Performance Monitoring أو حالة المشروع (مثل تغييرات خطة الفوترة أو حدود الحصة). يمكنك الاطّلاع على مزيد من المعلومات في مقالة تلقّي تنبيهات Firebase.

  • ننصحك بتفعيل تصدير بيانات "Performance Monitoring" إلى BigQuery لتتمكّن من تحليل بياناتك باستخدام لغة الاستعلامات البنيوية (SQL) في BigQuery أو تصدير البيانات لاستخدامها مع أدواتك الخاصة.

Realtime Database

  • اضبط إعدادات Realtime Database Security Rules لمنع الوصول غير المقصود إلى البيانات.

  • تأكَّد من أنّك مستعد لتوسيع نطاق حملاتك. يحتوي Realtime Database على حصة تلقائية كبيرة بما يكفي لمعظم التطبيقات، ولكن قد تحتاج بعض التطبيقات إلى سعة إضافية.

  • اضبط قواعد ProGuard للعمل مع Realtime Database.

Remote Config

  • تأكَّد من أنّ أي قواعد تجريبية في Remote Config لا تؤثر في مستخدمي الإصدار، ومن أنّه يتم توزيع الإعدادات التلقائية المناسبة للخادم وداخل التطبيق في تطبيقك.

  • ننصحك بضبط مَعلمة minimum_version في Remote Config لتتمكّن من مطالبة المستخدمين أو إلزامهم بتحديث تطبيقهم إذا أصبحت الإصدارات السابقة غير متوافقة أو متوقفة نهائيًا.