يمكنك الاطّلاع على بيانات أعطال التطبيق من Firebase Crashlytics ومؤشرات Android الحيوية مباشرةً في "استوديو Android" واتخاذ إجراءات مستندة إليها. تعمل عملية الدمج هذه على سحب بيانات تتبُّع تسلسل استدعاء الدوال البرمجية وإحصاءات الأعطال من Crashlytics وGoogle Play إلى نافذة أداة إحصاءات جودة التطبيق في بيئة تطوير البرامج (IDE) في "استوديو YouTube"، كي لا تضطر إلى التنقّل كثيرًا بين المتصفّح وبيئة تطوير البرامج (IDE). يمكن لفرق التطوير الاستفادة من الإمكانات الرئيسية بما في ذلك ما يلي:
- يمكنك رؤية الأسطر في الرمز المميّز عندما تحتوي على بيانات أحداث Crashlytics ذات الصلة.
- يمكنك الاطّلاع على تقرير تتبُّع تسلسل استدعاء الدوال البرمجية لأهم الأعطال، والنقر على تقرير تتبُّع تسلسل استدعاء الدوال البرمجية للانتقال إلى الأسطر ذات الصلة في الرمز.
- يمكنك الاطّلاع على إحصاءات ملخّصة حول أهم الأعطال والأحداث غير الفادحة، على سبيل المثال، يتم تجميعها حسب الشركة المصنّعة للجهاز وإصدار Android.
- يمكنك فلترة الأحداث حسب السمات، بما في ذلك درجة الخطورة والوقت وإصدار التطبيق.
- احصل على رابط متصفّح يفتح صفحة لوحة بيانات Crashlytics التي تتضمّن المزيد من التفاصيل حول الحدث.
- احصل على رؤى تساعدك على فهم الأسباب الجذرية لمشكلات معينة وحلّها بسهولة أكبر.
تتوفّر تقارير "مؤشرات Android الحيوية" لجميع التطبيقات المنشورة على Google Play. إذا كنت لا تستخدم Crashlytics بعد وأردت معرفة المزيد من المعلومات عن الميزات التي يوفّرها، يمكنك مراجعة Firebase Crashlytics.
بدء
للاطّلاع على بيانات Crashlytics في "استوديو Android"، عليك إعداد Firebase وCrashlytics في مشروع تطبيقك. وإليك كيفية إجراء ذلك: افتح "مساعد Firebase" في "استوديو Android" من خلال الانتقال إلى الأدوات > Firebase، ثم انقر على Crashlytics، ثمّ اتّبِع البرنامج التعليمي لإضافة Firebase وCrashlytics إلى مشروعك. يمكنك الاطّلاع على مزيد من المعلومات حول سير عمل "مساعد Firebase" من خلال دليل بدء Firebase لنظام التشغيل Android.
إذا سبق لك إضافة Firebase وCrashlytics إلى تطبيقك، سجِّل الدخول إلى
حساب المطوّر في IDE من خلال النقر على رمز الصورة الرمزية .
بعد تسجيل الدخول، انقر على نافذة أداة إحصاءات جودة التطبيق. من المفترض أن تظهر لك لوحات المشاكل ونموذج تتبُّع تسلسل استدعاء الدوال البرمجية والتفاصيل التي تمت تعبئتها بالتقارير من Crashlytics.
تحليل "مؤشرات Android الحيوية"
تتضمّن إحصاءات جودة التطبيقات بيانات مؤشرات Android الحيوية. يتيح لك ذلك الوصول بسهولة إلى المقاييس الأساسية التي يجمعها Google Play وتحسين تجربة المستخدم. استخدِم "مؤشرات Android الحيوية" لمعالجة المشاكل المتعلقة بثبات التطبيق والمساعدة على تحسين جودة تطبيقك على Google Play.
يمكنك الاطّلاع على مشاكل "مؤشرات Android الحيوية" وفلترتها والانتقال من رمز تتبُّع تسلسل استدعاء الدوال البرمجية إلى ترميز كل ذلك من نافذة أداة إحصاءات جودة التطبيقات. للبدء، اتبع الخطوات التالية:
- سجِّل الدخول إلى حساب المطوّر في "استوديو Android" باستخدام رمز الملف الشخصي
في نهاية شريط الأدوات.
- افتح إحصاءات جودة التطبيقات بالنقر على نافذة الأداة في "استوديو Android" أو النقر على عرض > نوافذ الأدوات > إحصاءات جودة التطبيقات.
- انقر على علامة التبويب مؤشرات Android الحيوية ضمن إحصاءات جودة التطبيقات.
اختياري: لاستخدام دمج التحكّم في الإصدار لإصدار قابل للتصحيح، أضِف إلى تطبيقك أحدث حزمة تطوير برامج (SDK) لمنصة Firebase Crashlytics (أو فاتورة مواد Android لنظام Firebase). بعد ذلك، أضِف الرمز البرمجي التالي إلى الملف
build.gradle.kts
أوbuild.gradle
على مستوى الوحدة. تكون العلامة مفعَّلة تلقائيًا في إصدارات الإصدار (غير القابلة للتصحيح).
Kotlin
android { buildTypes { getByName("debug") { vcsInfo { include = true } } } }
رائع
android { buildTypes { debug { vcsInfo { include true } } } }
تحليل بيانات Crashlytics في "استوديو Android"
تحتوي نافذة أداة إحصاءات جودة التطبيق على بيانات وافية تمنحك إحصاءات عن الأحداث التي يواجهها المستخدمون، وروابط لمساعدتك في الانتقال بسرعة إلى مصادر هذه الأحداث.
- استخدم القائمة المنسدلة لرقم تعريف التطبيق لاختيار رقم تعريف التطبيق الذي تريد تحليله. على سبيل المثال، بينما يمكنك العمل على إصدار تصحيح الأخطاء من تطبيقك في بيئة التطوير المتكاملة (IDE)، قد تحتاج إلى الاطّلاع على بيانات الأحداث الخاصة بإصدار الإنتاج من تطبيقك الذي يثبّته المستخدمون.
- تعرض لوحة المشاكل أهم الأحداث التي يحتوي تطبيق Crashlytics على بيانات بشأنها، ويتم ترتيبها حسب الأعطال الأكثر تأثيرًا.
- يمكنك عرض الأحداث حسب خيارات المنتج، أو مجموعات الأحداث التي لديها عمليات تتبُّع تسلسل استدعاء الدوال البرمجية مشابهة. يساعدك تحليل الأحداث حسب الصيغة في تحديد الأسباب الأساسية لتعطُّل التطبيق.
تعرض اللوحة التي تحتوي على تتبُّع تسلسل استدعاء الدوال البرمجية تفاصيل عن آخر موضع ورود للحدث الذي نقرت فيه على لوحة المشاكل. يمكنك الاطّلاع على تتبُّع تسلسل استدعاء الدوال البرمجية للحدث والنقر على تتبُّع تسلسل استدعاء الدوال البرمجية للانتقال إلى السطور ذات الصلة في قاعدة الرموز. إذا تم تغيير الرمز بعد حدوث العطل، انقر على إظهار الفرق بجانب الخطأ في تقرير تتبُّع تسلسل استدعاء الدوال البرمجية لعرض الفرق بين الرمز الحالي وإصدار قاعدة الرموز التي أدت إلى حدوث العطل.
وهناك أيضًا معلومات حول نوع الجهاز المتأثر وإصدار Android ووقت وقوع الحدث، بالإضافة إلى رابط إلى الحدث في لوحة بيانات Firebase Crashlytics. انقر على زر إغلاق لإغلاق مشكلة من اللوحة مباشرةً.
- تقسّم لوحة التفاصيل أعداد الأعطال حسب نوع الجهاز وإصدار Android حتى تتمكّن من تحديد مجموعات المستخدمين الأكثر تأثرًا. وتعرض أيضًا إصدارات التطبيق التي حدث فيها العطل وعدد المستخدمين المتأثّرين بالتعطُّل.
- يمكنك قراءة الملاحظات وإرفاقها بالمشاكل كي تظهر في "وحدة تحكُّم Firebase"
وزملائك في الفريق. لكتابة ملاحظة عن مشكلة، اختَر المشكلة
وافتح لوحة الملاحظات. يجب أن يكون لديك إذن بالكتابة في مشروع Crashlytics كي تتمكن من كتابة ملاحظات. تظهر المشاكل المتعلقة بالملاحظات مع
رمز "الملاحظات"
في لوحة المشاكل.
- استخدِم مجموعة متنوعة من الفلاتر للتركيز على مجموعات فرعية معيّنة من الأحداث. يمكنك اختيار أو إلغاء اختيار الأحداث الفادحة
أو غير الفادحة
، بالإضافة إلى الفلترة حسب الوقت وإصدار التطبيق وإشارة Crashlytics والعلامة التجارية للجهاز وطرازه وإصدار نظام Android الأساسي. يُرجى العِلم أنّه بالنسبة إلى حالات إشارة Crashlytics، تُعتبر المشكلة متراجعة إذا كان قد تم إغلاقها في السابق وتحدثت مرة أخرى في إصدار جديد من التطبيق.
بالإضافة إلى إمكانية الانتقال من تتبُّع تسلسل استدعاء الدوال البرمجية إلى الرمز، يمكنك أيضًا الانتقال من رمز إلى تتبُّع تسلسل استدعاء الدوال البرمجية، فبإمكان "استوديو Android" الآن إضافة تعليقات توضيحية إلى سطور الرمز
المرتبطة بالأعطال، وذلك من خلال رمز هامش العطل
حتى تتمكن من
تحديدها وتصحيح أخطائها بسهولة.
عند تمرير مؤشر الماوس فوق رمز التعطُّل، تظهر نافذة منبثقة تعرض عدد الأحداث التي تتضمّن هذا السطر من الرمز ومعدّلات تكرار الأحداث.
انقر على رمز التعطُّل للحصول على قائمة أكثر تفصيلاً بالأحداث، بما في ذلك عدد المستخدمين المتأثرين بحدث معيَّن وعددهم. انقر على حدث معيّن للانتقال إلى تفاصيل الحدث في نافذة أداة إحصاءات جودة التطبيق.
اختلاف الأرقام بين "مؤشرات Android الحيوية" وCrashlytics
تجدر الإشارة إلى أنّ "مؤشرات Android الحيوية" وCrashlytics قد تُبلِغ عن قيم مختلفة لأعداد المستخدمين والأحداث المرتبطة بالعُطل نفسه. ويحدث هذا التناقض لأنّ Play وCrashlytics يمكنهما رصد الأعطال في أوقات مختلفة ولمختلف المستخدمين. في ما يلي سببان لاختلاف عدد حسابات Play وCrashlytics:
- يرصد Play الأعطال بدءًا من وقت التشغيل، في حين أنّ Crashlytics يرصد الأعطال التي تحدث بعد إعداد حزمة تطوير البرامج Crashlytics SDK.
- فإذا أوقف المستخدم ميزة إعداد تقارير الأعطال عند استخدام هاتف جديد، لا يتم إبلاغ Play بهذه الأعطال، إلا أنّ Crashlytics ترصد الأعطال بناءً على سياسة الخصوصية الخاصة بالتطبيق.
التحقُّق من استخدام وظائف محدودة بلا اتصال بالإنترنت
إذا قدّمت طلبًا جديدًا، على سبيل المثال من خلال النقر على إعادة تحميل، وتعذَّر على "استوديو Android" التواصل مع Crashlytics، تتيح لك نافذة إحصاءات جودة التطبيقات الدخول إلى وضع عدم الاتصال بالإنترنت.
وأثناء استخدام هذا الوضع، يمكنك مواصلة التحقّق من المشاكل وآخر الأحداث من البيانات المخزَّنة مؤقتًا. لا تتوفر وظائف معينة، مثل تغيير بعض خيارات التصفية أو إغلاق المشكلات. لإعادة محاولة الاتصال بتطبيق Crashlytics والرجوع إلى حالة الاتصال بالإنترنت، انقر على إعادة الربط.