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


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

راه‌اندازی Crashlytics به وظایفی هم در کنسول Firebase و هم در IDE شما نیاز دارد (مانند افزودن یک فایل پیکربندی Firebase و Crashlytics SDK). برای تکمیل راه‌اندازی، باید یک خرابی آزمایشی را مجبور کنید تا اولین گزارش خرابی خود را به Firebase ارسال کنید.

قبل از شروع

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

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

    • اگر پروژه Firebase موجود شما Google Analytics فعال نکرده است، می توانید Google Analytics از برگه Integrations فعال کنید. > تنظیمات پروژه در کنسول Firebase .

    • اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics در جریان کار ایجاد پروژه فعال کنید.

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

برای نصب و مدیریت وابستگی های Firebase از Swift Package Manager استفاده کنید.

  1. در Xcode، با باز بودن پروژه برنامه، به File > Add Packages بروید.
  2. هنگامی که از شما خواسته شد، مخزن SDK پلتفرم های Apple Firebase را اضافه کنید: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. کتابخانه Crashlytics را انتخاب کنید.
  4. برای بهره‌مندی از گزارش‌های خرده نان ، Firebase SDK برای Google Analytics را نیز به برنامه خود اضافه کنید. مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است .
  5. پرچم -ObjC را به بخش Other Linker Flags تنظیمات ساخت هدف خود اضافه کنید.
  6. (فقط macOS) در Info.plist خود، کلید NSApplicationCrashOnExceptions را اضافه کنید و آن را روی YES تنظیم کنید.
  7. پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی های شما در پس زمینه می کند.

سپس ماژول Firebase را پیکربندی کنید:

  1. ماژول Firebase را در ساختار App یا UIApplicationDelegate خود وارد کنید:

    سویفت 

    import Firebase

    هدف-C 

    @import Firebase;

  2. یک نمونه اشتراک‌گذاری شده FirebaseApp معمولاً در application(_:didFinishLaunchingWithOptions:) پیکربندی کنید:

    سویفت 

    // Use the Firebase library to configure APIs.
FirebaseApp.configure()

    هدف-C 

    // Use the Firebase library to configure APIs.
[FIRApp configure];

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

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


و بس! Crashlytics اکنون برنامه شما را از نظر خرابی زیر نظر دارد. از داشبورد Crashlytics دیدن کنید تا همه گزارش ها و آمار خود را مشاهده و بررسی کنید.

مراحل بعدی

  • با Google Play ادغام شوید تا بتوانید گزارش های خرابی برنامه Android خود را توسط Google Play Track مستقیماً در داشبورد Crashlytics فیلتر کنید. این به شما امکان می دهد داشبورد خود را بهتر روی ساختهای خاص متمرکز کنید.

،


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

تنظیم Crashlytics به وظایف هم در کنسول Firebase و هم IDE شما نیاز دارد (مانند اضافه کردن یک پرونده پیکربندی Firebase و SDK Crashlytics ). برای به پایان رساندن تنظیم ، برای ارسال اولین گزارش تصادف خود به Firebase ، باید یک تصادف آزمایشی را مجبور کنید.

قبل از شروع

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

  2. توصیه می شود : برای به دست آوردن خودکار سیاهههای مربوط به سوفرهای نان برای درک اقدامات کاربر منتهی به یک رویداد تصادف ، غیر کشنده یا ANR ، باید Google Analytics در پروژه Firebase خود فعال کنید.

    • اگر پروژه Firebase موجود شما Google Analytics فعال نکرده است ، می توانید Google Analytics از برگه ادغام خود فعال کنید > تنظیمات پروژه در کنسول Firebase .

    • اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics در جریان کار ایجاد پروژه فعال کنید.

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

برای نصب و مدیریت وابستگی های Firebase از مدیر بسته Swift استفاده کنید.

  1. در Xcode ، با باز کردن پروژه برنامه خود ، به پرونده> اضافه کردن بسته ها بروید.
  2. هنگامی که از شما خواسته شد ، مخزن SDK سیستم عامل Apple Firebase را اضافه کنید: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. کتابخانه Crashlytics را انتخاب کنید.
  4. برای بهره مندی از سیاهههای مربوط به خرده نان ، همچنین Firebase SDK را برای Google Analytics به برنامه خود اضافه کنید. اطمینان حاصل کنید که Google Analytics در پروژه Firebase شما فعال شده است .
  5. پرچم -ObjC را به بخش دیگر Flags Flags از تنظیمات ساخت هدف خود اضافه کنید.
  6. . Info.plist NSApplicationCrashOnExceptions YES
  7. پس از اتمام ، Xcode به طور خودکار شروع به حل و فصل وابستگی های شما در پس زمینه می کند.

بعد ، ماژول Firebase را پیکربندی کنید:

  1. ماژول Firebase را در ساختار App خود یا UIApplicationDelegate وارد کنید:

    سویفت 

    import Firebase

    هدف-C 

    @import Firebase;

  2. یک نمونه مشترک FirebaseApp پیکربندی کنید ، به طور معمول در application(_:didFinishLaunchingWithOptions:) روش:

    سویفت 

    // Use the Firebase library to configure APIs.
FirebaseApp.configure()

    هدف-C 

    // Use the Firebase library to configure APIs.
[FIRApp configure];

مرحله 3 : یک تصادف تست را برای پایان دادن به تنظیمات مجبور کنید

برای به پایان رساندن تنظیم Crashlytics و دیدن داده های اولیه در داشبورد Crashlytics کنسول Firebase ، باید یک تصادف آزمایش را مجبور کنید.


و بس! Crashlytics is now monitoring your app for crashes. Visit the Crashlytics dashboard to view and investigate all your reports and statistics.

مراحل بعدی

  • Integrate with Google Play so that you can filter your Android app's crash reports by Google Play track directly in the Crashlytics dashboard. This allows you to better focus your dashboard on specific builds.