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

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

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

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

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

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

    2. انقر على تشغيل من القائمة اليمنى، ثمّ انقر على علامة التبويب الوسيطات.

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

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

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

    Completed report submission

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

  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

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

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