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

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

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

تتوفّر تقارير "مؤشرات Android الحيوية" لجميع التطبيقات المنشورة على Google Play. إذا لم تكن تستخدم Crashlytics بعد وتريد معرفة المزيد عن الميزات التي توفّرها، يمكنك الاطّلاع على Firebase Crashlytics.

البدء

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

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

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

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

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

1. سجِّل الدخول إلى حساب المطوِّر في "استوديو Android" باستخدام رمز الملف الشخصي في نهاية شريط الأدوات.
2. افتح أداة "تحليل جودة التطبيق" من خلال النقر على نافذة الأدوات في "استوديو Android" أو النقر على عرض (View) > نوافذ الأدوات (Tool Windows) > أداة "تحليل جودة التطبيق" (App Quality Insights).
3. انقر على علامة التبويب مؤشرات Android الحيوية ضِمن أداة "تحليل جودة التطبيق".

4. اختياري: لاستخدام ميزة الدمج مع نظام التحكم في الإصدارات لإنشاء إصدار قابل للتصحيح، أضِف أحدث إصدار من حزمة تطوير البرامج (SDK) في Firebase Crashlytics (أو قائمة مواد منصة Firebase لأجهزة Android) إلى تطبيقك، ثم أضِف الرمز التالي إلى ملف build.gradle.kts أو build.gradle على مستوى الوحدة. يتم تفعيل العلامة تلقائيًا في إصدارات Release (غير قابلة للتصحيح).

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

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

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

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

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

   

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

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

   

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

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

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

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

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

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

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

التحقيق باستخدام وظائف محدودة بلا اتصال بالإنترنت

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

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

الأذونات

يُرجى الاطّلاع على أذونات الخدمة.