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

iOS+ (أنظمة Apple الأساسية)

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

Android

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

  1. تأكّد من استخدام الإصدار 8.6.1 من حزمة تطوير البرامج (SDK) لمنصة Crashlytics Unity أو إصدار أحدث. تنزيل أحدث إصدار:

  2. إعداد بيئتك ومشروعك لتحميل الرموز:

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

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

    2. (فقط للتطبيقات التي تستخدم المستوى 30 من واجهة برمجة تطبيقات Android والإصدارات الأحدث) حدِّث تحديث نموذج 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 Editor.
        قبل إنشاء الرمز، تأكّد من أنّ مربّع الاختيار Create symbols.zip سبق أن تم ضبطه. في مربع الحوار إعدادات التصميم.

    2. بعد اكتمال التصميم، أنشئ رمزًا متوافقًا مع Crashlytics. وتحميله إلى خوادم Firebase من خلال تشغيل أمر Firebase CLI:

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

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

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

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

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

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

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

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

      لا ننصح باستخدامها. ننصح باستخدام المخطَّط التلقائي منشئ ملف رمز لوحة الإيقاف

      --generator=breakpad

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

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

      --dry-run

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

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

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