Как включить отладку в Android — пошаговое руководство по логированию

Введение / Зачем это нужно

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

Требования / Подготовка

• Установленная Android Studio (любая актуальная версия).
• USB-кабель для подключения смартфона к компьютеру.
• Установленные драйверы устройства (если запрашиваются ОС).
• Права администратора на компьютере (для установки драйверов).
• Устройство на Android 10–13 (функционал одинаков в этих версиях).

Пошаговая инструкция

Шаг 1: Включить опции разработчика и разрешить отладку USB

⚠️ Важно: изменения в параметрах разработчика затрагивают только текущее устройство и не влияют на другие смартфоны.

1. Откройте Настройки → О телефоне.
2. Найдите пункт Версия ПО и нажмите его 7 раз подряд.
3. Вернитесь в Настройки → Система → Дополнительно → Параметры разработчика.
4. Найдите Отладка USB и включите её, подтвердив запрос на устройстве.

Шаг 2: Подключить устройство к компьютеру

1. Подключите смартфон к компьютеру с помощью USB-кабеля.
2. На экране телефона выберите режим Передача файлов или Зарядка.
3. На компьютере установите драйверы (если система запрашивает), и повторите подключение.

Шаг 3: Включить глобальную отладку через Android Studio

1. Запустите Android Studio, откройте ваш проект.
2. Перейдите в File → Settings → Build, Execution, Deployment → Gradle Settings и убедитесь, что выбрана отладочная конфигурация.
3. Выполните File → Invalidate Caches / Restart… → Invalidate and Restart, чтобы обновить среду.

Шаг 4: Запустить Logcat и настроить фильтр

1. Откройте окно Logcat (Tools → Logcat).
2. В поле ввода введите log.tag.<YourApp> (например, log.tag.MyApp) и нажмите Apply.
3. Также можно использовать *:S Logcat для вывода всех сообщений.

Шаг 5: Получить и сохранить логи

1. Запустите приложение на устройстве и выполните действие, которое вызывает проблему.
2. Логи отобразятся в окне Logcat в реальном времени.
3. Для сохранения выберите нужные записи и нажмите File → Save или выполните команду в терминале:

adb logcat > logs.txt

Проверка результата

• Если отладка включена, в Logcat видны сообщения с тегом, который вы настроили (например, DEBUG).
• Логи отображаются без ошибок, и вы можете фильтровать их по уровню важности (Verbose, Debug, Info, Warn, Error, Assert).
• Сохранённый файл logs.txt находится в рабочей директории и содержит текстовый вывод для дальнейшего анализа.

Возможные проблемы

• Устройство не распознаётся – проверьте USB-кабель, переключите режим подключения (Передача файлов ↔ Только зарядка), установите драйверы.
• Отладка USB не появляется – убедитесь, что опции разработчика активированы (шаг 1), перезагрузите телефон и повторите.
• Logcat пуст – убедитесь, что приложение запущено с отладочной конфигурацией, проверьте тег через adb shell setprop log.tag.<YourApp> DEBUG.
• Логи сохраняются не полностью – используйте adb logcat -f logs.txt -r 5000 для ротации логов или увеличьте буфер.