Как получать понятные отчеты о сбоях на панели управления Crashlytics (Unity)

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


iOS+ (платформы Apple)

Для приложений на платформе Apple, использующих Crashlytics Unity SDK 8.2.0 или более поздней версии, плагин Firebase Unity Editor автоматически настраивает проект Xcode для загрузки символов. Скачайте последнюю версию.

Android

В Android-приложениях Crashlytics Unity SDK 8.6.1+ автоматически включает отчеты о сбоях NDK, что позволяет Crashlytics автоматически сообщать о сбоях Unity IL2CPP на Android. Однако, чтобы видеть расшифрованные стеки вызовов для сбоев нативных библиотек на панели управления Crashlytics, необходимо загрузить информацию о символах во время сборки с помощью интерфейса командной строки Firebase.

  1. Убедитесь, что вы используете Crashlytics Unity SDK версии 8.6.1 или более поздней. Скачайте последнюю версию.

  2. Настройте среду и проект для загрузки символов:

    1. Следуйте инструкциям по установке Firebase CLI.

      Если вы уже установили CLI, обновите его до последней версии.

    2. (только для приложений, использующих Android уровень API 30 и выше) Обновите шаблон AndroidManifest.xml, чтобы отключить тегирование указателя:

      1. Установите флажок Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Настройки проигрывателя Android > Настройки публикации > Сборка > Специальный основной манифест).

      2. Откройте шаблон манифеста, расположенный по адресу: Assets/Plugins/Android/AndroidManifest.xml.

      3. (только для приложений, в которых используется SDK версии ниже 8.8.0) Добавьте в тег application следующий атрибут: <application android:allowNativeHeapPointerTagging="false" ... />

  3. Создайте проект и загрузите символы.

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

    1. В диалоговом окне Настройки сборки выполните одно из следующих действий:

      • Экспортировать в проект Android Studio, чтобы создать проект.

      • Создавайте APK-файлы прямо в редакторе Unity.
        Перед сборкой убедитесь, что в диалоговом окне Настройки сборки установлен флажок Создать symbols.zip.

    2. После завершения сборки создайте файл символов, совместимый с Crashlytics, и загрузите его на серверы Firebase, выполнив следующую команду интерфейса командной строки Firebase:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: идентификатор приложения Firebase для Android (не название пакета)
        Пример идентификатора приложения Firebase для Android: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS – путь к файлу символов, созданному с помощью CLI.

        • Экспортировано в проект Android Studio – PATH/TO/SYMBOLS – это каталог unityLibrary/symbols, который создается в корневом каталоге экспортированного проекта после сборки приложения с помощью Gradle или Android Studio.

        • Создан APK-файл непосредственно в Unity. PATH/TO/SYMBOLS – путь к заархивированному файлу символов, созданному в корневом каталоге проекта после завершения сборки (например, myproject/myapp-1.0-v100.symbols.zip).

      Как использовать команду CLI Firebase для создания и загрузки файла символов

      Пометка Описание
      --generator=csym

      Использует устаревший генератор файлов символов cSYM вместо генератора Breakpad по умолчанию.

      Не рекомендуется использовать. Рекомендуем использовать генератор файлов символов Breakpad по умолчанию.

      --generator=breakpad

      Использует генератор файлов символов Breakpad

      По умолчанию для создания файлов символов используется Breakpad. Используйте этот флаг, только если вы добавили symbolGenerator { csym() } в конфигурацию сборки и хотите переопределить его, чтобы использовать Breakpad.

      --dry-run

      Создает файлы символов, но не загружает их.

      Этот флаг полезен, если вы хотите проверить содержимое отправляемых файлов.

      --debug Предоставляет дополнительную информацию для отладки