ابدأ مع Firebase Crashlytics

تصف هذه البداية السريعة كيفية إعداد Firebase Crashlytics في تطبيقك باستخدام Firebase Crashlytics SDK بحيث يمكنك الحصول على تقارير أعطال شاملة في وحدة تحكم Firebase.

يتطلب إعداد Crashlytics مهامًا في كل من وحدة تحكم Firebase و IDE (مثل إضافة ملف تكوين Firebase و Crashlytics SDK). لإنهاء الإعداد ، ستحتاج إلى فرض تعطل تجريبي لإرسال تقرير التعطل الأول إلى Firebase.

قبل ان تبدأ

  1. إذا كنت لم تقم بذلك بالفعل، إضافة Firebase إلى المشروع الذي يعمل بنظام iOS. إذا لم يكن لديك التطبيق دائرة الرقابة الداخلية، يمكنك تحميل التطبيق عينة .

  2. الموصى بها: للحصول على ميزات مثل المستخدمين خالية من تحطم الطائرة، وسجلات التفصيلي، والتنبيهات السرعة، تحتاج لتفعيل برنامج Google Analytics مشروع Firebase الخاص بك.

    • إذا لم يكن لديك مشروع Firebase الموجودة لديك تمكين جوجل تحليلات، يمكنك تمكين تحليلات جوجل من علامة التبويب التكاملات الخاص بك > إعدادات المشروع في وحدة تحكم Firebase.

    • إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

الخطوة 1: تمكين Crashlytics في وحدة تحكم Firebase

  1. انتقل إلى لوحة أجهزة القياس Crashlytics في وحدة تحكم Firebase.

  2. تأكد من تحديد التطبيق من القائمة المنسدلة بجانب Crashlytics في الجزء العلوي من الصفحة.

  3. انقر على تمكين Crashlytics.

الخطوة 2: إضافة Firebase Crashlytics SDK في تطبيقك

  1. فتح podfile قمت بإنشائه لمشروع Firebase وإضافة FirebaseCrashlytics جراب.

    للحصول على تجربة الأمثل مع Crashlytics، نوصي تمكين تحليلات جوجل في مشروع Firebase الخاصة بك وإضافة جراب Firebase ل Google Analytics أن التطبيق الخاص بك.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. تثبيت القرون، ثم إعادة فتح بك .xcworkspace ملف لرؤية المشروع في كسكودي:

    pod install
    open your-project.xcworkspace
    
  3. استيراد وحدة Firebase في حياتك 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: قم بإعداد كسكودي تلقائيا تحميل الملفات dSYM

لإنشاء تقارير أعطال يمكن للبشر قراءتها ، تحتاج Crashlytics إلى ملفات رمز تصحيح أخطاء مشروعك (dSYM). تصف الخطوات التالية كيفية تكوين Xcode لإنتاج dSYMs تلقائيًا ومعالجتها وتحميل الملفات كلما قمت بإنشاء تطبيقك.

  1. افتح مساحة عمل Xcode الخاصة بمشروعك ، ثم حدد ملف المشروع الخاص به في المتصفح الأيسر.

  2. من قائمة الأهداف، حدد الخاص بك بناء الهدف الرئيسي.

  3. انقر فوق علامة التبويب إعدادات إنشاء، ثم أكمل الخطوات التالية بحيث تنتج كسكودي dSYMs ليبني الخاص بك.

    1. انقر فوق كافة، ثم ابحث عن debug information format .

    2. تنسيق مجموعة معلومات التصحيح إلى DWARF مع ملف dSYM لجميع أنواع الإنشاء.

  4. انقر فوق علامة التبويب مراحل إنشاء، ثم أكمل الخطوات التالية بحيث يمكن معالجة كسكودي dSYMs وتحميل الملفات.

    1. انقر على > تشغيل جديد سيناريو المرحلة.

      تأكد من تشغيل هذه المرحلة سيناريو الجديدة الماضية مرحلة بناء المشروع الخاص بك. خلاف ذلك ، لا يمكن لـ Crashlytics معالجة dSYMs بشكل صحيح.

    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 ربط إصدار التطبيق بـ dSYMs.

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

