اختبار عملية تنفيذ 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، انتقِل إلى عمليات التطوير والتفاعل > لوحة بيانات 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 والتفاعل > Crashlytics في وحدة تحكّم Firebase، يُرجى التواصل مع فريق دعم Firebase وإرسال نسخة من مخرجات السجلّ حتى نتمكّن من مساعدتك في تحديد المشاكل وحلّها بشكل أكبر.

Android

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

    1. قبل تشغيل تطبيقك، اضبط علامة واجهة الأوامر adb التالية على DEBUG:

      adb shell setprop log.tag.FirebaseCrashlytics DEBUG

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

      adb logcat -s FirebaseCrashlytics

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

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

    Crashlytics report upload complete

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

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