الأسئلة الشائعة وتحديد المشاكل وحلّها في "مجموعة أدوات المحاكاة المحلية لـ Firebase"

لماذا تعرض سجلّات Local Emulator Suite خطأً يبدأ بـ "لا يُنصح باستخدام عدّة أرقام تعريف للمشاريع في وضع المشروع الفردي"؟

تعني هذه الرسالة أنّ Local Emulator Suite رصد أنّه قد يتم تشغيل محاكي منتج معيّن باستخدام معرّفات مشاريع مختلفة. وقد يشير ذلك إلى خطأ في الضبط، ويمكن أن يتسبّب في حدوث مشاكل عند محاولة المحاكيات التواصل مع بعضها البعض، وعند محاولة التفاعل مع المحاكيات من الرمز البرمجي. إذا لم تتطابق أرقام تعريف المشاريع، سيظهر غالبًا أنّ البيانات غير متوفّرة، لأنّ البيانات المخزّنة في المحاكيات يتم ربطها برقم تعريف المشروع، وتعتمد إمكانية التشغيل التفاعلي على تطابق أرقام تعريف المشاريع.

وقد كان هذا الأمر مصدرًا شائعًا للالتباس بين المطوّرين، لذا لن يسمح Local Emulator Suite تلقائيًا بالتشغيل إلا باستخدام رقم تعريف مشروع واحد، ما لم تحدّد خلاف ذلك في ملف الإعداد firebase.json. إذا رصد المحاكي أكثر من رقم تعريف مشروع واحد، سيسجّل تحذيرًا وقد يعرض خطأ فادحًا.

تحقَّق من بيانات رقم تعريف مشروعك بحثًا عن حالات عدم تطابق في ما يلي:

• المشروع التلقائي الذي تم ضبطه في سطر الأوامر سيتم تلقائيًا الحصول على رقم تعريف المشروع عند بدء التشغيل من المشروع الذي تم اختياره باستخدام firebase init أو firebase use. لعرض قائمة المشاريع (ومعرفة المشروع المحدّد)، استخدِم firebase projects:list.
• اختبارات الوحدات: يتم غالبًا تحديد رقم تعريف المشروع في طلبات إلى طرق مكتبة اختبارات وحدة القواعد initializeTestEnvironment أو initializeTestApp. قد تتم تهيئة رمز الاختبار الآخر باستخدام initializeApp(config).
• العلامة --project في سطر الأوامر يؤدي تمرير العلامة Firebase CLI --project إلى إلغاء المشروع التلقائي. عليك التأكّد من أنّ قيمة العلامة تتطابق مع رقم تعريف المشروع في اختبارات الوحدات وإعداد التطبيق.

الأماكن التي يجب التحقّق منها على كل منصة:

لإيقاف وضع المشروع الفردي، عدِّل firebase.json باستخدام المفتاح singleProjectMode:

{
  "firestore": {
    ...
  },
  "functions": {
    ...
  },
  "hosting": {
    ...
  },
  "emulators": {
    "singleProjectMode": false,
    "auth": {
      "port": 9099
    },
    "functions": {
      "port": 5001
    },
    ...
  }
}