للحصول على معلومات أكثر تفصيلا حول ملفات dSYM وCrashlytics (بما في ذلك كيفية تحميل الملفات dSYM يدويا)، زيارة الحصول على deobfuscated تقارير الأعطال .

الخطوة 4: قوة تحطم اختبار لإنهاء الإعداد

لإنهاء إعداد Crashlytics والاطلاع على البيانات الأولية في لوحة معلومات Crashlytics بوحدة تحكم Firebase ، يلزمك فرض تعطل اختباري.

  1. أضف رمزًا إلى تطبيقك يمكنك استخدامه لفرض تعطل تجريبي.

    يمكنك استخدام الكود التالي لإضافة زر إلى تطبيقك يؤدي إلى تعطله عند الضغط عليه. الزر يسمى "اختبار التعطل".

    سويفت

    import UIKit
    
    class ViewController: UIViewController {
      override func viewDidLoad() {
          super.viewDidLoad()
    
          // Do any additional setup after loading the view, typically from a nib.
    
          let button = UIButton(type: .roundedRect)
          button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
          button.setTitle("Test Crash", for: [])
          button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
          view.addSubview(button)
      }
    
      @IBAction func crashButtonTapped(_ sender: AnyObject) {
          let numbers = [0]
          let _ = numbers[1]
      }
    }
    

    ج موضوعية

    #import "ViewController.h"
    
    @implementation ViewController
    ‐ (void)viewDidLoad {
        [super viewDidLoad];
    
        // Do any additional setup after loading the view, typically from a nib.
    
        UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
        button.frame = CGRectMake(20, 50, 100, 30);
        [button setTitle:@"Test Crash" forState:UIControlStateNormal];
        [button addTarget:self action:@selector(crashButtonTapped:)
            forControlEvents:UIControlEventTouchUpInside];
        [self.view addSubview:button];
    }
    
    ‐ (IBAction)crashButtonTapped:(id)sender {
        @[][1];
    }
    
    @end
    
  2. أنشئ تطبيقك وشغّله في Xcode. استخدم الخطوات التالية للتأكد من فصل جهاز الاختبار أو المحاكي عن مصحح أخطاء Xcode (الذي يتداخل مع Crashlytics).

    1. انقر بناء وتشغيل النظام الحالي لبناء التطبيق على جهاز اختبار أو محاكاة.

    2. انتظر حتى يتم تشغيل التطبيق الخاص بك، ثم انقر فوق إيقاف تشغيل نظام أو إجراء لإغلاق مثيل الأولي من التطبيق الخاص بك. تضمن هذا المثيل الأولي المصحح الذي يتداخل مع Crashlytics.

  3. فرض الانهيار التجريبي لإرسال أول تقرير تعطل لتطبيقك:

    1. افتح تطبيقك من الشاشة الرئيسية لجهاز الاختبار أو جهاز المحاكاة.

    2. في تطبيقك ، اضغط على زر "اختبار التعطل" الذي أضفته باستخدام الرمز أعلاه.

    3. بعد تعطل تطبيقك ، قم بتشغيله مرة أخرى من Xcode حتى يتمكن تطبيقك من إرسال تقرير التعطل إلى Firebase.

  4. انتقل إلى لوحة أجهزة القياس Crashlytics من وحدة التحكم Firebase لرؤية تحطم الاختبار.

    إذا كنت قد استرجعت وحدة وكنت لا تزال لا ترى تحطم الاختبار بعد خمس دقائق، تمكين تسجيل التصحيح لمعرفة ما إذا كان التطبيق بإرسال تقارير الأعطال.


وهذا كل شيء! تراقب Crashlytics الآن تطبيقك بحثًا عن الأعطال ، ويمكنك عرض تقارير الأعطال والإحصاءات والتحقيق فيها في لوحة معلومات Crashlytics.

الخطوات التالية