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

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

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

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

البدء

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

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

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

تتضمّن ميزة إحصاءات جودة التطبيق بيانات Android Vitals. يتيح لكم ذلك الوصول بسهولة أكبر إلى المقاييس الأساسية التي يجمعها Google Play وتحسين تجربة المستخدم. استخدِموا Android Vitals لمعالجة المشاكل المتعلّقة بثبات التطبيق للمساعدة في تحسين جودة تطبيقكم على 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. استخدِموا القائمة المنسدلة لمعرّف التطبيق لاختيار معرّف التطبيق الذي تريدون تحليله. على سبيل المثال، أثناء العمل على إصدار تصحيح الأخطاء من تطبيقكم في بيئة التطوير المتكاملة، قد تريدون الاطّلاع على بيانات الأحداث لإصدار الإنتاج من تطبيقكم الذي يثبّته المستخدمون.
2. تعرِض لوحة المشاكل (Issues) أهم الأحداث التي تتوفّر بياناتها في Crashlytics، ويتم ترتيبها حسب الأعطال الأكثر تأثيرًا.
3. يمكنكم الاطّلاع على الأحداث حسب المتغيّرات أو مجموعات الأحداث التي تتضمّن تتبُّع تسلسل استدعاء الدوال مشابهًا. يساعدكم تحليل الأحداث حسب المتغيّر في تحديد الأسباب الجذرية للعطل.

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

   

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

5. تعرِض علامتا التبويب المفاتيح (Keys) والسجلات (Logs) أزواج المفاتيح والقيم المخصّصة والسجلات لكل تقرير من تقارير Crashlytics.
6. تعرِض لوحة التفاصيل (Details) عدد الأعطال حسب نوع الجهاز وإصدار Android، ما يتيح لكم تحديد مجموعات المستخدمين الأكثر تأثّرًا. تعرِض اللوحة أيضًا إصدارات التطبيق التي حدث فيها العطل وعدد المستخدمين المتأثّرين.
7. يمكنكم قراءة الملاحظات وإرفاقها بالمشاكل لتظهر في Firebase Console ولزملائكم في الفريق. لكتابة ملاحظة حول مشكلة، اختاروا المشكلة وافتحوا لوحة الملاحظات (Notes). يجب أن يكون لديكم إذن الكتابة في مشروع Crashlytics لكتابة الملاحظات. تظهر المشاكل التي تتضمّن ملاحظات مع رمز "ملاحظات" في لوحة المشاكل (Issues).

   

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

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

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

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

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

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

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

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

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

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

الأذونات

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