تحليل المشاكل الواردة من 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 على مستوى الوحدة. تكون علامة الإصدارات (غير القابلة لتصحيح الأخطاء) مفعّلة تلقائيًا.

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

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

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

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

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

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

   

   تتوفّر أيضًا معلومات عن نوع الجهاز المتأثّر وإصدار 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 الأعطال استنادًا إلى سياسة الخصوصية الخاصة بالتطبيق.

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

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

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

الأذونات

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