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

اختيار المنصة:

iOS+ Android Flutter Unity

‫iOS+ (منصات Apple)

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

Android

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

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

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

   1. اتّبِع التعليمات لتثبيت CLIFirebase.

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

      .

   2. (للتطبيقات التي تستخدم مستوى واجهة برمجة التطبيقات 30 من Android أو إصدارًا أحدث فقط) عدِّل نموذج AndroidManifest.xml لتطبيقك لإيقاف ميزة Pointer Tagging:

      1. ضَع علامة في مربّع Android Player Settings > Publishing Settings > Build > Custom Main Manifest.

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

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

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

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

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

      • يمكنك تصدير مشروع إلى مشروع استوديو Android لإنشائه.

      • يمكنك إنشاء حزمة APK مباشرةً من Unity Editor.
        قبل الإنشاء، تأكَّد من وضع علامة في مربّع إنشاء ملف 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

        هل تحتاج إلى العثور على رقم تعريف تطبيقك في Firebase؟

        في ما يلي طريقتان للعثور على رقم تعريف تطبيقك في Firebase:

        • في ملف google-services.json ، يكون رقم تعريف تطبيقك هو قيمة mobilesdk_app_id.

        • في Firebase console، انتقِل إلى صفحة settings Settings > General. انتقِل إلى بطاقة Your apps ، ثم انقر على تطبيق Firebase المقصود للعثور على رقم تعريف التطبيق.

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

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

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

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

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