Крэши и ошибки

Скачать инструкцию для разработчика (TXT): crashes-developer-ru.txt

Как настроить сбор

Сбор крэшей предусмотрен в AppMetrica SDK. Проверьте интеграцию для вашей платформы и настройки передачи. Для собственных сообщений об ошибках разработчик добавляет вызов соответствующего метода SDK.

Например, если приложение обработало неудачную операцию и показало пользователю сообщение, разработчик может передать ошибку для последующего анализа. Какие ситуации отправлять, определяет команда приложения.

Ссылки на методы Android, iOS, Flutter, React Native и Unity приведены в инструкции по отправке ошибок.

Файлы для расшифровки сбоев на Android и iOS

Используйте файлы, соответствующие сборке приложения, в которой произошел сбой. Ниже приведены требования и способы загрузки для каждой платформы.

Android: mapping-файлы и отладочные символы

AppMetrica позволяет собирать информацию о нативных и java-крэшах. Их можно анализировать в отчете Крэши и ошибки. См. также раздел Отправка ошибок на разных платформах.

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

Если во время сборки Android-приложения сжимали и обфусцировали код, то информация о крэшах передается в обфусцированном виде. Чтобы извлечь данные для анализа из таких крэш-логов, AppMetrica выполняет деобфускацию на стороне сервера.

Для этого загрузите mapping-файлы или отладочные символы SO-файлов в AppMetrica: автоматически при сборке приложения или вручную через веб-интерфейс.

Чтобы отправлять файлы, подключите AppMetrica Gradle Plugin.

Узнать больше

• Отчет Крэши и ошибки
• Документация Android

iOS: dSYM-файлы

Информация о крэшах на iOS отправляется в десимволизированном виде. Из таких крэш-логов сложно извлечь данные для анализа. Чтобы крэш-логи можно было анализировать, загрузите dSYM-файлы в AppMetrica.

Для загрузки dSYM-файлов в AppMetrica SDK включен инструмент командной строки helper. Для сборки с помощью fastlane поддержан плагин загрузки. С их помощью можно настроить автоматическую загрузку dSYM-файлов при сборке приложения.

Пожалуйста, отправляйте dSYM файлы только для тех приложений, которые вы хотите опубликовать.

Автоматическая загрузка при сборке

Используйте fastlane для сборки приложения:

1. Установите fastlane-плагин appmetrica:

   fastlane add_plugin appmetrica
   

   Подробнее о добавлении плагина в документации fastlane.

2. Добавьте в файл fastlane/Fastfile следующее:

   lane :release do
   # Your actions before.
   gym(
   workspace: "MyApp.xcworkspace",
   configuration: "Release",
   scheme: "MyApp",
   export_method: "app-store"        # Pass the correct export_method.
   )
   upload_symbols_to_appmetrica(post_api_key: "Post API key")
   # Your actions after.
   end
   

   Post API key можно получить в разделе Настройки в AppMetrica. Он используется для идентификации вашего приложения.

   Важно

   Для сборки приложения используется action gym с экспортом. Если вы собираете приложение с помощью Xcode, приложение будет перекомпилировано после загрузки в App Store Connect. Тогда сгенерированные при сборке dSYM-файлы нельзя будет использовать.

3. Добавьте этап загрузки dSYM-файлов с помощью инструмента helper в Xcode. Инструмент helper включен в AppMetrica SDK, начиная с версии 3.8.0. Он находится в архиве SDK. Справочник инструмента helper.

   1. Откройте проект в Xcode.

   2. В навигаторе по проекту выберите файл проекта.

   3. В блоке Targets выберите ваше приложение.

   4. Откройте вкладку Build Phases.

   5. Нажмите кнопку + → New Run Script Phase.

   6. В текстовое поле Type a script добавьте:

      if [ -d "${PODS_ROOT}/AppMetricaCrashes" ]; then
      HELPER_PATH=`find "${PODS_ROOT}/AppMetricaCrashes" -name "helper"`
      if [ -x  "${HELPER_PATH}" ]; then
      "${HELPER_PATH}" auto --post-api-key="Post API key"&
      else
      echo "AppMetricaСrash helper was not found"
      fi
      fi
      

   Примечание

   Режим auto использует переменную окружения CONFIGURATION. Если сборка собирается с конфигурацией Debug, dSYM-файлы не загружаются.

Загрузка отсутствующего dSYM-файла

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

Чтобы их символизировать, загрузите отсутствующие dSYM-файлы. Список отсутствующих файлов можно посмотреть на странице Настройки → Крэши вашего приложения в AppMetrica.

Отсутствующие dSYM-файлы можно загрузить:

• С помощью fastlane
• Через веб-интерфейс
• С помощью helper

helper -k <post-api-key> <file_path>

Справочник инструмента helper

Helper — инструмент командной строки, который позволяет загружать dSYM-файлы в AppMetrica.

$ helper [auto] [-o | --package-output-path=<path>] [-v | --verbose]
         [--version] -k <post-api-key> | --post-api-key=<key> [file ...]

Параметры

& позволяет запускать helper параллельно, не блокируя сборку всего проекта. Пример команды:

helper auto --post-api-key="Post API key"&

Узнать больше

• Отчет Крэши и ошибки
• Документация Apple

Post API key можно получить в разделе Настройки в AppMetrica. Он используется для идентификации вашего приложения.

Как проверить результат

1. В тестовом окружении воспроизведите контролируемую ошибку или сбой.
2. Откройте отчет Крэши и ошибки и найдите данные тестовой версии приложения.
3. Проверьте сообщение, устройство и стек вызовов — последовательность функций, связанных со сбоем.
4. Если стек не читается, проверьте наличие отладочных файлов именно для этой сборки.

Крэши объединяются в группы по стеку вызовов; группировка ошибок зависит от метода отправки. Подробности — в документации по крэшам и ошибкам.

Отправка ошибок на разных платформах

• Android
• iOS
• Flutter
• React Native
• Unity