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

Android

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

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