Отладка по USB на Android¶

Отладка по USB — режим работы операционной системы Android, позволяющей подключать устройство к компьютеру по интерфейсу USB и выполнять установку приложений, запуск отладочных команд, чтение логов и профилирование. Режим управляется специальной службой ADB (Android Debug Bridge) и включается пользователем вручную через настройки устройства.

¶Что такое ADB

ADB (Android Debug Bridge) — командная утилита, входящая в состав Android SDK Platform Tools. Она состоит из трёх компонентов:

• adb server — демон, работающий на компьютере;
• adbd — демон, работающий на Android-устройстве;
• клиент — консольная команда adb, через которую пользователь отправляет запросы.

ADB работает по протоколу TCP поверх USB-соединения (по умолчанию порт 5555) и позволяет выполнять операции: установку и удаление APK, копирование файлов, запуск оболочки (adb shell), снятие скриншотов, чтение логов (adb logcat), перезагрузку в режим загрузчика или восстановления.

¶Как включить отладку по USB

¶Шаг 1: включить режим разработчика

По умолчанию пункт «Для разработчика» скрыт. Чтобы его открыть:

1. Открыть «Настройки» → «О телефоне» (в некоторых прошивках — «О системе» или «О телефоне» → «Версия ПО»).
2. Найти строку «Номер сборки» (Build number).
3. Нажать на неё 7 раз подряд. После нескольких нажатий появляется счётчик оставшихся касаний, после седьмого — сообщение «Вы стали разработчиком».

На устройствах Xiaomi, Huawei, Oppo и некоторых других китайских производителей путь может отличаться: например, на MIUI раздел называется «Для разработчиков» и находится в «Настройки» → «Дополнительные настройки».

¶Шаг 2: включить отладку по USB

1. Вернуться в основное меню «Настроек».
2. Открыть «Для разработчика» (раздел обычно расположен в конце списка или в «Дополнительных настройках»).
3. Включить переключатель «Отладка по USB» (USB debugging).

На некоторых устройствах при включении требуется подтверждение — диалог «Разрешить отладку по USB?» с отпечатком RSA-ключа компьютера. Пользователь может поставить галочку «Всегда разрешать с этого компьютера».

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

1. Подключить телефон кабелем USB.
2. На телефоне в шторке уведомлений выбрать режим USB-подключения. Для отладки подойдут режимы «Передача файлов (MTP)» или «Фотографии (PTP)». Режим «Только зарядка» может блокировать ADB на некоторых прошивках.
3. На экране телефона может появиться запрос «Разрешить отладку по USB?» — нажать «Разрешить».

¶Проверка подключения

На компьютере необходимо установить ADB. В Linux утилита ставится пакетным менеджером (sudo apt install adb), в Windows и macOS — скачиванием Android SDK Platform Tools с официального сайта Google.

Проверка работоспособности:

`` adb devices ``

Команда выводит список подключённых устройств. Результат List of devices attached с серийным номером и статусом device означает успешное подключение. Возможные статусы:

При статусе unauthorized необходимо разблокировать экран телефона и подтвердить диалог «Разрешить отладку по USB?».

¶Типичные проблемы

• Компьютер не видит устройство. Причина — отсутствие драйверов (Windows) или нерабочего кабеля. Для Windows рекомендуется установить драйверы Google USB Driver или драйверы производителя.
• ADB не находит устройство в Linux. Требуется настроить udev-правила: создать файл /etc/udev/rules.d/51-android.rules с идентификаторами USB-устройств и перезапустить службу udev.
• Периодическое отключение. Нестабильный кабель или повреждённый разъём USB.
• Конфликт adb-серверов. Если одновременно работают несколько экземпляров ADB (например, от Android Studio и сторонних программ), помогает команда adb kill-server.

¶Безопасность

Отладка по USB даёт полный доступ к файловой системе устройства (включая защищённые разделы при наличии root) и возможность установки приложений без подтверждения пользователя. Поэтому рекомендуется выключать режим после завершения работы и не оставлять галочку «Всегда разрешать» на чужих компьютерах. На устройствах с корпоративной политикой или в банковских приложениях отладка по USB может блокироваться системой безопасности.

¶Использование беспроводной отладки

Начиная с Android 11 появился режим Wireless debugging (беспроводная отладка), работающий по ADB over Wi-Fi без кабеля. Для активации требуется включить «Беспроводную отладку» в разделе «Для разработчика», затем сопрячь устройство с компьютером по коду pairing. Более ранние версии Android использовали команду adb tcpip 5555 и adb connect <ip-адрес>.

¶Источники

• Документация Android для разработчиков (developer.android.com)
• Android SDK Platform Tools — Google
• Справочник по ADB (XDA Developers)