Check out what’s new from Firebase at Google I/O 2022. Learn more

عیب یابی گزینه های مقداردهی اولیه

اگر برنامه خود را بدون مجموعه ای از گزینه های Firebase معتبر راه اندازی کنید، کاربران جدید برنامه شما با مشکلات جدی مواجه خواهند شد.

گزینه های Firebase مجموعه ای از پارامترهای مورد نیاز سرویس ها برای برقراری ارتباط موفقیت آمیز با API های سرور Firebase و مرتبط کردن داده های مشتری با پروژه Firebase و برنامه Firebase شما هستند. خدمات Firebase به گزینه های معتبر Firebase متکی است که از هسته Firebase/کتابخانه مشترک ایجاد شده در طول اولیه سازی Firebase در دسترس هستند.

سرویس‌های مختلف Firebase برای عملکرد صحیح به گزینه‌های Firebase مختلفی نیاز دارند، اما همه سرویس‌های Firebase به گزینه‌های Firebase زیر نیاز دارند:

  • کلید API - توجه: این یک کلید سرور FCM نیست ، به کلیدهای سرور FCM مراجعه کنید.
    مقدار مثال: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
  • شناسه پروژه - مقدار مثال: myapp-project-123 .
  • شناسه برنامه ("AppID") - شناسه منحصر به فرد برای برنامه شما که قالب آن به پلت فرم بستگی دارد:
    • برای Android: mobilesdk_app_id توجه: این نام بسته اندروید نیست .
      مقدار مثال: 1:1234567890:android:321abc456def7890
    • برای iOS+: GOOGLE_APP_ID —توجه: این یک شناسه باندل اپل نیست .
      مقدار مثال: 1:1234567890:ios:321abc456def7890

عیب یابی اپلیکیشن های اندروید

برای بهبود امنیت، Firebase SDK را در 27 فوریه به‌روزرسانی کرد و پس از آن سرویس Firebase Instance ID را با وابستگی به Firebase Installations API جایگزین کرد.

نصب Firebase وجود و اعتبار کلید API گزینه های Firebase اجباری، شناسه پروژه و شناسه برنامه را اعمال می کند تا داده های مشتری را با پروژه Firebase شما مرتبط کند. برای اطلاعات بیشتر به FirebaseOptions مراجعه کنید.

Firebase Cloud Messaging (FCM) با Firebase Instance ID (IID)

اگر کاربران جدید برنامه شما با FCM مشکل دارند، این امکان وجود دارد که Firebase را بدون مجموعه مورد نیاز از گزینه های Firebase مقداردهی اولیه کنید.

ممکن است برنامه شما از یک فایل پیکربندی ناقص یا اشتباه google-services.json استفاده کند. یا برنامه شما به صورت برنامه‌ریزی Firebase را بدون مجموعه کامل گزینه‌های Firebase مورد نیاز، مقداردهی اولیه می‌کند.

در نتیجه، سرویس‌های Firebase مانند Firebase Cloud Messaging برای کاربران نهایی که برنامه شما را پس از انتشار به‌روزرسانی‌شده Firebase SDK نصب کرده‌اند، دچار اختلال می‌شوند. علاوه بر این، درخواست‌های ناموفق مکرر به Firebase ممکن است تجربه کاربر نهایی برنامه شما را کاهش دهد.

چه کاری باید انجام دهم؟

برای رفع خرابی سرویس های Firebase برای برنامه های خود:

  1. برنامه خود را با مقداردهی اولیه Firebase با کلید API معتبر پروژه، شناسه پروژه معتبر و شناسه برنامه معتبر ( mobilesdk_app_id یا "App ID") به روز کنید.
  2. نسخه جدیدی از برنامه خود را در فروشگاه Play منتشر کنید.

عیب یابی اپلیکیشن های اپل

برای بهبود امنیت، Firebase SDK در 14 ژانویه به‌روزرسانی شد و پس از آن سرویس Firebase Instance ID را با وابستگی به Firebase Installations API جایگزین کرد.

نصب Firebase وجود و اعتبار کلید API گزینه های Firebase اجباری، شناسه پروژه و شناسه برنامه را اعمال می کند تا داده های مشتری را با پروژه Firebase شما مرتبط کند. برای اطلاعات بیشتر به FIROptions مراجعه کنید.

Firebase Cloud Messaging (FCM) با Firebase Instance ID (IID)

اگر کاربران جدید برنامه شما با FCM مشکل دارند، این امکان وجود دارد که Firebase را بدون مجموعه مورد نیاز از گزینه های Firebase مقداردهی اولیه کنید.

ممکن است برنامه شما از یک فایل پیکربندی GoogleService-Info.plist ناقص یا نامعتبر استفاده کند. یا برنامه شما به صورت برنامه‌ریزی Firebase را بدون مجموعه کامل گزینه‌های Firebase مورد نیاز، مقداردهی اولیه می‌کند.

در نتیجه، سرویس‌های Firebase مانند Firebase Cloud Messaging برای کاربران نهایی که برنامه شما را پس از انتشار به‌روزرسانی‌شده Firebase SDK نصب کرده‌اند، دچار اختلال می‌شوند. علاوه بر این، درخواست‌های ناموفق مکرر به Firebase ممکن است تجربه کاربر نهایی برنامه شما را کاهش دهد.

چه کاری باید انجام دهم؟

برای رفع خرابی سرویس های Firebase برای برنامه های خود:

  1. برنامه خود را با مقداردهی اولیه Firebase با یک کلید API معتبر پروژه، شناسه پروژه معتبر و شناسه برنامه معتبر ( GOOGLE_APP_ID یا "App ID") به روز کنید.
    1. فرآیند اولیه سازی پیش فرض با استفاده از فایل پیکربندی Firebase: فایل پیکربندی GoogleService-Info.plist خود را از کنسول Firebase دانلود کنید ، سپس فایل موجود را در برنامه خود جایگزین کنید.
    2. مقداردهی اولیه برنامه‌ای با استفاده از شی FIROptions : فایل پیکربندی GoogleService-Info.plist خود را از کنسول Firebase دانلود کنید تا کلید API، شناسه پروژه و شناسه برنامه خود را پیدا کنید، سپس این مقادیر را در شیء FIROptions در برنامه خود به‌روزرسانی کنید.
  2. نسخه جدیدی از برنامه خود را در اپ استور منتشر کنید.

کلیدهای سرور FCM

اگر برنامه شما از کلید FCM Server به جای کلید Cloud API استفاده می‌کند، در صورتی که از همان کلید FCM Server برای ارسال اعلان‌های فشار از طریق FCM استفاده می‌کنید، ممکن است آسیب‌پذیری امنیتی ایجاد کند. در این مورد، ما قویاً توصیه می‌کنیم که نحوه احراز هویت سرور شما درخواست‌ها را به FCM ارسال کند .

توجه داشته باشید که کلیدهای سرور FCM (که با کلیدهای Firebase/Cloud API یکسان نیستند) نباید در برنامه‌ها گنجانده شوند، زیرا ممکن است از آنها برای ارسال اعلان‌های فشار به نام پروژه شما سوء استفاده شود.