سوالات متداول و عیب‌یابی مجموعه شبیه‌ساز محلی فایربیس

چرا گزارش‌های Local Emulator Suite خطایی با عنوان «استفاده از چندین شناسه پروژه در حالت تک پروژه توصیه نمی‌شود» را نشان می‌دهند؟

این پیام به این معنی است که Local Emulator Suite تشخیص داده است که ممکن است یک شبیه‌ساز محصول خاص را با استفاده از شناسه‌های پروژه مختلف اجرا کند. این ممکن است نشان‌دهنده یک پیکربندی نادرست باشد و می‌تواند هنگام تلاش شبیه‌سازها برای برقراری ارتباط با یکدیگر و همچنین هنگام تلاش شما برای تعامل با شبیه‌سازها از کد شما، مشکلاتی ایجاد کند. اگر شناسه‌های پروژه مطابقت نداشته باشند، اغلب به نظر می‌رسد که داده‌ها از دست رفته‌اند، زیرا داده‌های ذخیره شده در شبیه‌سازها به projectID مرتبط هستند و قابلیت همکاری به تطبیق شناسه‌های پروژه بستگی دارد.

این موضوع باعث سردرگمی رایجی در بین توسعه‌دهندگان شده است، بنابراین به‌طور پیش‌فرض Local Emulator Suite فقط اجازه اجرا با یک شناسه پروژه را می‌دهد، مگر اینکه در فایل پیکربندی firebase.json خلاف آن را مشخص کنید. اگر یک شبیه‌ساز بیش از یک شناسه پروژه را شناسایی کند، یک هشدار ثبت می‌کند و به‌طور بالقوه یک خطای مهلک ایجاد می‌کند.

اعلان‌های شناسه پروژه خود را برای عدم تطابق در موارد زیر بررسی کنید:

• پروژه پیش‌فرض در خط فرمان تنظیم شده است. به طور پیش‌فرض، شناسه پروژه در هنگام راه‌اندازی از پروژه انتخاب شده با firebase init یا firebase use گرفته می‌شود. برای مشاهده لیست پروژه‌ها (و دیدن اینکه کدام یک انتخاب شده است) firebase projects:list استفاده کنید.
• تست‌های واحد. شناسه پروژه اغلب در فراخوانی متدهای کتابخانه تست واحد Rules به نام initializeTestEnvironment یا initializeTestApp مشخص می‌شود. سایر کدهای تست ممکن است با initializeApp(config) مقداردهی اولیه شوند.
• پرچم --project در خط فرمان. ارسال پرچم --project در Firebase CLI، پروژه پیش‌فرض را لغو می‌کند. باید مطمئن شوید که مقدار این پرچم با شناسه پروژه در تست‌های واحد و مقداردهی اولیه برنامه مطابقت دارد.

مکان‌های مخصوص پلتفرم برای بررسی:

برای غیرفعال کردن حالت تک پروژه، firebase.json با کلید singleProjectMode به‌روزرسانی کنید:

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