Как протестировать реализацию 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 & Engagement (DevOps и взаимодействие) > Crashlytics dashboard (Панель управления) и проверьте, появился ли тестовый отчет о сбое.

    Если вы обновили консоль и по-прежнему не видите тестовый сбой через пять минут, попробуйте включить ведение журнала отладки (следующий раздел).

Включить журнал отладки для Crashlytics

Если вы не видите тестовый сбой на панели управления Crashlytics, вы можете использовать журнал отладки для Crashlytics, чтобы отследить проблему.

  1. Чтобы включить ведение журнала отладки для Firebase, добавьте в код инициализации приложения следующую строку:

    Firebase.FirebaseApp.LogLevel = Firebase.LogLevel.Debug;
  2. Вызовите тестовый сбой. Инструкции приведены в первом разделе этой статьи.

Если через пять минут вы по-прежнему не видите эту запись или тестовый сбой на панели управления DevOps & Engagement (DevOps и вовлечение) > Crashlytics в консоли Firebase, обратитесь в службу поддержки Firebase и предоставьте копию журнала. Мы поможем вам устранить неполадки.

Дальнейшие действия