שאלות נפוצות ופתרון בעיות שקשורות לכלים לאמולטור מקומי ב-Firebase

למה ביומני Local Emulator Suite מופיעה שגיאה שמתחילה במילים ‎"Multiple projectIds are not recommended in single project mode"‎?

ההודעה הזו מציינת שמכשיר Local Emulator Suite זיהה שהוא עשוי להריץ אמולטור מוצר מסוים באמצעות מזהי פרויקט שונים. יכול להיות שהסיבה לכך היא הגדרה שגויה, והיא עלולה לגרום לבעיות כשמנסים ליצור תקשורת בין אמולטורים, וכשמנסים ליצור אינטראקציה עם אמולטורים מהקוד. אם מזהי הפרויקטים לא תואמים, לעיתים קרובות נראה שהנתונים חסרים, כי הנתונים שמאוחסנים באמולטורים מקושרים למזהה הפרויקט, והיכולת לפעול יחד תלויה במזהי פרויקטים תואמים.

זו הייתה בעיה נפוצה בקרב מפתחים, ולכן כברירת מחדל, Local Emulator Suite יאפשר הפעלה רק עם מזהה פרויקט אחד, אלא אם תציינו אחרת בקובץ ההגדרות firebase.json. אם אמולטור מזהה יותר ממזהה פרויקט אחד, הוא ירשום אזהרה ועלול להציג שגיאה חמורה.

בודקים את ההצהרות על מזהה הפרויקט כדי לזהות אי-התאמות ב:

• פרויקט ברירת המחדל שהוגדר בשורת הפקודה. כברירת מחדל, מזהה הפרויקט יילקח בהפעלה מהפרויקט שנבחר באמצעות firebase init או firebase use. כדי לראות את רשימת הפרויקטים (ולבדוק איזה פרויקט נבחר), משתמשים בפקודה firebase projects:list.
• בדיקות יחידה. מזהה הפרויקט מצוין לעיתים קרובות בקריאות לשיטות של ספריית בדיקות היחידות של הכללים initializeTestEnvironment או initializeTestApp. קוד בדיקה אחר עשוי להתחיל עם initializeApp(config).
• הדגל --project בשורת הפקודה. העברת הדגל Firebase של --project CLI מבטלת את פרויקט ברירת המחדל. צריך לוודא שערך הדגל זהה למזהה הפרויקט בבדיקות יחידה ובאתחול האפליקציה.

מקומות ספציפיים לפלטפורמה שכדאי לבדוק:

כדי להשבית את מצב הפרויקט היחיד, מעדכנים את firebase.json באמצעות המפתח singleProjectMode:

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