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

iOS+ اندروید اندروید (NDK) فلاتر یونیتی

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

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

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

1. اگر هنوز فایربیس را به پروژه اپل خود اضافه نکرده‌اید، آن را اضافه کنید . اگر برنامه اپل ندارید، می‌توانید یک برنامه نمونه را دانلود کنید.

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

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

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

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

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

برای آشنایی با روش‌های مختلف افزودن SDKهای فایربیس به پروژه اپل خود، از جمله وارد کردن مستقیم فریم‌ورک‌ها و استفاده از CocoaPods، به راهنمای نصب ما مراجعه کنید.

1. در Xcode، با باز کردن پروژه برنامه خود، به File > Add Packages بروید.
2. وقتی از شما خواسته شد، مخزن SDK پلتفرم‌های اپل فایربیس را اضافه کنید:

  https://github.com/firebase/firebase-ios-sdk.git

توجه: پروژه‌های جدید باید از نسخه پیش‌فرض (آخرین) SDK استفاده کنند، اما در صورت نیاز می‌توانید نسخه قدیمی‌تر را انتخاب کنید.
3. کتابخانه Crashlytics را انتخاب کنید.
4. برای استفاده از گزارش‌های breadcrumb ، کیت توسعه نرم‌افزار Firebase برای Google Analytics را نیز به برنامه خود اضافه کنید. مطمئن شوید که گوگل آنالیتیکس در پروژه فایربیس شما فعال است .
5. پرچم -ObjC را به بخش Other Linker Flags در تنظیمات ساخت هدف خود اضافه کنید.
6. (فقط macOS) در Info.plist خود، کلید NSApplicationCrashOnExceptions را اضافه کنید و آن را روی YES تنظیم کنید.
7. پس از اتمام، Xcode به طور خودکار شروع به حل و دانلود وابستگی‌های شما در پس‌زمینه می‌کند.

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

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

   سویفت

   import Firebase

   هدف-سی

   @import Firebase;

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

   سویفت

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

   هدف-سی

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

Step 3 : Force a test crash to finish setup

To finish setting up Crashlytics and see initial data in the Crashlytics dashboard of the Firebase console, you need to force a test crash.

And that's it! Crashlytics is now monitoring your app for crashes. Visit the Crashlytics dashboard to view and investigate all your reports and statistics.

مراحل بعدی

• Customize your crash report setup by adding opt-in reporting, logs, keys, and tracking of non-fatal errors.

• 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.