اختبار عملية تنفيذ Crashlytics

فرض تعطُّل لاختبار عملية التنفيذ

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

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

    واجهة SwiftUI 

    Button("Crash") {
  fatalError("Crash was triggered")
}

    واجهة المستخدم

    Swift 

    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]
  }
}

    Objective-C 

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

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

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

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

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

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

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

  4. انتقِل إلى لوحة بيانات Crashlytics ضمن وحدة تحكُّم Firebase للاطّلاع على العطل في الاختبار.

إذا أعدت تحميل وحدة التحكّم ولم يظهر عطل الاختبار بعد مرور خمس دقائق، حاوِل تفعيل ميزة تسجيل تصحيح الأخطاء (القسم التالي).

تفعيل ميزة تسجيل معلومات تصحيح الأخطاء في Crashlytics

إذا لم يظهر تعطُّل الاختبار في لوحة بيانات Crashlytics، يمكنك استخدام تسجيل تصحيح الأخطاء لتطبيق Crashlytics للمساعدة في تتبُّع المشكلة.

  1. تفعيل تسجيل معلومات تصحيح الأخطاء:

    1. في Xcode، اختَر المنتج > المخطط > تعديل المخطط.

    2. اختَر تشغيل من القائمة اليمنى، ثم اختَر علامة التبويب الوسيطات.

    3. في قسم الوسيطات التي تم تمريرها عند الإطلاق، أضِف -FIRDebugEnabled.

  2. فرض عطل تجريبي. يصف القسم الأول في هذه الصفحة كيفية إجراء ذلك.

  3. ضمن سجلّاتك، ابحث عن رسالة سجلّ من Crashlytics تحتوي على السلسلة التالية، والتي تتحقّق من أنّ تطبيقك يرسل حالات تعطُّل إلى Firebase.

    Completed report submission

إذا لم يظهر هذا السجلّ أو عطل الاختبار في لوحة بيانات Crashlytics ضمن وحدة تحكّم Firebase بعد خمس دقائق، يُرجى التواصل مع فريق دعم Firebase وتزويده بنسخة من مخرجات السجلّ حتى نتمكّن من مساعدتك في تحديد المشاكل وحلّها بشكلٍ أفضل.

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

  • خصِّص إعداد تقرير الأعطال عن طريق إضافة التقارير والسجلّات والمفاتيح وتتبُّع الأخطاء غير الفادحة التي تم تفعيلها، وذلك من خلال إضافة تقارير الأعطال.