تتيح لك أداة 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".
بعد تثبيت الإضافة، فعِّلها وأعِد تحميل الصفحة. ومن تلك اللحظة فصاعدًا، ستسجّل الإضافة الأحداث داخل تطبيقك في وضع تصحيح الأخطاء.
يمكنك عرض الأحداث المسجّلة في DebugView ضمن وحدة تحكّم Firebase.
إعداد تقارير عن بيانات الأحداث
بعد تفعيل وضع تصحيح الأخطاء على أجهزة التطوير، انتقِل إلى DebugView من خلال النقر على السهم بجانب StreamView في شريط التنقّل العلوي من Google Analytics واختيار DebugView.
"إحصاءات Google" واختيار DebugView">
بعد ذلك، ما عليك سوى بدء استخدام تطبيقك للاطّلاع على أحداث تطبيقك التي يتم تسجيلها في تقرير DebugView.
تعرِض سلسلة بطاقات الثواني (العمود الأوسط) الأحداث التي تم تسجيلها خلال آخر 60 ثانية. وتعرِض سلسلة بطاقات الدقائق (العمود الأيمن) سلسلة من أرشيفات الأحداث خلال آخر 30 دقيقة. ويعرِض العمود الأيسر أهم الأحداث المسجّلة في فترة الثلاثين دقيقة بالإضافة إلى "خصائص المستخدمين الحالية" لجهاز التطوير المحدّد حاليًا.
سلسلة بطاقات الثواني
بشكل افتراضي، ستظهر قائمة بالأحداث التي تم تسجيلها في الثواني الـ 60 الأخيرة. يعرض كل حدث طابعًا زمنيًا يقابل وقت تسجيله على جهاز التطوير. يمكنك النقر على حدث للاطّلاع على قائمة بالمَعلمات التي كانت مرتبطة بهذا الحدث.
وفي ظل تغيُّر قيم خصائص المستخدِمين خلال فترة استخدام التطبيق، سيظهر لك إدخال لهذا التغيُّر.
سلسلة بطاقات الدقائق
تعرض سلسلة البطاقات هذه سلسلة من الدوائر التي تتوافق كلّ منها مع دقيقة واحدة من الزمن على مدار آخر 30 دقيقة. ويشير الرقم في الدائرة إلى عدد الأحداث التي تم تلقّيها في تلك الدقيقة. يؤدي النقر على إحدى هذه الدوائر إلى تعبئة سلسلة بطاقات الثواني بالأحداث التي تم تسجيلها خلال هذه الدقيقة من الوقت. يتيح لك ذلك فحص الأحداث التي تم تسجيلها خلال الدقائق الثلاثين الماضية بتفاصيل دقيقة وبشكل فعّال.
أهم الأحداث وخصائص المستخدمين الحالية
يعرِض جدول "أهم الأحداث" أهم الأحداث التي تم تسجيلها خلال فترة 30 دقيقة. ويعرِض جدول "خصائص المستخدِمين الحالية" أحدث حالة لمجموعة "خصائص المستخدِمين" لجهاز التطوير المحدّد حاليًا.
أداة اختيار الأجهزة
بما أنّه يمكن تفعيل وضع تصحيح الأخطاء على العديد من أجهزة التطوير المختلفة، يمكنك استخدام أداة اختيار الأجهزة لاختيار الجهاز المحدّد الذي سيركّز عليه تقرير DebugView. ويسمح هذا للعديد من المطوّرين بالتركيز على أدواتهم وجهود التحقّق من الصحة بدون تأثير بعضهم في البعض الآخر.
