پیاده‌سازی 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. اجرا را از منوِ سمت راست انتخاب کنید، سپس زبانه آرگومان‌ها را انتخاب کنید.

    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. در خروجی logcat، به‌دنبال پیام یا کد 204 زیر بگردید. هرکدام از این‌ها تأیید می‌کند که برنامه‌تان خرابی‌ها را به Firebase ارسال می‌کند.

    Crashlytics report upload complete

اگر پس‌از پنج دقیقه هنوز این گزارش یا خرابی آزمایشی را در داشبورد DevOps و تعامل > Crashlytics در کنسول Firebase نمی‌بینید، با پشتیبانی Firebase تماس بگیرید و نسخه‌ای از خروجی گزارش را ارسال کنید تا بتوانیم در عیب‌یابی بیشتر به شما کمک کنیم.

مراحل بعدی