Устройство не подключается или не видно

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

Что вы видите в программе

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

Если ничего не нашлось, заголовок меняется на «ADB-устройства не найдены», а ниже появляется кнопка «Как подключить телефон». Если же компьютер телефон видит, но работать с ним нельзя, дополнительно показывается жёлтая плашка вида «Найден телефон Redmi 9A: кабель есть, но на телефоне не нажали «Разрешить отладку с этого компьютера»». Эта плашка - самая полезная подсказка на экране: в ней названы и модель, и конкретная причина.

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

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

• Samsung: Настройки → Сведения о телефоне → Сведения о ПО → 7 нажатий на «Номер сборки»;
• Xiaomi, Redmi, POCO: Настройки → О телефоне → 7 нажатий на «Версия MIUI» (или «Версия HyperOS»);
• остальные: Настройки → О телефоне → 7 нажатий на «Номер сборки».

После этого в настройках появится раздел «Для разработчиков» (у Samsung и Xiaomi он внутри «Дополнительные настройки» / «Расширенные настройки») - в нём включите «Отладка по USB». Подробный разбор с картой меню - в статье Режим разработчика и USB-отладка.

Чек-лист

• режим разработчика включён (шаг выше) - без него пункта отладки просто нет;
• USB-режим - «передача данных», а не «только зарядка»;
• USB-отладка включена, запрос на компьютере подтверждён («Всегда разрешать»);
• кабель целый, порт рабочий - попробуйте другой;
• на Windows установлен USB-драйвер производителя;
• хаб с внешним питанием, телефонам хватает тока;
• на Xiaomi включены «Установка через USB» и отладка в настройках безопасности;
• телефон разблокирован, а не стоит на экране блокировки с погашенным дисплеем.

Телефон подключён, но в программе его нет

Самый частый случай: компьютер телефон видит, а разрешение на отладку не выдано. На экране телефона появляется окно «Разрешить отладку по USB?» - его нужно подтвердить, отметив «Всегда разрешать с этого компьютера». Окно легко пропустить: оно исчезает при блокировке экрана. Разблокируйте телефон, переподключите кабель и подтвердите запрос. Если такие устройства есть, Lusiesta пишет об этом прямо на экране подключения.

Пока телефон в таком состоянии, он числится в списке ADB, но команды до него не доходят: в сетке будет плитка «Оффлайн» с подсказкой «Подтверди «Отладку по USB» на телефоне». Помогает и полный сброс доверия: в разделе «Для разработчиков» есть пункт отзыва разрешений отладки по USB - отзовите их, переподключите кабель и подтвердите запрос заново.

Что означают подсказки на плитке «Оффлайн»

Когда телефон уже был в сетке, но связь потерялась, под словом «Оффлайн» появляется короткая подсказка. Читайте её буквально:

• «Подтверди «Отладку по USB» на телефоне» - устройство в состоянии ожидания разрешения. Разблокируйте экран и нажмите «Разрешить»;
• «Нет доступа к USB - переподключи кабель» - системе не хватает прав на USB-устройство: чаще всего виноват драйвер, хаб или порт;
• «Переподключи кабель или USB-порт» - телефон числится в списке, но не отвечает на команды: он уснул, кабель полуотошёл или порт просел по питанию.

Особенности прошивок

Xiaomi, Redmi и POCO (MIUI / HyperOS)

На этих телефонах одной «Отладки по USB» недостаточно, в разделе «Для разработчиков» включите дополнительно:

• Отладка по USB (Настройки безопасности) - без неё команды не проходят;
• Установка через USB - иначе не ставятся приложения и агент;
• снимите «Проверку по USB» / оптимизацию MIUI, если она включена.

Для этих пунктов MIUI требует вход в Mi-аккаунт и активную SIM-карту с интернетом - это требование производителя. После включения переподключите кабель и заново подтвердите запрос отладки.

Samsung

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

Если выпадает под нагрузкой

Чаще всего это питание или дешёвый хаб. Lusiesta автоматически переподключает зависшие сессии и держит короткое окно ожидания после обрыва, чтобы кратковременный отвал не мигал статусом на весь экран, но физическую нехватку тока софт не починит. Признак именно этой проблемы: телефоны отваливаются пачками, когда одновременно идут задачи и живое видео.

• используйте хаб с собственным блоком питания, а не питание от порта ноутбука;
• не вешайте много телефонов на один хаб - разложите по разным контроллерам USB;
• смените кабели: тонкие зарядные шнуры дают обрывы данных даже при живой зарядке (см. USB-кабели: почему на них нельзя экономить);
• отключите на компьютере «отключение USB-устройств для экономии энергии» в параметрах питания.

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

Как проверить, что получилось

1. Откройте страницу «Главная» и подождите несколько секунд - список опрашивается автоматически.
2. Телефон должен появиться отдельной плиткой: номер в квадратном бейдже, серийный номер рядом.
3. Статус не «Оффлайн», в плитке идёт живое видео экрана. Если картинки нет, но устройство онлайн - это отдельная тема, см. Нет превью телефонов.
4. Проверьте отклик: кликните мышью по превью - тап должен пройти на телефон.

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

Если ничего не помогло

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