Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

  1. اگر شما در حال حاضر نیست، اضافه فایربیس به پروژه خود را IOS. اگر شما یک برنامه iOS را نداشته باشند، شما می توانید یک دانلود برنامه نمونه .

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

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

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

مرحله 1: فعال Crashlytics در کنسول فایربیس

  1. رفتن به داشبورد Crashlytics در کنسول فایربیس.

  2. اطمینان حاصل کنید که برنامه شما از کرکره ای کنار Crashlytics در بالای صفحه انتخاب شده است.

  3. کلیک کنید فعال کردن Crashlytics.

مرحله 2: اضافه کردن فایربیس Crashlytics SDK به برنامه شما

  1. podfile شما برای پروژه Firebase خود ایجاد و باز کردن و اضافه کردن FirebaseCrashlytics غلاف.

    برای یک تجربه بهینه با Crashlytics، توصیه می کنیم قادر می سازد گوگل آنالیز در پروژه Firebase خود و اضافه کردن غلاف فایربیس برای گوگل آنالیز برای برنامه شما.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. نصب غلاف، و سپس دوباره باز خود را .xcworkspace فایل که این طرح در Xcode متعلق به:

    pod install
    open your-project.xcworkspace
    
  3. واردات ماژول فایربیس خود را UIApplicationDelegate :

    سریع

    import Firebase

    هدف-ج

    @import Firebase;
  4. پیکربندی FirebaseApp عنوان مثال مشترک، به طور معمول در برنامه شما application:didFinishLaunchingWithOptions: روش:

    سریع

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

    هدف-ج

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

مرحله 3: تنظیم Xcode متعلق به طور خودکار آپلود فایل های dSYM

برای تولید گزارش تصادفات قابل خواندن توسط انسان ، Crashlytics به فایلهای نماد اشکال زدایی پروژه شما (dSYM) نیاز دارد. مراحل زیر نحوه پیکربندی Xcode برای تولید خودکار dSYM های شما ، پردازش آنها و بارگذاری فایل ها را در هر زمان که برنامه خود را ایجاد می کنید توضیح می دهد.

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

  2. از لیست را هدف قرار، هدف اصلی ساخت خود را انتخاب کنید.

  3. با کلیک بر روی زبانه تنظیمات ساخت، و سپس مراحل زیر را انجام Xcode متعلق به طوری که تولید dSYMs برای ایجاد خود را.

    1. همه کلیک کنید، سپس برای جستجو debug information format .

    2. فرمت مجموعه اطلاعات اشکال زدایی به کوتوله با dSYM فایل برای تمام انواع ساخت خود را.

  4. کلیک بر روی زبانه فاز ساخت، و سپس مراحل زیر را انجام Xcode متعلق به طوری که می توانید dSYMs شما را پردازش و آپلود فایل.

    1. کلیک کنید > جدید اجرای اسکریپت فاز.

      اطمینان حاصل کنید که این مرحله جدید اجرای اسکریپت آخرین مرحله ساخت پروژه شما می باشد. در غیر این صورت ، Crashlytics نمی تواند dSYM ها را به درستی پردازش کند.

    2. گسترش بخش جدید اجرای اسکریپت.

    3. در زمینه اسکریپت (واقع در زیر برچسب شل)، اضافه کردن اسکریپت اجرا زیر است.

      این اسکریپت پرونده های dSYM پروژه شما را پردازش می کند و فایل ها را در Crashlytics بارگذاری می کند.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. در ورودی فایل های بخش، اضافه کردن مسیر برای فایل های زیر.

      • مسیر را به فایل های dSYM پروژه خود اضافه کنید

        این Crashlytics را قادر می سازد dSYM ها را برای برنامه های بزرگتر سریعتر پردازش کند.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • اضافه کردن مسیر به ساخته شده پروژه خود را Info.plist فایل

        این Crashlytics را قادر می سازد تا نسخه برنامه را با dSYM ها مرتبط کند.

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

برای کسب اطلاعات بیشتر در مورد فایل های dSYM و Crashlytics (از جمله چگونه به صورت دستی آپلود فایل dSYM)، بازدید مطلع deobfuscated گزارشهای خرابی .

گام 4: نیروی تست تصادف را به پایان برساند راه اندازی

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


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

مراحل بعدی