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


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

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

Android

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

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

  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 أمر سطر الأوامر لإنشاء ملفات الرموز وتحميلها

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

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

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

      --generator=breakpad

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

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

      --dry-run

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

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

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