اختبار عملية تنفيذ Crashlytics (Unity)

اختيار المنصة: iOS+ Android Flutter Unity


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

فرض حدوث عطل لاختبار عملية التنفيذ

  1. ابحث عن GameObject حالي، ثم أضِف إليه النص البرمجي التالي. سيؤدي هذا النص البرمجي إلى حدوث عطل تجريبي بعد بضع ثوانٍ من تشغيل تطبيقك.

    using System;
    using UnityEngine;
    
    public class CrashlyticsTester : MonoBehaviour {
    
        int updatesBeforeException;
    
        // Use this for initialization
        void Start () {
          updatesBeforeException = 0;
        }
    
        // Update is called once per frame
        void Update()
        {
            // Call the exception-throwing method here so that it's run
            // every frame update
            throwExceptionEvery60Updates();
        }
    
        // A method that tests your Crashlytics implementation by throwing an
        // exception every 60 frame updates. You should see reports in the
        // Firebase console a few minutes after running your app with this method.
        void throwExceptionEvery60Updates()
        {
            if (updatesBeforeException > 0)
            {
                updatesBeforeException--;
            }
            else
            {
                // Set the counter to 60 updates
                updatesBeforeException = 60;
    
                // Throw an exception to test your Crashlytics implementation
                throw new System.Exception("test exception please ignore");
            }
        }
    }
  2. أنشئ تطبيقك وحمِّل معلومات الرموز بعد انتهاء عملية الإنشاء.

    • ‫iOS+: يضبط مكوّن Firebase Unity Editor الإضافي تلقائيًا مشروع Xcode لتحميل ملف الرموز.

    • Android: بالنسبة إلى تطبيقات Android التي تستخدم IL2CPP، شغِّل أمر Firebase CLI crashlytics:symbols:upload لتحميل ملف الرموز.

  3. شغِّل تطبيقك. بعد تشغيل تطبيقك، راقِب سجلّ الجهاز وانتظِر أن يتم تفعيل الاستثناء من CrashlyticsTester.

    • ‫iOS+: يمكنك الاطّلاع على السجلات في اللوحة السفلية من Xcode.

    • Android: يمكنك الاطّلاع على السجلات من خلال تشغيل الأمر التالي في المحطة الطرفية: adb logcat.

  4. في وحدة تحكّم Firebase، انتقِل إلى لوحة بيانات DevOps والتفاعل > Crashlytics للاطّلاع على تقرير العطل التجريبي .

    إذا أعَدت تحميل وحدة التحكّم ولا يزال العطل التجريبي لا يظهر بعد خمس دقائق، جرِّب تفعيل تسجيل معلومات تصحيح الأخطاء (القسم التالي).

تفعيل تسجيل معلومات تصحيح الأخطاء في Crashlytics

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

  1. فعِّل تسجيل معلومات تصحيح الأخطاء في Firebase من خلال إضافة الرمز البرمجي التالي إلى عملية تهيئة تطبيقك:

    Firebase.FirebaseApp.LogLevel = Firebase.LogLevel.Debug;
  2. افرض حدوث عطل تجريبي. يوضّح القسم الأول من هذه الصفحة كيفية إجراء ذلك.

بعد خمس دقائق، إذا لم يظهر هذا السجلّ أو العطل التجريبي في لوحة بيانات DevOps والتفاعل > Crashlytics في وحدة تحكّم Firebase، تواصَل مع فريق دعم Firebase وأرسِل إليه نسخة من ناتج السجلّ لنتمكّن من مساعدتك في تحديد المشاكل وحلّها بشكلٍ أكبر.

الخطوات التالية