Подключение ADB через Wi-Fi на Android: подробное руководство

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

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

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

Перед началом убедитесь, что у вас есть:

• Устройство Android с версией 4.0 (Ice Cream Sandwich) или выше.
• Включенный режим разработчика и опция "Отладка по USB".
• Компьютер (Windows, macOS или Linux) с установленным Android SDK Platform-Tools (включая ADB).
• Оба устройства (Android и компьютер) подключены к одной Wi-Fi сети.
• Знание IP-адреса Android-устройства (можно узнать в настройках Wi-Fi).

⚠️ Важно: Первоначально устройство должно быть подключено по USB для активации TCP/IP режима. После настройки кабель можно отключать.

Шаг 1: Включение отладки по USB на устройстве

Если режим разработчика не активирован:

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

Если параметры разработчика уже доступны, просто включите отладку по USB.

💡 Совет: На некоторых устройствах опция может называться "USB-отладка".

Шаг 2: Подключение по USB и активация TCP/IP режима

1. Соедините Android-устройство с компьютером через USB-кабель.
2. На устройстве может появиться запрос на разрешение отладки по USB — нажмите OK и при необходимости отметьте "Всегда разрешать".
3. Откройте терминал (командную строку) на компьютере. Убедитесь, что ADB добавлен в PATH или перейдите в папку с platform-tools (например, C:\platform-tools на Windows или ~/Library/Android/sdk/platform-tools на macOS).
4. Выполните команду:

   adb devices
   

   В списке должно отобразиться ваше устройство. Если нет, проверьте драйверы (для Windows) или разрешение отладки.
5. Затем выполните:

   adb tcpip 5555
   

   Эта команда переключает ADB в режим прослушивания TCP-порта 5555. Вы увидите сообщение "restarting in TCP mode port: 5555".

После этого можно отключать USB-кабель.

Шаг 3: Определение IP-адреса устройства

Теперь нужно узнать IP-адрес вашего Android-устройства в Wi-Fi сети.

1. На устройстве откройте Настройки.
2. Перейдите в Wi-Fi (или Сеть и интернет → Wi-Fi).
3. Нажмите на подключенную сеть (с галочкой).
4. В открывшемся окне найдите поле IP-адрес. Обычно он выглядит как 192.168.x.x или 10.0.x.x.
5. Запишите этот адрес. Например: 192.168.1.105.

Альтернативно, можно использовать приложения вроде "Fing" для сканирования сети, но через настройки проще.

Шаг 4: Подключение по Wi-Fi

1. Убедитесь, что USB-кабель отключен.
2. В терминале на компьютере выполните команду:

   adb connect IP_адрес:5555
   

   Замените IP_адрес на адрес, который вы записали. Например:

   adb connect 192.168.1.105:5555
   

3. Если подключение успешно, вы увидите: "connected to IP_адрес:5555".

Шаг 5: Проверка подключения

Чтобы убедиться, что ADB теперь работает по Wi-Fi, выполните:

adb devices

В списке устройств должно отобразиться ваше устройство по IP-адресу, например:

192.168.1.105:5555   device

Вместо серийного номера будет IP-адрес.

Теперь вы можете выполнять ADB-команды, как обычно, например:

adb shell getprop ro.product.model

Эта команда выведет модель устройства.

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

После выполнения шагов, убедитесь, что:

• Команда adb devices показывает устройство с IP-адресом.
• Вы можете выполнять команды, такие как adb shell или adb install, без ошибок подключения.
• Устройство отвечает на запросы.

Если что-то не работает, перейдите к разделу "Возможные проблемы".

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

Ошибка: "error: device offline" или "no devices/emulators"

• Причина: Отладка по USB не была разрешена при первоначальном подключении, или ADB не переключен в TCP/IP режим.
• Решение: Повторите шаг 2, убедившись, что adb devices показывает устройство как "device" перед выполнением adb tcpip. Если нужно, перезагрузите ADB сервер: adb kill-server затем adb start-server.

Ошибка: "error: cannot connect to 192.168.1.105:5555"

• Причина: Неправильный IP-адрес, устройства в разных сетях, или порт 5555 заблокирован.
• Решение: Проверьте IP-адрес в настройках Wi-Fi устройства. Убедитесь, что компьютер и устройство подключены к одной роутеру. Проверьте, не блокирует ли фаервол на компьютере или роутере порт 5555. Попробуйте временно отключить фаервол.

После перезагрузки устройства подключение пропадает

• Причина: При перезагрузке Android-устройства ADB TCP/IP режим сбрасывается.
• Решение: После каждой перезагрузки устройства необходимо заново подключить его по USB и выполнить adb tcpip 5555, затем adb connect. Чтобы избежать этого, можно использовать root-доступ и автоматизацию, но для обычного использования это стандартное поведение.

Устройство не отображается в adb devices после adb connect

• Причина: Возможно, на устройстве не установлены необходимые сервисы или используется старая версия Android.
• Решение: Убедитесь, что у вас Android 4.0+. Попробуйте другой порт, например 5555 стандартный, но можно использовать другой: adb tcpip 8080 и затем adb connect IP:8080.

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

• Предупреждение: ADB по Wi-Fi передает данные без шифрования, поэтому не используйте его в публичных сетях. Всегда отключайте, когда не нужно: adb disconnect IP_адрес или отключите отладку по USB на устройстве.