PlayStore12Tester
دليل المطور

كيفية كتابة تقرير خطأ Android

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

ابدأ ببيئة قابلة للتكرار

قم بتسجيل إصدار التطبيق وبناءه، وإصدار Android، وطراز الجهاز أو المحاكي، والإعدادات ذات الصلة. لاحظ حالة الحساب وبيانات الاختبار دون تضمين كلمات المرور أو المعلومات الشخصية. تقرير عن البناء القديم يجب أن يقول ذلك.

  • حدد البنية الدقيقة التي اختبرتها.
  • قم بتسجيل الشاشة وحالة الحساب وظروف الشبكة اللازمة للبدء.
  • قم بوصف أي إعدادات تؤثر على المشكلة، مثل النص الكبير أو لغة مختلفة.

اكتب إجراءً واحدًا في كل خطوة

ابدأ من حالة يمكن لمختبر آخر الوصول إليها. استخدم تسلسلاً مرقّمًا قصيرًا مع عناصر تحكم مرئية ومدخلات ملموسة. احتفظ بالمشكلات غير ذات الصلة في تقارير منفصلة.

  • افتح التطبيق وانتقل إلى الشاشة المتأثرة.
  • أدخل قيمة الاختبار أو قم بتنفيذ الإجراء الذي يؤدي إلى حدوث المشكلة.
  • صف النتيجة المرئية وعدد المرات التي لاحظتها فيها.

افصل بين النتيجة المتوقعة والفعلية

تشرح النتيجة المتوقعة ما يجب أن يحدث ولماذا يعتبر ذلك معقولًا. النتيجة الفعلية تسجل ما رأيته. تجنب افتراض السبب الجذري ما لم يتم التحقق منه. الخطورة تصف التأثير؛ لا يزال الفريق يقرر الأولوية الكاملة.

مثال عملي: إجراء نموذج مخفي

سيناريو توضيحي، وليس نتيجة عميل مُقاسة: بعد زيادة حجم النص، يقع إجراء النموذج أسفل لوحة ثابتة ولا يمكن الوصول إليه. يحدد التقرير المفيد البنية وحجم النافذة وإعدادات النص وخطوات التنقل وسلوك التمرير المتوقع. أرفق مرجعًا منقحًا للقطة الشاشة إذا كان لديك واحدًا.

اجعل الأدلة مفيدة وآمنة للمشاركة

يجب أن تظهر لقطة الشاشة أو التسجيل القصير الحالة ذات الصلة. قم بالإشارة إلى ملف أو مرفق يمكن التحكم في الوصول إليه في أداة تعقب المشكلات لديك. قم بإزالة بيانات الاعتماد والبيانات الشخصية من اللقطات والسجلات قبل المشاركة. هذا الموقع لا يقوم بتحميل الأدلة.

أغلق الحلقة بإعادة الاختبار

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

الأسئلة المتداولة

هل هذا هو نفس تقرير أخطاء نظام Android؟

لا، هذا وصف منظم للمشكلة لشخص أو متتبع المشكلة. تحتوي تقارير أخطاء نظام Android على سجلات تشخيصية ويتم جمعها بشكل منفصل باستخدام أدوات Android.

هل يقوم المولد باختبار تطبيقي؟

لا، يمكنك إدخال الملاحظات من الاختبار الخاص بك. يقوم المولد بتنسيقها؛ فهو لا يقوم بفحص ملف APK أو جمع سجلات الجهاز أو التحقق من وجود خلل.

ما مقدار التفاصيل الكافية؟

قم بتضمين سياق كافٍ لشخص آخر للوصول إلى نفس الحالة، واتبع الخطوات وقارن النتائج. اجعل التقرير يركز على قضية واحدة.

المصادر ومزيد من القراءة