تحليل المشاكل من Firebase Crashlytics باستخدام أداة "إحصاءات جودة التطبيق"

يمكنك الاطّلاع على بيانات أعطال التطبيق من Firebase Crashlytics مباشرةً في "استوديو Android"، واتخاذ إجراءات بشأنها. تعمل عملية الدمج هذه على نقل بيانات تتبُّع تسلسل استدعاء الدوال البرمجية وإحصاءات الأعطال من Crashlytics إلى نافذة أداة إحصاءات جودة التطبيقات في بيئة تطوير البرامج (IDE) في Studio، بحيث لا تحتاج إلى التنقّل كثيرًا بين متصفّحك وحزمة Studio IDE. يمكن لفرق التطوير الاستفادة من القدرات الأساسية بما في ذلك ما يلي:

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

وإذا لم تكن تستخدم Crashlytics بعد وتريد معرفة المزيد من المعلومات عن العروض التي تقدّمها، يمكنك الاطّلاع على Firebase Crashlytics.

البدء

للاطّلاع على بيانات Crashlytics في "استوديو Android"، عليك إعداد Firebase وCrashlytics في مشروع تطبيقك. وإليك خطوات إجراء ذلك: افتح "مساعد Firebase" في "استوديو Android" من خلال الانتقال إلى الأدوات > Firebase، ثم انقر على Crashlytics، ثم اتّبِع البرنامج التعليمي لإضافة Firebase وCrashlytics إلى مشروعك. ويمكنك الاطّلاع على مزيد من المعلومات عن سير عمل "مساعد Firebase" في دليل الخطوات الأولى لنظام Firebase لنظام التشغيل Android.

إذا سبق لك إضافة Firebase وCrashlytics إلى تطبيقك، سجِّل الدخول إلى حساب المطوّر في بيئة التطوير المتكاملة من خلال النقر على رمز الصورة الرمزية . بعد تسجيل الدخول، انقر على نافذة أداة إحصاءات جودة التطبيقات. من المفترض أن تظهر لك لوحات المشاكل ونموذج تتبُّع تسلسل استدعاء الدوال البرمجية ولوحات التفاصيل والتي تتضمّن تقارير من Crashlytics.

التنقّل بين بيانات Crashlytics في "استوديو Android"

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

1. إذا كان مشروعك يتضمّن وحدات تطبيقات متعددة، احرص على اختيار الوحدة التي تريد الاطّلاع على بيانات الأحداث الخاصة بها من القائمة المنسدلة للوحدات.
2. استخدم القائمة المنسدلة لأرقام تعريف التطبيق لاختيار رقم تعريف التطبيق الذي تريد تحليله. على سبيل المثال، بينما قد تعمل على إصدار تصحيح الأخطاء لتطبيقك في بيئة التطوير المتكاملة (IDE)، قد تحتاج إلى الاطّلاع على بيانات الأحداث لإصدار الإنتاج من تطبيقك الذي يثبّته المستخدمون.
3. تعرض لوحة المشاكل أهم الأحداث التي تتوفّر لدى Crashlytics بيانات عنها، ويتم ترتيبها حسب الأعطال الأكثر تأثيرًا.

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

   وهناك أيضًا معلومات حول نوع الجهاز المتأثر وإصدار Android ووقت وقوع الحدث بالإضافة إلى رابط يؤدي إلى الفعالية في لوحة بيانات Firebase Crashlytics. انقر على الزر إغلاق لإغلاق مشكلة مباشرةً من اللوحة.

5. تقسّم لوحة التفاصيل أعداد الأعطال حسب نوع الجهاز وإصدار Android، وذلك لتتمكّن من تحديد مجموعات المستخدمين الأكثر تأثرًا. وتعرض أيضًا إصدارات التطبيق التي تعطّلت وعدد المستخدمين المتأثّرين بهذا التعطُّل.
6. يمكنك قراءة الملاحظات وإرفاقها بالمشاكل لتظهر في وحدة تحكّم Firebase وزملائك في الفريق. لكتابة ملاحظة عن مشكلة، اختَر المشكلة وافتح لوحة الملاحظات. يجب أن يكون لديك إذن بالكتابة في مشروع Crashlytics كي تتمكن من كتابة ملاحظات. تظهر المشاكل المتعلقة بالملاحظات مع رمز "الملاحظات" في لوحة المشاكل.

   

