Подключение телефона по ADB

ADB - это способ, которым компьютер разговаривает с телефоном по кабелю. Через него Lusiesta Studio видит устройства, снимает картинку экрана, ставит приложения и выполняет сценарии. В этой статье - как подключить телефон правильно, как понять, что всё получилось, и что означают состояния, в которых устройство видно, но не работает.

Что такое ADB простыми словами

ADB (Android Debug Bridge) - служебный мост между компьютером и Android-телефоном. На компьютере работает небольшая фоновая служба (adb-сервер), она держит список подключённых устройств и передаёт им команды. Телефон отвечает на команды только если на нём включена отладка по USB и вы разрешили доступ конкретному компьютеру.

Отдельно ставить ADB не нужно: он входит в комплект Lusiesta Studio и лежит рядом с приложением. Служба поднимается автоматически при запуске программы. Первый запуск после перезагрузки компьютера может занять несколько секунд - в это время на «Главной» показывается карточка «Ищем ADB-устройства» с подписью «Первый запуск ADB после перезагрузки может занять несколько секунд.».

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

1. Включите на телефоне режим разработчика и «Отладка по USB». Без этого дальше идти бессмысленно: телефон не появится в списке вообще. Как включить по вендорам - в статье Режим разработчика и USB-отладка.
2. Разблокируйте экран телефона и держите его включённым.
3. Подключите телефон к компьютеру кабелем, который умеет передавать данные, а не только заряжать.
4. На экране телефона появится окно «Разрешить отладку по USB?» с отпечатком ключа компьютера. Отметьте «Всегда разрешать с этого компьютера» и нажмите «Разрешить».
5. Подождите несколько секунд: список устройств в приложении обновляется сам, вручную ничего перезапускать не нужно.

Окно «Разрешить отладку по USB?»

Это окно - защита Android. Телефон запоминает ключ конкретного компьютера, поэтому подтверждение нужно один раз на пару «телефон плюс ПК». Галочка «Всегда разрешать с этого компьютера» как раз и сохраняет ключ: без неё запрос будет всплывать при каждом переподключении и посреди задачи, а любая задача в этот момент упрётся в системное окно.

Запрос появится снова, если вы переустановили Windows, сбросили телефон к заводским настройкам или нажали в разделе разработчика «Отозвать доступ для USB-отладки». Ничего страшного: просто подтвердите повторно.

Никогда не жмите «Отклонить» на телефонах фермы. После отказа аппарат остаётся видимым для ADB, но в состоянии unauthorized, и приложение не сможет ни снять картинку, ни выполнить задачу, пока вы не переподключите кабель и не подтвердите запрос.

Как выглядит успешное подключение

Когда всё сложилось, в приложении на «Главной» вместо пустого состояния появляется плитка устройства:

• в шапке плитки - номер устройства и его серийный номер;
• в теле плитки - живое видео экрана телефона; пока картинка поднимается, видно «Загрузка превью» со спиннером;
• кликом и перетаскиванием мышью прямо по превью можно тапать и свайпать по телефону;
• в режиме списка у устройства в колонке «ПОДКЛЮЧЕНИЕ» стоит «USB».

Номер устройства стабильный: «Номер 3» - это один и тот же телефон и в сетке, и в публикации, и в прогреве. Если картинка так и не появилась, а само устройство при этом видно, это отдельная история - её разбирает статья про пустые плитки без превью.

Режим USB: передача файлов или только зарядка

Android умеет подключаться к компьютеру в разных режимах. Часть прошивок по умолчанию встаёт в режим «Только зарядка», и тогда телефон либо не виден, либо ведёт себя нестабильно.

1. Опустите шторку уведомлений на телефоне и найдите уведомление про USB-подключение.
2. Нажмите на него и выберите «Передача файлов» (MTP). Вариант «Только зарядка» снимите.
3. Чтобы не делать это каждый раз, в разделе разработчика выставьте «Конфигурация USB по умолчанию» -> «Передача файлов».

Если окно с запросом не появилось

• Экран телефона заблокирован: окно показывается только на разблокированном экране. Разблокируйте и переткните кабель.
• Отладка по USB выключена: без неё запроса не будет никогда, телефон просто не увидят.
• Кабель без данных или разбитый разъём: смените кабель и порт, лучше подключите напрямую к компьютеру, а не через хаб. Дешёвые кабели без жил данных - классическая причина «телефон заряжается, но его не видно».
• Компьютер уже был подтверждён раньше: тогда окна и не должно быть, устройство появится сразу.
• Доступ был ранее отклонён: в разделе разработчика нажмите «Отозвать доступ для USB-отладки», затем переподключите кабель - запрос придёт заново.
• На Windows иногда нужен USB-драйвер производителя (Xiaomi, Samsung и т. д.).

Что значат unauthorized, offline и no permissions

Это состояния самого ADB, приложение показывает их человеческим языком. Если устройство видно, но не работает, на «Главной» под пустым состоянием появляется жёлтая плашка вида «Найден телефон Redmi Note 10: ...», а на плитке офлайн-устройства - короткая подсказка:

• unauthorized - кабель есть, но на телефоне не нажали «Разрешить отладку с этого компьютера». Подсказка на плитке: «Подтверди «Отладку по USB» на телефоне». Лечится подтверждением запроса на экране.
• offline - телефон в списке, но не отвечает на команды. Подсказка: «Переподключи кабель или USB-порт». Обычно это плохой контакт, уснувший USB-порт или зависший ADB после смены кабеля.
• no permissions - нет прав на USB-устройство: вопрос драйвера или прав в системе. Подсказка: «Нет доступа к USB - переподключи кабель».
• recovery или sideload - телефон загружен не в обычном режиме, ADB для работы недоступен. Перезагрузите аппарат в систему.

Короткий обрыв связи приложение переживает спокойно: недавно живое устройство несколько секунд показывается как онлайн, пока идёт переподключение, и обычно возвращается само.

Что делать дальше

Телефон подключён и виден - до первой задачи остался один шаг: подготовить сам аппарат, чтобы сценарии не спотыкались о блокировку экрана и системные окна. Об этом статья Настройка телефона перед работой. Если устройство упорно не появляется, разбор частых случаев собран в статье Устройство не подключается или не видно.