اختبار عملية إعداد Crashlytics (نظام التشغيل Android)

اختيار النظام الأساسي:

iOS+ Android Flutter Unity

استخدِم هذا الدليل إذا اتّبعت دليل بدء الاستخدام، ولم تظهر لك الأعطال في لوحة بيانات Crashlytics.

فرض حدوث عُطل لاختبار عملية التنفيذ

1. أضِف رمزًا برمجيًا إلى تطبيقك يمكنك استخدامه لإيقاف التطبيق بشكل إجباري أثناء الاختبار.

   يمكنك استخدام الرمز التالي في MainActivity لتطبيقك من أجل إضافة زر إلى تطبيقك يؤدي إلى حدوث عُطل عند الضغط عليه. يظهر على الزر التصنيف "اختبار تعطُّل".

   Kotlin

   val crashButton = Button(this)
   crashButton.text = "Test Crash"
   crashButton.setOnClickListener {
      throw RuntimeException("Test Crash") // Force a crash
   }
   
   addContentView(crashButton, ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT))

   Java

   Button crashButton = new Button(this);
   crashButton.setText("Test Crash");
   crashButton.setOnClickListener(new View.OnClickListener() {
      public void onClick(View view) {
          throw new RuntimeException("Test Crash"); // Force a crash
      }
   });
   
   addContentView(crashButton, new ViewGroup.LayoutParams(
          ViewGroup.LayoutParams.MATCH_PARENT,
          ViewGroup.LayoutParams.WRAP_CONTENT));

2. إنشاء تطبيقك وتشغيله

3. فرض حدوث عطل في الاختبار لإرسال تقرير العطل الأول لتطبيقك:

   1. افتح تطبيقك من جهاز الاختبار أو المحاكي.

   2. في تطبيقك، اضغط على الزر "اختبار التعطُّل" الذي أضفته باستخدام الرمز أعلاه.

   3. بعد تعطُّل تطبيقك، أعِد تشغيله ليتمكّن من إرسال تقرير التعطُّل إلى Firebase.

4. في Firebaseوحدة التحكّم، انتقِل إلى DevOps & Engagement > Crashlyticsلوحة البيانات للبحث عن تقرير تعطل الاختبار.

   إذا أعَدت تحميل وحدة التحكّم ولم يظهر لك تعطُّل الاختبار بعد خمس دقائق، جرِّب تفعيل تسجيل بيانات تصحيح الأخطاء (القسم التالي).

تفعيل ميزة تسجيل معلومات تصحيح الأخطاء في Crashlytics

إذا لم يظهر تعذُّر الاختبار في لوحة بيانات Crashlytics، يمكنك استخدام تسجيل تصحيح الأخطاء في Crashlytics للمساعدة في تتبُّع المشكلة.

1. تفعيل ميزة تسجيل معلومات تصحيح الأخطاء وعرضها في Crashlytics:

   1. قبل تشغيل تطبيقك، اضبط علامة adb shell التالية على DEBUG:

      adb shell setprop log.tag.FirebaseCrashlytics DEBUG

   2. يمكنك عرض السجلّات في سجلّات جهازك من خلال تنفيذ الأمر التالي:

      adb logcat -s FirebaseCrashlytics

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

3. ابحث عن الرسالة أو الرمز التالي 204 في ناتج logcat، أي منهما يثبت أنّ تطبيقك يرسل الأعطال إلى Firebase.

   Crashlytics report upload complete

بعد خمس دقائق، إذا لم يظهر لك هذا السجلّ أو تعذّر إجراء الاختبار في لوحة بيانات DevOps & Engagement > Crashlytics في Firebase، تواصَل مع فريق دعم Firebase وأرسِل إليه نسخة من ناتج السجلّ لنتمكّن من مساعدتك في تحديد المشاكل وحلّها.

الخطوات التالية

• تخصيص إعدادات تقرير الأعطال من خلال إضافة ميزة إعداد التقارير التي تتطلّب موافقة المستخدم والسجلّات والمفاتيح وتتبُّع الأخطاء غير الفادحة