This guide contains instructions for the latest version of the Firebase Crashlytics SDK. If you migrated your app from Fabric, make sure it's been upgraded and no longer uses the deprecated legacy Fabric SDK.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع Firebase Crashlytics

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

قبل ان تبدأ

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

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

    1. إذا لم يتم تمكين Google Analytics لمشروع Firebase الحالي ، فيمكنك تمكين Google Analytics من علامة التبويب " التكامل" في > إعدادات المشروع .

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

    2. أخيرًا ، في وحدة تحكم Google Analytics ، قم بتمكين مشاركة البيانات في علامة تبويب المسؤول > إعدادات الحساب > إعدادات مشاركة البيانات .

      بالنسبة إلى مشروعات Firebase الأقدم ، لاحظ أنك قد تحتاج إلى تمكين مشاركة البيانات في علامة التبويب " التكامل" في > إعدادات المشروع (في وحدة تحكم Firebase).

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

  1. انقر فوق Crashlytics في لوحة التنقل اليمنى لوحدة تحكم Firebase .

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

  3. انقر فوق تمكين Crashlytics .

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

  1. فتح podfile قمت بإنشائه لمشروع Firebase وإضافة FirebaseCrashlytics جراب. للحصول على تجربة مثالية مع Firebase Crashlytics ، نوصي بتمكين Google Analytics في مشروعك عن طريق إضافة حافظة Firebase للتحليلات إلى تطبيقك أيضًا. تأكد من إضافة الإصدار 6.3.1 من Google Analytics أو إصدار أحدث من أجل الحصول على مستخدمين وفتات تنقل خالية من التعطل في الوقت الفعلي.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. ثبّت .xcworkspace ، ثم .xcworkspace فتح ملف .xcworkspace لمشاهدة المشروع في Xcode:

    pod install
    open your-project.xcworkspace
    
  3. استيراد وحدة Firebase في UIApplicationDelegate :

    سويفت

    import Firebase

    ج موضوعية

    @import Firebase;
  4. قم FirebaseApp مثيل FirebaseApp المشترك ، عادةً في تطبيق تطبيقك application:didFinishLaunchingWithOptions: method:

    سويفت

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

    ج موضوعية

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. أعد تجميع تطبيقك.

الخطوة 3 : تهيئة Crashlytics

يمكنك تهيئة Crashlytics عن طريق إضافة برنامج نصي إلى مرحلة بناء مشروعك. يسمح البرنامج النصي للتشغيل لـ Xcode بتحميل ملف dSYM الخاص بمشروعك تلقائيًا كلما تعطل تطبيقك بحيث يمكن لـ Crashlytics إنشاء تقارير الأعطال تلقائيًا.

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

  2. من القائمة المنسدلة تحديد مشروع أو هدف ، حدد هدف التصميم الرئيسي.

  3. حدد علامة التبويب مراحل البناء ، ثم انقر فوق > مرحلة تشغيل البرنامج النصي الجديد .

  4. قم بتوسيع قسم تشغيل البرنامج النصي الجديد الذي يظهر. في حقل البرنامج النصي (الموجود أسفل حقل Shell ) ، أضف برنامج تشغيل نصيًا جديدًا:

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. أضف موقع dSYM لتطبيقك كملف إدخال يمكّن Crashlytics من إنشاء dSYM تلقائيًا للتطبيقات الكبيرة بسرعة أكبر. فمثلا:

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    يمكنك أيضًا توفير موقع Info.plist المدمج Info.plist في حقل ملفات الإدخال في مرحلة Info.plist :

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

بعد إضافة SDK إلى تطبيقك ، يبدأ Crashlytics تلقائيًا في الاستماع إلى تقارير الأعطال وجمعها.

الخطوة 4 : قم بتشغيل مشروعك

أخيرًا ، قم بتشغيل التطبيق الخاص بك. تعرض سجلات جهازك تحقق Firebase من اكتمال التهيئة.

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