اختبار عملية تنفيذ 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، انتقِل إلى عمليات التطوير والتفاعل > لوحة بيانات Crashlytics للتحقّق من تقرير الأعطال التجريبي.

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

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

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

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

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

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

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