Как протестировать реализацию Crashlytics (Flutter)

Выберите платформу: iOS+ Android Flutter Unity


Если вы выполнили инструкции из краткого руководства, но на панели управления Crashlytics по-прежнему не отображаются данные о сбоях, воспользуйтесь этим руководством.

Как принудительно вызвать сбой, чтобы проверить реализацию

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

    Если вы добавили обработчик ошибок, который вызывает FirebaseCrashlytics.instance.recordError(error, stack, fatal: true), в Zone верхнего уровня, то можете использовать следующий код, чтобы добавить в приложение кнопку, при нажатии на которую будет генерироваться тестовое исключение:

    TextButton(
        onPressed: () => throw Exception(),
        child: const Text("Throw Test Exception"),
    ),
    
  2. Создайте сборку и запустите приложение.

  3. Чтобы отправить первый отчет, принудительно вызовите тестовое исключение:

    1. Откройте приложение на тестовом устройстве или в эмуляторе.

    2. В приложении нажмите кнопку тестирования исключений, которую вы добавили с помощью кода выше.

  4. В консоли Firebase перейдите в раздел DevOps & Engagement (DevOps и взаимодействие) > Crashlytics dashboard (Панель управления) и проверьте, появился ли тестовый отчет о сбое.

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

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

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

Платформы Apple

  1. Включите журнал отладки:

    1. В Xcode выберите Product (Продукт) > Scheme (Схема) > Edit scheme (Изменить схему).

    2. В меню слева нажмите Run (Выполнить) и перейдите на вкладку Arguments (Аргументы).

    3. В разделе Arguments Passed on Launch (Аргументы, передаваемые при запуске) добавьте -FIRDebugEnabled.

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

  3. Найдите в журнале сообщение от Crashlytics, содержащее следующую строку. Это подтвердит, что ваше приложение отправляет данные о сбоях в Firebase.

    Completed report submission

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

Android

  1. Как включить и посмотреть журнал отладки для Crashlytics:

    1. Перед запуском приложения установите для флага оболочки adb значение DEBUG:

      adb shell setprop log.tag.FirebaseCrashlytics DEBUG
    2. Чтобы посмотреть журналы устройства, выполните следующую команду:

      adb logcat -s FirebaseCrashlytics
  2. Вызовите тестовый сбой. Инструкции приведены в первом разделе этой статьи.

  3. Найдите в выводе logcat следующее сообщение или код 204. Они подтверждают, что приложение отправляет данные о сбоях в Firebase.

    Crashlytics report upload complete

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

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