ابدأ مع Firebase Crashlytics

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

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

قبل ان تبدأ

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

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

    منصات جميع أبل بدعم من Crashlytics (باستثناء watchOS) يمكن الاستفادة من هذه الميزات من برنامج Google Analytics. لاحظ أنك بحاجة إلى SDK v8.9.0 + لتطبيقات macOS و tvOS.

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

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

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

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

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

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

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

استخدم Swift Package Manager لتثبيت وإدارة تبعيات Firebase.

  1. في كسكودي، مع مشروع التطبيق فتح، انتقل إلى ملف> حزم سويفت> إضافة حزمة التبعية.
  2. عند المطالبة ، قم بإضافة مستودع SDK لأنظمة Firebase Apple الأساسية:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. اختر مكتبة Crashlytics.
  5. للحصول على تجربة الأمثل مع Crashlytics، نوصي تمكين تحليلات جوجل في مشروع Firebase وإضافة SDK Firebase ل Google Analytics أن التطبيق الخاص بك. يمكنك تحديد المكتبة بدون مجموعة IDFA أو مع مجموعة IDFA.
  6. عند الانتهاء ، سيبدأ Xcode تلقائيًا في حل وتنزيل التبعيات الخاصة بك في الخلفية.

بعد ذلك ، هيئ وحدة Firebase:

  1. استيراد وحدة Firebase في حياتك 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];
    

الخطوة 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.

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/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 لعرض والتحقيق في جميع التقارير والإحصاءات الخاصة بك.

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