LADB не подключается к беспроводной отладке и выдаёт ошибку сопряжения — чаще всего причина в неверном порте: Android при каждом включении беспроводной отладки генерирует новый порт, и старые данные из прошлого сеанса уже недействительны. Это первое, что нужно проверить, прежде чем искать другие причины.
LADB (Local ADB) — это приложение для Android, которое запускает ADB-оболочку прямо на устройстве, без компьютера и USB-кабеля. Оно использует функцию беспроводной отладки, появившуюся в Android 11, и позволяет выполнять команды adb shell локально: удалять предустановленные приложения, выдавать разрешения, менять системные настройки. В этой статье разберём установку, сопряжение, полезные команды и решение типичных проблем.
Что такое LADB и как это работает
Приложение LADB объединяет в себе ADB-сервер и клиент в одном APK. Когда вы включаете беспроводную отладку в настройках разработчика, система открывает локальный порт, через который LADB подключается к собственному устройству — по сути, смартфон «отлаживает сам себя» через loopback-соединение.
Важно понимать ограничение: LADB работает только на Android 11 и новее, потому что именно в этой версии появилась штатная беспроводная отладка с сопряжением по коду. На более старых версиях Android локальный ADB без root и компьютера невозможен — система попросту не предоставляет нужный интерфейс.
- 📱 Не требует root-доступа и разблокированного загрузчика
- 🔌 Не нужен компьютер после первичной настройки
- 🧩 Работает через штатную функцию беспроводной отладки
- 💾 Сохраняет сессию, пока не перезагружено устройство
Установка и первичная настройка
Приложение распространяется как платное в Google Play, но его исходный код открыт и опубликован на GitHub — там можно собрать APK самостоятельно. После установки никаких дополнительных компонентов скачивать не нужно: ADB-бинарники уже встроены в приложение.
Прежде чем запускать LADB, необходимо активировать режим разработчика. Для этого откройте Настройки → О телефоне и несколько раз нажмите на пункт Номер сборки, пока система не подтвердит включение режима. Точный путь может отличаться в зависимости от оболочки производителя — сверьтесь с документацией вашей модели.
Сопряжение LADB с беспроводной отладкой
Это самый ответственный этап, на котором возникает большинство ошибок. Порядок действий следующий: включите беспроводную отладку в параметрах разработчика, затем откройте пункт Сопряжение устройства с кодом сопряжения. Система покажет IP-адрес, порт и шестизначный код.
Введите эти данные в диалоговое окно LADB. Обратите внимание: порт сопряжения и порт подключения — это разные порты. Сначала выполняется сопряжение по коду, после чего LADB подключается к порту, указанному на главном экране беспроводной отладки. Приложение обычно обрабатывает оба шага автоматически, но понимать различие полезно при ручной диагностике.
☑️ Сопряжение LADB шаг за шагом
⚠️ Внимание: код сопряжения действует ограниченное время, а порт меняется при каждом новом включении беспроводной отладки и после перезагрузки. Если сопряжение не удалось с первого раза — запросите новый код и повторите, не используя старые данные.
Полезные команды ADB shell в LADB
После успешного подключения вы попадаете в привычную оболочку adb shell с правами, которые система выдаёт ADB. Этого достаточно для большинства задач тонкой настройки, но не для действий, требующих root.
pm list packages
pm uninstall -k --user 0 com.example.bloatware
settings put global window_animation_scale 0.5
Первая команда выводит список установленных пакетов, вторая — «удаляет» приложение для текущего пользователя (фактически отключает его, системные файлы остаются), третья ускоряет анимации интерфейса. Перед удалением любого системного пакета убедитесь, что он не критичен для работы оболочки — последствия зависят от конкретной прошивки.
Типичные ошибки и их решение
Ошибка connection refused обычно означает, что беспроводная отладка выключилась — некоторые оболочки отключают её при блокировке экрана или разрыве Wi-Fi. Проверьте, что переключатель активен, и повторите подключение с актуальным портом.
Если LADB «зависает» на этапе сопряжения, возможная причина — конфликт с функцией случайного MAC-адреса Wi-Fi или с VPN, который перехватывает локальный трафик. Попробуйте временно отключить VPN и повторить попытку. Точное поведение зависит от прошивки, поэтому при неудаче проверьте также, не блокирует ли системный «экономии трафика» фоновую активность приложения.
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| Connection refused | Беспроводная отладка отключена | Переключатель в настройках разработчика |
| Pairing failed | Истёк или неверен код сопряжения | Запросить новый код, ввести заново |
| Неверный порт | Порт сменился после перезапуска | Актуальный порт на экране отладки |
| Shell закрывается | Система выгрузила приложение | Отключить оптимизацию батареи для LADB |
Почему сессия слетает после перезагрузки
Беспроводная отладка в Android по умолчанию отключается при перезагрузке устройства, а порт генерируется заново. Это штатное поведение системы безопасности, а не ошибка LADB — после каждой перезагрузки сопряжение нужно проходить повторно.
⚠️ Внимание: команды pm uninstall для системных пакетов необратимы до сброса настроек или обновления прошивки. Удаление критичных компонентов оболочки (например, системного лаунчера) может сделать устройство неудобным или неработоспособным. Действуйте только с пакетами, назначение которых вам точно известно.
Безопасность и ограничения
LADB не даёт прав root и не обходит защиту системы — он работает строго в рамках разрешений, которые Android выделяет ADB. Это одновременно и плюс (сложнее что-то сломать), и ограничение: часть команд, доступных на рутированных устройствах, выполнить не получится.
Не держите беспроводную отладку включённой постоянно без необходимости. Хотя подключение требует сопряжения, открытый отладочный интерфейс в публичных Wi-Fi-сетях — лишняя поверхность для атаки. Включайте функцию на время работы с LADB и выключайте после.
Часто задаваемые вопросы
Работает ли LADB на Android 10 и ниже?
Нет. Приложение опирается на функцию беспроводной отладки, которая появилась только в Android 11. На более ранних версиях локальный ADB без root и первичной настройки через компьютер недоступен.
Нужен ли root для LADB?
Нет, root не требуется. Приложение использует штатный механизм беспроводной отладки и получает стандартные права ADB-пользователя.
Почему порт меняется каждый раз?
Это штатное поведение Android: при каждом включении беспроводной отладки система назначает новый случайный порт. Поэтому сохранённые данные прошлых сеансов не работают — всегда берите актуальные значения с экрана настроек.
Можно ли вернуть удалённое через pm uninstall приложение?
Да, если пакет удалён только для текущего пользователя (флаг --user 0). Команда cmd package install-existing имя_пакета восстанавливает его. Полный сброс настроек также возвращает все системные приложения.
LADB не видит диалог сопряжения — что делать?
Убедитесь, что вы открыли именно пункт «Сопряжение устройства с кодом», а не основной экран беспроводной отладки. Попробуйте выключить и заново включить функцию, перезапустить LADB и временно отключить VPN.