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

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

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

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

البدء

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

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

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

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

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

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

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

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

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

تحليل بيانات Crashlytics في Android Studio

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

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

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

   

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

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

   

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

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

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

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

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

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

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

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

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

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