DebugView به شما امکان می‌دهد داده‌های رویداد خام ثبت‌شده توسط برنامه‌تان را در دستگاه‌های توسعه تقریباً هم‌زمان ببینید. این کار برای اهداف اعتبارسنجی درطول مرحله ابزارسازی توسعه بسیار مفید است و می‌تواند به شما کمک کند خطاها و اشتباهات را در پیاده‌سازی Analytics خود کشف کنید و تأیید کنید که همه رویدادها و ویژگی‌های کاربر به‌درستی ثبت شده‌اند.
فعال کردن حالت اشکال‌زدایی
به‌طور کلی، رویدادهای ثبت‌شده توسط برنامه‌تان درطول دوره‌ای تقریباً یک ساعته باهم دسته‌بندی می‌شوند و باهم بارگذاری می‌شوند. این رویکرد باعث صرفه‌جویی در مصرف باتری دستگاه‌های کاربران نهایی می‌شود و مصرف داده شبکه را کاهش می‌دهد. بااین‌حال، برای اعتبارسنجی پیاده‌سازی Analytics (و برای مشاهده Analytics در گزارش DebugView)، می‌توانید حالت اشکال‌زدایی را در دستگاه توسعه‌تان فعال کنید تا رویدادها با حداقل تأخیر بارگذاری شوند.
iOS+
برای فعال کردن حالت اشکال‌زدایی Analytics در دستگاه توسعه، متغیر مستقل خط فرمان زیر را در Xcode مشخص کنید:
-FIRDebugEnabled
این رفتار تا زمانی که حالت اشکال‌زدایی را با مشخص کردن آرگومان خط فرمان زیر صریحاً غیرفعال نکنید ادامه خواهد داشت:
-FIRDebugDisabled
می‌توانید این آرگومان‌ها را با ویرایش طرح پروژه خود و افزودن یک ورودی جدید به «آرگومان‌های ارسال‌شده در راه‌اندازی» اضافه کنید.
Android
برای فعال کردن حالت اشکال‌زدایی Analytics در دستگاه Android، فرمان‌های زیر را اجرا کنید:
adb shell setprop debug.firebase.analytics.app PACKAGE_NAME
این رفتار تا زمانی که حالت اشکال‌زدایی را با اجرای فرمان زیر صریحاً غیرفعال نکنید ادامه خواهد داشت:
adb shell setprop debug.firebase.analytics.app .none.
وب
برای فعال کردن حالت اشکال‌زدایی Analytics در مرورگرتان، افزونه Chrome اشکال‌زدای Google Analytics را نصب کنید.
پس‌از نصب، افزونه را فعال کنید و صفحه را بازآورید. از آن نقطه به بعد، افزونه رویدادها را در برنامه شما در حالت اشکال‌زدایی ثبت می‌کند.
می‌توانید رویدادهای ثبت‌شده در DebugView را در کنسول Firebase مشاهده کنید.
مشاهده error رویداد
هم رویدادهای error که به‌طور خودکار ثبت شده‌اند (که نشان‌دهنده مشکلات مربوط به ثبت رویداد یا ویژگی کاربر هستند) و هم رویدادهای دیگری که شامل پارامتر firebase_error هستند در گزارش DebugView نشان داده می‌شوند.
توجه داشته باشید که درحالی‌که رویدادهای error مستقیماً در جاری‌سازی نشان داده می‌شوند، برای رویدادهای دیگری که شامل پارامتر firebase_error هستند، DebugView نشانگر خطای خاصی را در جاری‌سازی رویداد اصلی نمایش نمی‌دهد. برای مشاهده پارامتر firebase_error در فهرست پارامترها، باید روی رویداد کلیک کنید.
برای کمک به اشکال‌زدایی خطاهای پیاده‌سازی Analytics، گزارش‌های کنسول دستگاه را برای پیام‌های Firebase Analytics SDK بررسی کنید، که اغلب جزئیاتی درباره دلیل رد شدن یک رویداد یا پارامتر ارائه می‌دهند.
گزارش کردن داده‌های رویداد
مطمئن شوید که حالت اشکال‌زدایی را در دستگاه‌های توسعه خود فعال کرده‌اید، همان‌طور که در بخش قبلی این راهنما توضیح داده شده است.
در کنسول Firebase، به Analytics > DebugView بروید.
تعامل با برنامه‌تان را شروع کنید تا ببینید رویدادهای برنامه‌تان در گزارش DebugView در کنسول Firebase ثبت می‌شود.
جاری‌سازی «ثانیه‌ها» (ستون وسط) رویدادهایی را نشان می‌دهد که در ۶۰ ثانیه گذشته ثبت شده‌اند. جاری‌سازی «دقیقه‌ها» (ستون سمت راست) مجموعه‌ای از بایگانی‌های رویدادها را در ۳۰ دقیقه گذشته نشان می‌دهد. و ستون سمت چپ «رویدادهای برتر» ثبت‌شده در دوره ۳۰ دقیقه‌ای و همچنین «ویژگی‌های کاربر فعلی» را برای دستگاه توسعه انتخاب‌شده نشان می‌دهد.
جاری‌سازی ثانیه‌ها
به‌طور پیش‌فرض، فهرستی از رویدادهای ثبت‌شده در ۶۰ ثانیه گذشته را خواهید دید. هر رویداد مُهر زمانی را نشان می‌دهد که با زمان ثبت آن در دستگاه توسعه مطابقت دارد. می‌توانید روی رویدادی کلیک کنید تا فهرست پارامترهایی را که با آن رویداد مرتبط بوده‌اند ببینید.
با تغییر مقادیر مشخصه کاربر درطول استفاده از برنامه، ورودی‌ای برای آن تغییر خواهید دید.
جاری‌سازی دقیقه
این جاری‌سازی مجموعه‌ای از دایره‌ها را نشان می‌دهد که هرکدام با یک دقیقه زمان در ۳۰ دقیقه گذشته مطابقت دارد. عدد داخل دایره نشان‌دهنده تعداد رویدادهای دریافتی در آن دقیقه است. با کلیک کردن روی یکی از این دایره‌ها، جاری‌سازی «ثانیه‌ها» با رویدادهایی که در آن دقیقه ثبت شده‌اند پر می‌شود. این کار به شما امکان می‌دهد رویدادهای ثبت‌شده در ۳۰ دقیقه گذشته را با جزئیات دقیق بررسی کنید.
رویدادهای برتر و مشخصه‌های کاربر فعلی
جدول «رویدادهای برتر» رویدادهای برتری را که درطول دوره ۳۰ دقیقه‌ای ثبت شده‌اند نشان می‌دهد. و جدول «ویژگی‌های کاربر فعلی» جدیدترین وضعیت مجموعه «ویژگی‌های کاربر» را برای دستگاه توسعه انتخاب‌شده نشان می‌دهد.
گزینشگر دستگاه
ازآنجایی‌که حالت اشکال‌زدایی می‌تواند در دستگاه‌های توسعه مختلفی فعال باشد، می‌توانید از «انتخابگر دستگاه» برای انتخاب دستگاه خاصی که گزارش DebugView روی آن تمرکز خواهد کرد استفاده کنید. این کار به چندین توسعه‌دهنده امکان می‌دهد بدون تأثیر گذاشتن بر یکدیگر، بر تلاش‌های خود برای ابزارسازی و اعتبارسنجی تمرکز کنند.