7. استخدِم مجموعة متنوعة من الفلاتر للتركيز على مجموعات فرعية معيّنة من الأحداث. يمكنك اختيار أو إلغاء اختيار الأحداث التي تُعدّ "" الفادحة أو "" غير الفادحة، بالإضافة إلى الفلترة حسب الوقت وإصدار التطبيق وإشارات Crashlytics والعلامة التجارية للجهاز وطرازه وإصدار نظام Android الأساسي. وتجدُر الإشارة إلى أنّه بالنسبة إلى حالات إشارة Crashlytics، تُعتبر المشكلة متراجعة إذا تم إغلاقها في السابق وتكررت في إصدار جديد من التطبيق.

بالإضافة إلى إمكانية الانتقال من تتبُّع تسلسل استدعاء الدوال البرمجية إلى تتبُّع تسلسل استدعاء الدوال البرمجية، يمكنك أيضًا الانتقال من تتبُّع تسلسل استدعاء الدوال البرمجية إلى تتبُّع تسلسل استدعاء الدوال البرمجية. يضيف "استوديو Android" الآن تعليقات توضيحية إلى سطور الرمز المرتبطة بالأعطال التي تظهر بجانبها رمز هامش التعطُّل لتتمكّن من رصدها وتصحيح أخطائها بسهولة.

عندما تمرِّر مؤشّر الماوس فوق رمز التعطّل، تظهر نافذة منبثقة تعرِض عدد الأحداث التي تتضمّن هذا السطر من الرمز ومعدّلات تكرار الأحداث.

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

تحليل "مؤشرات Android الحيوية"

تتضمن إحصاءات جودة التطبيقات بيانات مؤشرات Android الحيوية. ويتيح لك ذلك الوصول بسهولة أكبر إلى المقاييس الأساسية التي يجمعها Google Play وتحسين تجربة المستخدم. يمكنك استخدام "مؤشرات Android الحيوية" لمعالجة المشاكل المتعلقة بثبات التطبيق للمساعدة في تحسين جودة تطبيقك على Google Play.

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

1. سجِّل الدخول إلى حساب المطوّر الخاص بك في "استوديو Android" باستخدام رمز الملف الشخصي في نهاية شريط الأدوات.
2. افتح إحصاءات جودة التطبيقات من خلال النقر على نافذة الأداة في "استوديو Android" أو النقر على عرض > نوافذ الأداة > إحصاءات جودة التطبيقات.
3. انقر على علامة التبويب مؤشرات Android الحيوية ضمن إحصاءات جودة التطبيقات.

اختلاف الأرقام بين "مؤشرات Android الحيوية" وCrashlytics

يُرجى ملاحظة أنّ "مؤشرات Android الحيوية" وCrashlytics قد تُبلِغ عن قيم مختلفة لأعداد المستخدمين والأحداث المرتبطة بالعطل نفسه. تحدث هذه التناقضات لأنّ Play وCrashlytics يمكنه رصد الأعطال في أوقات مختلفة وللمستخدمين المختلفين. إليك بعض الأسباب التي قد تؤدي إلى اختلاف أعداد Play وCrashlytics:

• يرصد Play الأعطال بدءًا من وقت التشغيل، في حين ترصد Crashlytics الأعطال التي تحدث بعد إعداد حزمة تطوير البرامج (SDK) في Crashlytics.
• فإذا اختار المستخدم إيقاف ميزة "إعداد تقارير الأعطال" عند حصوله على هاتف جديد، فلن يتم إبلاغ Play بهذه الأعطال، إلا أنّ Crashlytics ترصد الأعطال بناءً على سياسة الخصوصية الخاصة بالتطبيق.

التحقيق بشأن الوظائف المحدودة عند عدم الاتصال بالإنترنت

إذا قدّمت طلبًا جديدًا، على سبيل المثال من خلال النقر على إعادة تحميل، وتعذّر على "استوديو Android" التواصل مع Crashlytics، تتيح لك نافذة إحصاءات جودة التطبيقات الدخول إلى وضع عدم الاتصال بالإنترنت.

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