اختبار عملية تنفيذ Crashlytics (Flutter)

اختيار النظام الأساسي: iOS+ Android Flutter Unity


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

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

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

    إذا أضفت معالج أخطاء يستدعي FirebaseCrashlytics.instance.recordError(error, stack, fatal: true) إلى Zone المستوى الأعلى، يمكنك استخدام الرمز التالي لإضافة زر إلى تطبيقك، وعند النقر عليه، يتم ظهور استثناء اختبار:

    TextButton(
    onPressed: () => throw Exception(),
    child: const Text("Throw Test Exception"),
),

  2. أنشئ تطبيقك وشغِّله.

  3. افرض ظهور استثناء الاختبار لإرسال التقرير الأول لتطبيقك:

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

    2. في تطبيقك، انقر على زر استثناء الاختبار الذي أضفته باستخدام الرمز أعلاه.

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

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

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

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

الأنظمة الأساسية من Apple

  1. فعِّل ميزة تسجيل معلومات تصحيح الأخطاء:

    1. في Xcode، انقر على المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط (Edit scheme).

    2. انقر على التشغيل (Run) من القائمة على يمين الصفحة، ثم انقر على علامة التبويب المَعلمات (Arguments).

    3. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed on Launch) ، أضِف -FIRDebugEnabled.

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

  3. ضمن سجلّاتك، ابحث عن رسالة سجلّ من Crashlytics التي تحتوي على السلسلة التالية، ما يؤكّد أنّ تطبيقك يرسل الأعطال إلى Firebase.

    Completed report submission

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

Android

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

    1. قبل تشغيل تطبيقك، اضبط علامة shell في adb التالية على 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 Support وأرسِل إليه نسخة من ناتج السجلّ لنتمكّن من مساعدتك في تحديد المشاكل وحلّها بشكلٍ أكبر.

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