Check out what’s new from Firebase at Google I/O 2022. Learn more

احصل على تقارير أعطال قابلة للقراءة في لوحة معلومات Crashlytics

بشكل افتراضي ، يعالج Firebase Crashlytics ملفات رمز التصحيح (dSYM) تلقائيًا لمنحك تقارير أعطال مبهمة وقابلة للقراءة. يتم تعيين هذا السلوك عند إضافة نص برمجي قيد التشغيل يقوم بتهيئة Crashlytics إلى مرحلة بناء تطبيقك.

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

تحقق مما إذا كان Xcode ينتج نماذج dSYM

في أغلب الأحيان ، تختفي ملفات dSYM لأن Xcode ببساطة لا ينتجها. عند فشل التحميل ، تعرض Crashlytics تنبيه "مفقود dSYM" في وحدة تحكم Firebase. إذا تلقيت هذا التنبيه ، فتحقق أولاً من أن Xcode ينتج dSYM الصحيح لكل إصدار:

  1. افتح مشروعك في Xcode وحدد ملف المشروع في Xcode Navigator.

  2. حدد هدف البناء الرئيسي الخاص بك.

  3. افتح علامة تبويب إعدادات بناء الهدف ، ثم انقر على الكل .

  4. ابحث عن "تنسيق معلومات التصحيح".

  5. اضبط تنسيق معلومات التصحيح على DWARF باستخدام ملف dSYM لجميع أنواع الإنشاءات.

  6. أعد بناء تطبيقك.

يجب أن تظهر تقارير الأعطال الآن في وحدة تحكم Firebase. إذا استمرت المشكلة أو واجهت أخطاء أخرى ، فحاول تحديد موقع dSYM وتحميله إلى Crashlytics يدويًا.

حدد موقع dSYMs الخاص بك

في بعض الأحيان ، يتعذر على Crashlytics تحديد موقع dSYM لتطبيقك بسبب تكوينات رمز البت أو اتصال وحدة التحكم. عند حدوث ذلك ، هناك طريقتان إضافيتان يمكنك من خلالهما استكشاف الأخطاء وإصلاحها:

تحميل dSYMs الخاص بك

كنسخة احتياطية ، يتضمن Crashlytics نصًا برموز upload-symbols يمكنك الاتصال به من أي مكان في عملية الإنشاء لتحميل dSYMs يدويًا. يوفر البرنامج النصي مزيدًا من المعلومات حول عملية التحميل والمزيد من رسائل الخطأ القوية (لملاحظات الاستخدام والتعليمات الإضافية ، قم بتشغيل upload-symbols بدون أي معلمات).

لتشغيل البرنامج النصي upload-symbols ، استخدم أحد الخيارات التالية:

  1. قم بتضمين السطر التالي في عملية الإنشاء الخاصة بك:

    find dSYM_directory -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /path/to/GoogleService-Info.plist -p platform \{\}
  2. قم بتشغيل البرنامج النصي مباشرة من جهازك الطرفي:

    /path/to/pods/directory/FirebaseCrashlytics/upload-symbols -gsp /path/to/GoogleService-Info.plist -p ios /path/to/dSYMs