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

اگر برنامه خود را بدون مجموعه ای از گزینه های 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 —توجه: این یک شناسه Apple Bundle نیست .
      مقدار مثال: 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 یکسان نیستند) نباید در برنامه‌ها گنجانده شوند، زیرا ممکن است از آنها برای ارسال اعلان‌های فشار به نام پروژه شما سوء استفاده شود.