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


الإصدار 10 من نظام التشغيل iOS والإصدارات الأحدث (منصّات Apple)

بالنسبة إلى تطبيقات منصة Apple التي تستخدم الإصدار Crashlytics Unity SDK 8.2.0 أو الإصدارات الأحدث، يضبط المكوّن الإضافي لـ Firebase IDE في Unity Editor مشروع Xcode تلقائيًا لتحميل العلامات. تنزيل أحدث إصدار

Android

بالنسبة إلى تطبيقات Android، يتضمّن الإصدار Crashlytics Unity SDK 8.6.1 والإصدارات الأحدث تلقائيًا reporting reporting، ما يسمح Crashlytics بالإبلاغ تلقائيًا عن أعطال Unity IL2CPP على Android. ومع ذلك، للاطّلاع على عمليات تتبُّع حزم التكديس الرمزية لأعطال مكتبة Crashlytics الأصلية في لوحة بيانات Crashlytics، عليك تحميل معلومات الرموز في وقت الإنشاء باستخدام واجهة برمجة التطبيقات Firebase.

  1. تأكَّد من استخدام الإصدار Crashlytics 8.6.1 من حزمة Unity SDK أو إصدار أحدث. تنزيل أحدث إصدار

  2. اضبط البيئة والمشروع لتحميل الرموز:

    1. اتّبِع التعليمات لتثبيت واجهة برمجة التطبيقات Firebase.

      إذا سبق لك تثبيت واجهة برمجة التطبيقات، احرص على تحديثها إلى أحدث إصدار.

    2. (للتطبيقات التي تستخدم المستوى 30 أو أعلى من Android API فقط) عدِّل AndroidManifest.xml نموذج تطبيقك لإيقاف وضع علامات على المؤشرات:

      1. ضَع علامة في المربّع بجانب إعدادات مشغّل Android > إعدادات النشر > الإصدار > البيان الرئيسي المخصّص.

      2. افتح نموذج البيان المتوفّر في Assets/Plugins/Android/AndroidManifest.xml.

      3. (للتطبيقات التي تستخدم إصدارًا من حزمة SDK أقدم من 8.8.0 فقط) أضِف السمة التالية إلى علامة التطبيق: <application android:allowNativeHeapPointerTagging="false" ... />

  3. أنشئ مشروعك وحمِّل الرموز.

    أكمِل هذه الخطوات في كل مرة تنشئ فيها إصدارًا أو أي إصدار تريد الاطّلاع فيه على عمليات تتبُّع تسلسل استدعاء الدوال البرمجية المشفَّرة في وحدة تحكُّم Firebase.

    1. من مربّع الحوار إعدادات الإصدار، نفِّذ أحد الإجراءات التالية:

      • التصدير إلى مشروع في "استوديو Android" لإنشاء مشروعك

      • يمكنك إنشاء حزمة APK مباشرةً من "أداة تحرير Unity".
        قبل الإنشاء، تأكَّد من وضع علامة في مربّع الاختيار Create symbols.zip في مربّع الحوار إعدادات الإنشاء.

    2. بعد الانتهاء من عملية الإنشاء، أنشئ ملفًا لرمز متوافق معCrashlytics وحمِّله إلى خوادم Firebase من خلال تنفيذ الأمر التالي لFirebase CLI:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: رقم تعريف تطبيق Firebase لنظام التشغيل Android (وليس اسم الحزمة)
        مثال على رقم تعريف تطبيق Firebase لنظام التشغيل Android: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS: مسار ملف الرموز الذي تم إنشاؤه بواسطة واجهة سطر الأوامر

        • تم تصديره إلى مشروع في "استوديو Android": PATH/TO/SYMBOLS هو دليل unityLibrary/symbols، الذي يتم إنشاؤه في الدليل الجذر للمشروع الذي تم تصديره بعد إنشاء التطبيق من خلال Gradle أو "استوديو Android".

        • تم إنشاء حزمة APK مباشرةً من داخل Unity: PATH/TO/SYMBOLS هو مسار ملف الرموز المضغوط الذي تم إنشاؤه في الدليل الجذر للمشروع عند انتهاء عملية الإنشاء (على سبيل المثال: myproject/myapp-1.0-v100.symbols.zip).

      عرض الخيارات المتقدّمة لاستخدام Firebase أمر سطر الأوامر لإنشاء ملفات الرموز وتحميلها

      الإبلاغ الوصف
      --generator=csym

      يستخدم أداة إنشاء ملفات الرموز cSYM القديمة بدلاً من أداة إنشاء Breakpad التلقائية

      لا يُنصح باستخدامها. ننصحك باستخدام ملف الترميز التلقائي لبرنامج Breakpad.

      --generator=breakpad

      استخدام أداة إنشاء ملفات الرموز البرمجية Breakpad

      يُرجى العِلم أنّ الإعداد التلقائي لإنشاء ملف الرموز هو Breakpad. لا تستخدِم هذا الإعداد إلا إذا أضفت symbolGenerator { csym() } في إعدادات الإنشاء وأردت إلغاء استخدامه لاستخدام Breakpad بدلاً من ذلك.

      --dry-run

      إنشاء ملفات الرموز بدون تحميلها

      تكون هذه العلامة مفيدة إذا كنت تريد فحص محتوى الملفات المُرسَلة.

      --debug يوفّر معلومات إضافية عن تصحيح الأخطاء