Введение
ADB (Android Debug Bridge) — это универсальный инструмент, который позволяет подключаться к Android-устройствам, запускать команды, устанавливать приложения и анализировать системные логи. Знание базового набора команд значительно ускоряет работу с устройствами в процессе разработки, тестирования или устранения неполадок. После выполнения этого гайда вы сможете быстро выполнять основные операции и освоите весь необходимый список команд.
Требования
- Операционная система: Windows, macOS или Linux.
- Android SDK Platform Tools (включает
adb) установлен и добавлен в системный PATH. - Android-устройство (смартфон или планшет) с включёнными возможностями разработчика.
- USB-кабель для передачи данных (не зарядное устройство).
Пошаговая инструкция
Шаг 1: Установите Android SDK Platform Tools
Скачайте установщик с официального сайта:
# Пример команды для скачивания (замените на нужную версию)
wget https://dl.google.com/android/repository/platform-tools-latest-{os}-x64.zip
Распакуйте архив, перейдите в папку platform-tools и выполните adb, чтобы проверить, что команда распознана.
Шаг 2: Включите отладку по USB
- На устройстве откройте Настройки → О телефоне.
- 7 раз тапните по строке Номер сборки — это активирует меню разработчика.
- Вернитесь в Настройки → Система → Дополнительно → Варианты разработчика.
- Найдите Отладка USB и включите её. Подтвердите разрешение на компьютере.
Шаг 3: Подключите устройство
Подключите смартфон к компьютеру USB-кабелем. На компьютере откройте терминал, выполните:
adb devices
В списке устройств должен появиться серийный номер вашего девайса (например, 12345678). Если устройство не отображается, проверьте драйверы и кабель.
Шаг 4: Проверьте подключение ADB
Запустите общую справку ADB, чтобы увидеть весь список команд:
adb
Также можно напрямую запросить список команд:
adb help
В обоих случаях выводится полный перечень команд с кратким описанием.
Шаг 5: Изучите базовый набор команд
| Команда | Назначение | Пример использования |
|---|---|---|
adb shell | Запустить оболочку устройства | adb shell ls /sdcard |
adb install <apk> | Установить APK | adb install app.apk |
adb uninstall <pkg> | Удалить приложение | adb uninstall com.example.app |
adb push <local> <remote> | Скопировать файл на устройство | adb push photo.jpg /sdcard/Pictures |
adb pull <remote> <local> | Скопировать файл с устройства | adb pull /sdcard/Pictures/photo.jpg . |
adb logcat | Вывести системные логи | adb logcat -s ActivityManager |
adb reboot | Перезагрузить устройство | adb reboot recovery |
adb tcpip 5555 | Запустить ADB по Wi‑Fi | adb connect 192.168.1.10:5555 |
adb devices -l | Подробный список подключённых устройств | adb devices -l |
Эти команды покрывают большинство повседневных задач: установку, удаление, копирование файлов, просмотр логов и удалённое управление устройством.
Проверка результата
После выполнения шагов убедитесь, что ADB работает корректно:
adb shell pwd # показывает текущую директорию на устройстве
adb shell ls /sdcard # перечисляет файлы на SD‑карте
Если команды возвращают ожидаемые результаты, ADB настроен успешно.
Возможные проблемы
- Устройство не отображается в
adb devices- Используйте другой USB‑кабель (зарядные часто не передают данные).
- Убедитесь, что драйверы USB‑OTG/ADB установлены (на Windows может потребоваться драйвер Google).
- Перезапустите ADB:
adb kill-server && adb start-server.
- Отладка по USB не активируется
- Убедитесь, что в настройках разработчика Отладка USB включена и устройство подключено.
- Перезагрузите устройство и повторите подключение.
- Команды ADB не найдены
- Проверьте, что
adbнаходится в системном PATH (echo $PATH). - Если нет, добавьте путь к
platform-toolsв переменную окружения.
- Проверьте, что
Следуя этим рекомендациям, вы сможете быстро устранить наиболее распространённые ошибки и продолжить эффективную работу с ADB.