أحداث تصحيح الأخطاء

ويتيح لك DebugView الاطّلاع على بيانات الأحداث الأولية التي سجّلها تطبيقك على أجهزة التطوير في الوقت الفعلي تقريبًا. يفيد ذلك للغاية في أغراض التحقق من الصحة أثناء مرحلة قياس حالة التطبيق، ويمكن أن يساعدك في اكتشاف الأخطاء والأخطاء في تنفيذ "إحصاءات Google" والتأكّد من تسجيل جميع الأحداث وخصائص المستخدمين بشكلٍ صحيح.

تفعيل وضع تصحيح الأخطاء

وبشكل عام، يتم تجميع الأحداث التي سجّلها تطبيقك معًا على مدار ساعة واحدة تقريبًا، ثم يتم تحميلها معًا. يحفظ هذا الأسلوب طاقة البطارية في أجهزة المستخدمين النهائيين ويقلل من استخدام بيانات الشبكة. ومع ذلك، لأغراض التحقق من صحة تنفيذ "إحصاءات Google" (ولعرض "إحصاءات Google" في تقرير DebugView)، يمكنك تفعيل وضع تصحيح الأخطاء على جهاز التطوير لتحميل الأحداث بأقل قدر من التأخير.

iOS+

لتفعيل وضع تصحيح الأخطاء في "إحصاءات Google" على جهاز التطوير، حدِّد وسيطة سطر الأوامر التالية في Xcode:

-FIRDebugEnabled

يستمرّ هذا السلوك إلى أن يتم إيقاف وضع تصحيح الأخطاء بشكلٍ صريح من خلال تحديد وسيطة سطر الأوامر التالية:

-FIRDebugDisabled

يمكنك إضافة هذه الوسيطات من خلال تعديل مخطط مشروعك وإضافة إدخال جديد إلى "الوسيطات التي تم تمريرها عند الإطلاق".

Android

لتفعيل وضع تصحيح الأخطاء في "إحصاءات Google" على جهاز Android، نفِّذ الطلبات التالية:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

يستمرّ هذا السلوك إلى أن يتم إيقاف وضع تصحيح الأخطاء بشكلٍ صريح من خلال تنفيذ الأمر التالي:

adb shell setprop debug.firebase.analytics.app .none.

الويب

لتفعيل وضع تصحيح الأخطاء في "إحصاءات Google" في المتصفّح، يجب تثبيت إضافة Chrome برنامج تصحيح الأخطاء في "إحصاءات Google".

بعد تثبيت الإضافة، فعِّلها وأعِد تحميل الصفحة. ومن الآن فصاعدًا، ستسجّل الإضافة الأحداث في تطبيقك في وضع تصحيح الأخطاء.

يمكنك عرض الأحداث التي تم تسجيلها في DebugView ضمن وحدة تحكُّم Firebase.

إعداد تقارير عن بيانات الأحداث

بعد تفعيل وضع تصحيح الأخطاء على أجهزة التطوير، انتقِل إلى DebugView باختيار السهم بجانب StreamView في شريط التنقّل العلوي من "إحصاءات Google" واختيار DebugView.

انتقِل إلى DebugView من خلال اختيار السهم بجانب StreamView في شريط التنقّل العلوي من "إحصاءات Google" واختيار DebugView.

بعد ذلك، ما عليك سوى بدء استخدام تطبيقك للاطّلاع على أحداث التطبيق التي يتم تسجيلها في تقرير DebugView.

تقرير DebugView

تعرِض سلسلة بطاقات الثواني (العمود الأوسط) الأحداث التي تمّ تسجيلها خلال آخر 60 ثانية. وتعرِض سلسلة بطاقات الدقائق (العمود الأيمن) سلسلة من أرشيفات الأحداث خلال آخر 30 دقيقة. ويعرِض العمود الأيسر أهم الأحداث المسجّلة في فترة الثلاثين دقيقة بالإضافة إلى "خصائص المستخدِمين الحالية" لجهاز التطوير المحدَّد حاليًا.

سلسلة بطاقات الثواني

بشكل افتراضي، ستظهر قائمة بالأحداث التي تم تسجيلها في الثواني الـ 60 الأخيرة. ويعرض كل حدث طابعًا زمنيًا يقابل وقت تسجيله على جهاز التطوير. ويمكنك النقر على حدث للاطّلاع على قائمة بالمعلَمات التي كانت مرتبطة بهذا الحدث.

مثال على قائمة مَعلمات الأحداث

ومع تغيّر قيم خصائص المستخدمين أثناء فترة استخدام التطبيق، سيظهر لك إدخال لهذا التغيير.

مثال لخاصيّة مستخدِم

سلسلة بطاقات الدقائق

يعرض هذا البث سلسلة من الدوائر تتوافق كل منها مع دقيقة من الوقت على مدار آخر 30 دقيقة. ويشير الرقم في الدائرة إلى عدد الأحداث التي تم تلقّيها في تلك الدقيقة. ويؤدي النقر على إحدى هذه الدوائر إلى تعبئة سلسلة بطاقات الثواني بالأحداث التي تم تسجيلها خلال هذه الدقيقة من الوقت. ويتيح لك ذلك بشكل فعّال فحص الأحداث التي تم تسجيلها خلال آخر 30 دقيقة بتفاصيل دقيقة.

مثال على مجموعة الدقائق

أهم الأحداث وخصائص المستخدمين الحالية

يتم استخدام جدول "أهم الأحداث" لعرض أهم الأحداث التي تم تسجيلها خلال فترة الثلاثين دقيقة. ويعرض جدول "خصائص المستخدمين الحالية" أحدث حالة لمجموعة "خصائص المستخدمين" لجهاز التطوير المحدّد حاليًا.

مثال على جدول أهم الأحداث

أداة اختيار الأجهزة

وبما أنّه يمكن تفعيل وضع تصحيح الأخطاء في العديد من أجهزة التطوير المختلفة، يمكنك استخدام أداة اختيار الأجهزة لاختيار الجهاز المحدّد الذي سيركّز عليه تقرير DebugView. ويسمح هذا للعديد من مطوّري البرامج بالتركيز على أدواتهم وجهود التحقّق من الصحة بدون تأثير بعضهم في البعض الآخر.

مثال على أداة اختيار الأجهزة