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

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


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

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

Платформы Apple

Проверьте конфигурацию для загрузки файлов dSYM

При добавлении плагина Crashlytics Flutter и выполнении команды flutterfire configure будет предпринята попытка добавить скрипт запуска в рабочую область Xcode вашего проекта, который находит и загружает необходимые файлы символов dSYM в Crashlytics. Без этих файлов на панели управления Crashlytics появится предупреждение "Отсутствует dSYM", а исключения будут храниться в серверной части до тех пор, пока вы не загрузите недостающие файлы.

Если у вас возникла эта проблема, сначала убедитесь, что у вас установлен скрипт запуска:

  1. Найдите и откройте файл рабочей области Xcode в каталоге iOS проекта (FLUTTER_PROJECT_NAME/ios/Runner.xcworkspace).

  2. Проверьте, добавлен ли скрипт запуска с названием [firebase_crashlytics] Crashlytics Upload Symbols в раздел Build Phases (Этапы сборки) целевого объекта Runner.

    Выберите нужный раздел ниже в зависимости от того, существует ли скрипт запуска.

Проверьте конфигурацию версии для Flutter и Crashlytics (если используется флаг --split-debug-info).

Если в вашем проекте Flutter используется флаг --split-debug-info (и, возможно, --obfuscate), вам нужно выполнить дополнительные действия, чтобы трассировки стека в приложении были читаемыми.

Убедитесь, что в вашем проекте используется рекомендуемая конфигурация версий (Flutter 3.12.0+ и плагин Crashlytics Flutter 3.3.4+), чтобы ваш проект мог автоматически генерировать и загружать символы Flutter (файлы dSYM) в Crashlytics.

Android

Проверьте конфигурацию зависимостей

Команда flutterfire configure пытается добавить необходимые зависимости в файлы сборки Gradle вашего проекта. Без этих зависимостей отчеты о сбоях в консоли Firebase могут быть обфусцированы, если включена обфускация.

Убедитесь, что в файлах build.gradle на уровне проекта и build.gradle на уровне приложения есть следующие строки:

  • В файле сборки на уровне проекта (android/build.gradle) найдите следующую строку:

    dependencies {
    // ... other dependencies
    
    classpath 'com.google.gms:google-services:4.3.5'
    classpath 'com.google.firebase:firebase-crashlytics-gradle:2.7.1'
    }
  • В файле сборки на уровне приложения (android/app/build.gradle) проверьте наличие следующей строки:

    // ... other imports
    
    android {
    // ... your android config
    }
    
    dependencies {
    // ... your dependencies
    }
    
    // This section must appear at the bottom of the file
    apply plugin: 'com.google.gms.google-services'
    apply plugin: 'com.google.firebase.crashlytics'

Убедитесь, что вы используете CLI для загрузки символов Flutter (если используется флаг --split-debug-info).

Если в вашем проекте Flutter используется флаг --split-debug-info (и, возможно, --obfuscate), вам нужно выполнить дополнительные действия, чтобы трассировки стека в приложении были читаемыми.

Используйте Firebase CLI (версии 11.9.0 или более поздней), чтобы загрузить отладочные символы Flutter. Символы отладки необходимо загрузить до того, как вы сообщите о сбое в сборке с обфусцированным кодом.

В корневом каталоге проекта Flutter выполните следующую команду:

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 – тот же каталог, который вы передаете флагу --split-debug-info при создании приложения.

Если проблемы не исчезнут, ознакомьтесь с руководством по устранению неполадок с обфусцированными отчетами для Android.