Полный гайд по ADB: от скачивания до практических команд
Кратко: ADB (Android Debug Bridge) — консольный инструмент для управления Android‑устройством: установка APK, удалённая оболочка, копирование файлов, просмотр логов и подключение по USB или Wi‑Fi. Ниже — где скачать Platform‑Tools, как установить и настроить ADB на Windows/macOS/Linux и набор рабочих команд с примерами.
Скачивание и установка Platform‑Tools
-
Скачайте официальный архив Platform‑Tools (в сборке только
adbиfastboot) и распакуйте в постоянную папку:- Windows:
C:\android\platform-tools\ - macOS / Linux:
~/android/platform-tools/или/opt/android/platform-tools/
- Windows:
-
Добавьте в PATH:
- Windows (PowerShell, для текущего пользователя): [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\android\platform-tools", "User")
- macOS / Linux (bash/zsh): добавьте в
~/.bashrc/~/.zshrc: export PATH="$HOME/android/platform-tools:$PATH"
-
Проверьте:
adb version— версияadb devices— список устройств
Используйте официальный Platform‑Tools: сторонние сборки могут быть устаревшими или небезопасными.
Настройка устройства и проверка соединения
- На устройстве включите "Параметры разработчика" → "USB‑отладка". При первом подключении по USB подтвердите запрос RSA‑ключа.
- Windows: при необходимости установите OEM‑драйвер или Google USB Driver и обновите драйвер в Диспетчере устройств.
- Linux: добавьте udev‑правила (
/etc/udev/rules.d/51-android.rules) с VID устройства и перезапустите udev, чтобы работать без root. - Быстрая диагностика:
adb devices— пустой список (не обнаружено),unauthorized(подтвердите на устройстве),device(готово).- При проблемах:
adb kill-server && adb start-server, смените USB‑порт/кабель.
Не используйте непроверённые драйверы на Windows — это риск стабильности и безопасности системы.
Основные команды и практические сценарии
Ниже — набор команд, которые реально пригодятся в повседневной работе.
Таблица основных команд ADB
| Команда | Что делает | Пример |
|---|---|---|
adb devices | Показывает подключённые устройства | adb devices |
adb version | Версия adb | adb version |
adb install <apk> | Установка APK | adb install myapp.apk |
adb install -r <apk> | Переустановка с сохранением данных | adb install -r myapp.apk |
adb uninstall <pkg> | Удаление пакета | adb uninstall com.example.app |
adb push <local> <remote> | Копирование на устройство | adb push file.txt /sdcard/Download/ |
adb pull <remote> [local] | Копирование с устройства | adb pull /sdcard/log.txt ./ |
adb shell | Открыть shell на устройстве | adb shell |
adb shell <cmd> | Выполнить команду | adb shell pm list packages -3 |
adb logcat | Просмотр логов | adb logcat *:E |
adb reboot | Перезагрузка устройства | adb reboot |
adb reboot bootloader | Войти в bootloader/fastboot | adb reboot bootloader |
adb sideload <file.zip> | Установка OTA в режиме sideload | adb sideload update.zip |
adb tcpip <port> / adb connect <ip>:<port> | Подключение по сети | adb tcpip 5555 → adb connect 192.168.0.10:5555 |
Практические сценарии:
- Установка и перезапись:
adb install -r app.apk - Сохранение логов:
adb logcat -d > log.txt - Фильтрация логов:
adb logcat MyAppTag:D *:S - Подключение по Wi‑Fi: подключить по USB,
adb tcpip 5555, затемadb connect <ip>:5555. На новых Android есть "Wireless debugging" с парой через PIN/QR.
Для удалённого управления экрана используйте scrcpy — работает через ADB и даёт мгновенный просмотр/управление экраном.
Частые ошибки
- adb not found — PATH не добавлен или выбран неверный каталог.
- unauthorized — не подтверждён RSA‑запрос на устройстве или экран заблокирован.
- no permissions на Linux — отсутствуют/неприменены udev‑правила.
- Windows видит устройство как MTP — обновите драйвер вручную через Диспетчер устройств.
FAQ
- Нужно ли Android Studio? Нет — достаточно Platform‑Tools; Android Studio удобна при разработке, но не обязательна.
- Безопасно ли включать USB‑отладку? Для разработки — да, но не оставляйте включённой на чужих/публичных устройствах.
- Что делать при конфликте с другим adb? Закройте все процессы, используйте
adb kill-serverи убедитесь, что в PATH только одинadb.
Если нужно — подготовлю короткий чеклист для вашей ОС или набор .sh/.bat скриптов для распространённых задач.