Аварийные журналы. Краш лог
Как получить или сгенерировать журналы сбоев?
СодержаниеЛогирование на Android
• Функция отчета об ошибках
• Как создавать отчеты об ошибках Android с помощью параметров разработчика
• Создание журналов с помощью Android Debug Bridge (ADB)
• Как создавать журналы Android через ADB
• Подготовка
• Создание журналов
• Использование командного файла для упрощения вашей работы
• Поиск проблемы
Логирование iOS и аварийные дампы
• Файлы журнала сбоев
• Первый вариант: использование вашего iPhone или iPad
• Второй вариант: использование iTunes
• Третий вариант: использовать iTools или другое программное обеспечение
• Создание консольных журналов
• Статьи по теме и ссылки
Мотивация
В случае сбоев, зависаний или любых других критических функциональных проблем в мобильном приложении журналы устройств являются обязательным компонентом вашего отчета об ошибках. Только зарегистрированная информация может предоставить детальное понимание обстоятельств проблемы.
В этой статье мы продемонстрируем общие решения для извлечения информации журнала для устройств iOS и Android. Применение этих методов позволит вам записывать и прикреплять значимые файлы журналов к вашим отчетам.
Логирование на Android
В зависимости от ситуации и доступных устройств существует два основных подхода к получению журналов устройств Android:
Функция отчета об ошибках
С помощью функции отчетов об ошибках Android прямо в настройках разработчика на вашем устройстве вы можете создавать отчеты об ошибках в любое время, которые будут включать всю активность журнала в течение определенного периода времени, в зависимости от размера буфера журнала и активности журнала на вашем устройстве. , Этот период времени может достигать от нескольких минут до нескольких часов или даже дней.
Как создавать отчеты об ошибках Android с помощью параметров разработчика
1. Включите параметры разработчика на вашем телефоне:
2. Откройте настройки и перейдите в «Система» > «О вашем телефоне».
3. Нажмите на номер сборки 7 раз.
4. Вернитесь в Настройки > Система.
5. Найдите параметры разработчика.
6. Нажмите Принять отчет об ошибке и, если потребуется, выберите Интерактивный отчет.
7. Следите за ходом создания отчета в ваших уведомлениях.
8. Когда все будет готово, поделитесь отчетом, отправив себе электронное письмо или загрузив его на выбранную вами цель, такую как Google Drive или Dropbox.
9. Приспособьте вывод журнала к падению:
10. Откройте текстовый файл отчета на вашем компьютере (сначала распакуйте его, если требуется).
11. Найдите раздел отчета SYSTEM LOG .
12. Если вы знаете время сбоя, используйте метку времени, чтобы найти его.
13. Если вы не знаете время, вы можете выполнить поиск по ключевым словам, таким как исключение, сбой или смерть, которые относятся к тестируемому приложению.
14. Извлеките соответствующую часть, включая некоторое время до и после события ошибки.
Пожалуйста, посмотрите на следующий пример события сбоя, которое включает в себя трассировку стека события ошибки и позволяет разработчику найти ошибку:
Создание журналов с помощью Android Debug Bridge (ADB)
Используя Android Debug Bridge , вы можете создавать файлы журналов, которые охватывают определенный период времени. Эти файлы меньше и ориентированы на конкретную проблему, которая в идеале должна быть легко воспроизводимой. Эти журналы не требуют ручного поиска событий сбоя и являются предпочтительным методом для создания значимых журналов для воспроизводимых проблем.
Как создавать журналы Android через ADB
Для создания ADB-соединения с вашим телефоном доступно множество инструментов. Очень маленький и универсальный - Minimal ADB и Fastboot .
Подготовка
Следующие шаги необходимо выполнить только один раз:
1. Загрузите Minimal ADB и Fastboot здесь или используйте любой другой источник.
2. Установите программное обеспечение или откройте папку с программой, если вы выбрали переносную версию.
3. Подготовьте ваше устройство к использованию отладки по USB.
4. Подключите телефон к компьютеру.
5. На вашем телефоне зайдите в Настройки > Система > Параметры разработчика.
6. Найдите параметр, аналогичный отладке по USB, включите его и подтвердите предупреждение, которое может появиться.
7. При первом подключении к компьютеру подтвердите предупреждение системы безопасности и установите флажок Всегда разрешать с этого компьютера, чтобы избежать будущих предупреждений.
Создание журналов
1. На вашем компьютере откройте Minimal ADB и Fastboot либо ...
2. ... через меню "Пуск" (если вы его установили) или ...
3. … Перейдите в папку переносной версии, удерживайте клавишу SHIFT, щелкните правой кнопкой мыши пустое место в папке и выберите «Открыть командную строку здесь» - соответственно, откройте PowerShell здесь на компьютерах с Windows 10.
4. Подключите телефон к компьютеру.
5. В Minimal ADB введите следующую команду для проверки успешного соединения: adb devices
6. Ваше устройство должно быть указано среди подключенных устройств.
7. Если вы хотите создать журнал для воспроизводимой проблемы, сначала очистите историю журнала, чтобы удалить ненужный контент, введя: adb logcat -c
8. Чтобы начать фактическое ведение журнала, выполните следующие действия:
9. Выберите или создайте папку на своем компьютере, удерживайте SHIFT и щелкните правой кнопкой мыши папку
10. В контекстном меню выберите «Копировать как путь»
11. В Minimal ADB введите: adb logcat > и вставьте свой путь, щелкнув правой кнопкой мыши окно журнала, после чего оно может выглядеть следующим образом: adb logcat > "D: \ Logs"
12. Теперь добавьте имя файла в путь, который будет выглядеть следующим образом (обязательно используйте расширение файла TXT): adb logcat> "D: \ Logs \ log.txt"
13. Подтвердите, нажав Return.
14. Воспроизведите ошибку или сбой, для которого вы хотите создать журнал. Хотя в окне журнала ничего не происходит, Minimal ADB записывает действия журнала в фоновом режиме.
15. Когда вы закончите, нажмите CTRL + C, чтобы остановить запись.
16. Теперь вы найдете свой лог-файл в указанной папке.
Использование командного файла для упрощения вашей работы
Чтобы избежать необходимости вводить все команды вручную каждый раз, вы можете создать пакетный файл для автоматизации этих задач. Для этого выполните следующие действия:
1. Загрузите переносную версию Minimal ADB и Fastboot и перейдите к извлеченной папке.
2. Создайте новый текстовый файл в этой папке и откройте его в редакторе, таком как Windows Editor.
3. Добавьте следующий контент: @ECHO OFF; эхо Очистка истории журнала…; adb logcat -c; эхо Начинается живое ведение журнала. Нажмите CTRL + C, чтобы остановить .; adb logcat> device_log.txt
4. Сохраните файл как log.bat и убедитесь, что .bat является фактическим расширением файла.
Каждый раз, когда вы выполняете этот файл, новый файл журнала будет создан в текущей папке. Старые будут перезаписаны.
Решение проблем
Если Minimal ADB не распознает ваш телефон, вы можете использовать альтернативный драйвер, такой как Universal ADB Driver. Отключите телефон, установите драйвер и снова подключите телефон. После этого попробуйте снова создать журнал.
Кроме того, убедитесь, что ваш телефон не установлен в режим зарядки, только если он подключен к компьютеру. Вместо этого выберите Передача файлов или Передача мультимедиа.
Логирование iOS и аварийные дампы
Получение информации журнала на устройствах iOS не требует больших усилий и обычно не требует доступа к компьютеру. Различные типы информации журнала могут быть получены, и мы хотим охватить несколько подходов их получения.
Файлы журнала сбоев
Наиболее распространенным типом данных журнала является файл отчета о сбое, который автоматически создается в фоновом режиме после сбоя на вашем устройстве iOS. Сбор этого файла и присоединение его к вашему отчету об ошибке будет достаточным для большинства сбоев. Есть несколько подходов для получения этих файлов, и мы хотели бы охватить три из них.
Первый вариант: использование вашего iPhone или iPad
Вы можете получить доступ к истории отчетов о сбоях прямо на вашем телефоне и без участия компьютера. Для этого выполните следующие действия:
1. На вашем телефоне или планшете зайдите в Настройки и нажмите Конфиденциальность.
2. Нажмите здесь, чтобы войти в Analytics and Analytics Data.
3. Просмотрите список отчетов. Список отсортирован по алфавиту. Найдите название уязвимого приложения и соответствующую временную метку.
4. Найдя, нажмите на отчет.
5. Поделитесь его содержанием с приложением по вашему выбору и приложите его к вашему сообщению об ошибке.
Второй вариант: использование iTunes
Вы также можете использовать iTunes для доступа ко всем отчетам о сбоях на вашем телефоне - требуется только синхронизация:
1. Подключите ваш iPhone или iPad к компьютеру.
2. Если его еще нет, установите iTunes.
3. Откройте iTunes и подключите свой телефон или планшет через USB.
4. Дождитесь автоматической синхронизации или запустите ее вручную.
5. Найдите папку отчетов на вашем компьютере:
6. Mac OS X: ~ / Библиотека / Журналы / CrashReporter / MobileDevice / <DEVICE_NAME>
7. Windows: C: \ Users \ <ИМЯ ПОЛЬЗОВАТЕЛЯ> \ AppData \ Roaming \ Apple Computer \ Logs \ CrashReporter \ MobileDevice \ <DEVICE_NAME>
8. Найдите соответствующий файл .crash или .ips на основе имени приложения и метки времени.
9.Прикрепите его к вашему сообщению об ошибке.
Третий вариант: использовать iTools или другое программное обеспечение
Кроме того, вы можете использовать программное обеспечение, такое как iTools, для доступа к отчетам о сбоях на вашем телефоне. Для этого выполните следующие действия:
1. Скачайте, установите и откройте iTools .
2. Подключите телефон через USB и подтвердите установку драйвера, если это необходимо.
3. Нажмите Toolbox в верхней части приложения.
4. Нажмите Отчеты о сбоях.
5. Выберите элемент на основе имени приложения и отметки времени.
6. Нажмите «Экспорт», чтобы сохранить файл и прикрепить его к сообщению об ошибке.
Создание консольных журналов
Иногда вы не можете найти и предоставить файл журнала сбоев, так как приложение может не иметь сбоев, но демонстрирует другое критическое поведение. В качестве альтернативы вас могут попросить предоставить дополнительную информацию об обстоятельствах проблемы, при которой журналы консоли могут использоваться для получения дополнительной информации.
Существует несколько подходов к сбору журналов консоли, но мы хотим рассмотреть простой подход с использованием программного обеспечения iTools , которое доступно в виде бесплатной пробной версии:
1. Загрузите и установите iTools .
2. Подключите телефон через USB и подтвердите установку драйвера при необходимости
3. Нажмите Toolbox в верхней части приложения.
4. Нажмите Console Log.
5. Воспроизведите вашу проблему во время записи журнала.
6. Нажмите Очистить, чтобы сбросить историю журнала перед началом воспроизведения, если это необходимо.
7. Воспроизведите сбой или неисправное поведение на вашем телефоне.
8. Нажмите Сохранить полный журнал.
9. Укажите имя файла и подтвердите его.
10. Прикрепите файл журнала консоли к вашему отчету об ошибке.