Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

با Firebase Crashlytics شروع کنید

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

این شروع سریع نحوه راه‌اندازی Firebase Crashlytics را در برنامه خود با افزونه Crashlytics Flutter شرح می‌دهد تا بتوانید گزارش‌های خرابی جامع را در کنسول Firebase دریافت کنید.

راه اندازی Crashlytics شامل استفاده از ابزار خط فرمان و IDE شما می شود. برای تکمیل راه‌اندازی، باید یک استثنای آزمایشی برای ارسال اولین گزارش خرابی خود به Firebase ایجاد کنید.

قبل از اینکه شروع کنی

  1. اگر قبلاً این کار را نکرده اید، Firebase را در پروژه Flutter خود پیکربندی و مقداردهی اولیه کنید.

  2. توصیه می‌شود: برای دریافت ویژگی‌هایی مانند کاربران بدون خرابی، گزارش‌های خرده نان، و هشدارهای سرعت، باید Google Analytics را در پروژه Firebase خود فعال کنید.

    همه پلتفرم‌های اندروید و اپل که توسط Crashlytics پشتیبانی می‌شوند (به جز watchOS) می‌توانند از این ویژگی‌های Google Analytics استفاده کنند.

    مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است: به > تنظیمات پروژه > تب ادغام ها بروید، سپس دستورالعمل های روی صفحه را برای Google Analytics دنبال کنید.

مرحله 1 : Crashlytics را به پروژه Flutter خود اضافه کنید

  1. از ریشه پروژه Flutter خود، دستور زیر را برای نصب افزونه Crashlytics Flutter اجرا کنید:

    flutter pub add firebase_crashlytics
    
  2. از دایرکتوری ریشه پروژه Flutter خود، دستور زیر را اجرا کنید:

    flutterfire configure
    

    اجرای این دستور تضمین می کند که پیکربندی Firebase برنامه Flutter شما به روز است و برای اندروید، افزونه Crashlytics Gradle مورد نیاز را به برنامه شما اضافه می کند.

  3. پس از تکمیل، پروژه Flutter خود را بازسازی کنید:

    flutter run
    

مرحله 2 : کنترل کننده های خرابی را پیکربندی کنید

می‌توانید به‌طور خودکار تمام خطاهایی را که در چارچوب Flutter ایجاد می‌شوند، با لغو FlutterError.onError با FirebaseCrashlytics.instance.recordFlutterFatalError دریافت کنید:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();

  // Pass all uncaught errors from the framework to Crashlytics.
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  runApp(MyApp());
}

اگر از مناطق استفاده می کنید، ابزار دقیق کنترل کننده خطای ناحیه، خطاهایی را که توسط چارچوب Flutter شناسایی نمی شوند (به عنوان مثال، در کنترل کننده onPressed یک دکمه) شناسایی می کند:

void main() async {
  runZonedGuarded<Future<void>>(() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();

    FlutterError.onError =
       FirebaseCrashlytics.instance.recordFlutterFatalError;

    runApp(MyApp());
  }, (error, stack) =>
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true));
}

برای مثال‌هایی از نحوه رسیدگی به انواع دیگر خطاها، به سفارشی کردن گزارش‌های خرابی مراجعه کنید.

مرحله 3 : یک خرابی آزمایشی را مجبور کنید تا راه‌اندازی تمام شود

برای تکمیل راه‌اندازی Crashlytics و دیدن داده‌های اولیه در داشبورد Crashlytics کنسول Firebase، باید یک استثنای آزمایشی ایجاد کنید.

  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 اکنون برنامه شما را از نظر خرابی و در Android، خطاهای غیر کشنده و ANR زیر نظر دارد. از داشبورد Crashlytics دیدن کنید تا همه گزارش ها و آمار خود را مشاهده و بررسی کنید.

مراحل بعدی