ADB: настройка, команды и советы

Что такое ADB и зачем он нужен

Android Debug Bridge (ADB) — это низкоуровневый инструмент, который позволяет отправлять команды на Android‑устройство с компьютера. Простыми словами: ADB даёт доступ к файловой системе, позволяет устанавливать и удалять приложения, запускать шелл‑команды, отлаживать процессы и управлять устройством удалённо.

Краткое определение: ADB — клиент‑серверная система из трёх компонентов: клиент, демон (adbd) и сервер.

• Клиент: вы запускаете команды adb на компьютере. Клиент отправляет команды серверу.
• Демон (adbd): процесс на устройстве, который принимает команды от сервера по USB или TCP/IP.
• Сервер: фоновый процесс на компьютере, управляющий перечнем подключённых устройств и выдающий им состояние (online, offline, recovery и т. д.).

Когда вы запускаете команду adb, клиент проверяет, запущен ли сервер; если нет — сервер стартует и связывается с демоном устройства. На телефоне появится запрос доступа: его нужно подтвердить, чтобы установить доверенное соединение.

Important: ADB даёт мощные возможности. Используйте его осторожно — неправильные команды могут удалить данные или нарушить работу системы.

Ключевая модель работы (ментальная модель)

Представьте три роли:

• Вы (клиент) — отправляете инструкции.
• Сервер на ПК — диспетчер, который знает, какие устройства подключены.
• Демон на телефоне — исполнитель команд.

Связь: Клиент → Сервер → Демон. По умолчанию соединение запускается через USB. Для беспроводного режима используется TCP/IP и команды pair/connect.

Как установить ADB на компьютер

ADB входит в комплект Android SDK Platform Tools. Если вы не используете Android Studio, скачайте только Platform Tools с официальной страницы Android SDK Platform Tools и распакуйте в удобное местоположение.

Совет: используйте пакетный менеджер, чтобы автоматически обновлять Platform Tools и корректно настроить PATH или переменные окружения. На Windows можно использовать Chocolatey. На macOS — Homebrew.

Включение USB отладки на Android

1. Откройте «Настройки» → «О телефоне».
2. Нажмите 7 раз на «Номер сборки» (Build number). Появится сообщение, что вы стали разработчиком.
3. Вернитесь в «Настройки» → «Система» → «Дополнительно» → «Параметры для разработчиков» (Developer options).
4. Включите «USB‑отладку».

Note: USB‑отладка позволяет ПК запускать команды и читать данные. Если передаёте устройство другому человеку, отключайте эту опцию.

Настройка ADB на Windows

1. Скачайте ZIP с platform‑tools и распакуйте в папку, например C:\platform-tools.
2. Подключите устройство к ПК по USB и при необходимости выберите режим «Передача файлов» (File Transfer / MTP).
3. Откройте File Explorer, перейдите в папку platform‑tools, затем нажмите Shift + правый клик и выберите «Открыть окно PowerShell здесь».

В PowerShell выполните:

./adb devices

Примечание: в PowerShell перед командой часто требуется ./. В CMD это не нужно — можно просто написать adb devices.

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

Если устройство не отображается, проверьте драйверы и режим USB. У производителей могут быть собственные драйверы, которые нужно установить.

Настройка ADB на macOS

1. Распакуйте архив platform‑tools в удобную папку (Downloads или Desktop).
2. Подключите устройство по USB. Убедитесь, что выбран правильный режим USB.
3. Откройте Terminal и перейдите в папку platform‑tools:

cd /Users/[UserName]/Downloads/platform-tools

Выполните:

adb devices

Подтвердите запрос «Разрешить отладку по USB» на устройстве. Повторно выполните команду, чтобы увидеть серийный номер.

Совет: если macOS не показывает устройство, проверьте системные разрешения и кабель. Некоторые кабели поддерживают только зарядку.

Настройка ADB по Wi‑Fi (беспроводно)

Подключение по USB удобно, но ограничено кабелем. Беспроводное подключение решает проблему числа портов и неудобств с кабелем. Есть два подхода:

1. Классический: включить adb в режиме TCP/IP и подключиться к IP‑адресу устройства. Требует USB соединения для первичной настройки.
2. Новая функция (Android 11+ и platform tools v30+): «Wireless debugging» с парой по коду (pair). Это похоже на Bluetooth‑спаривание.

А. Классический способ:

1. Подключите устройство по USB.
2. Узнайте IP устройства в настройках Wi‑Fi.
3. Переведите ADB в TCP/IP режим:

adb tcpip 5555

4. Отключите USB. Затем подключитесь по IP:

adb connect :5555

5. Проверка:

adb devices

B. Способ с парой (Android 11+):

1. Откройте «Параметры для разработчиков» → «Wireless debugging» и включите.
2. Выберите «Pair device with pairing code» (спарить устройство по коду). Запишите код, IP и порт.
3. На компьютере выполните:

adb pair ipaddr:port

4. Введите код, когда запросит. После успешной пары выполните:

adb connect ipaddr:port

Important: беспроводное соединение менее безопасно в публичных сетях. Используйте его в доверенной локальной сети.

Полезные команды ADB — краткая справка

Ниже собраны часто используемые команды. В командах кавычки для наглядности — в терминале их можно опускать, если пути не содержат пробелов.

• adb devices — показать подключённые устройства.
• adb reboot — перезагрузить устройство.
• adb install — установить APK.
• adb uninstall — удалить приложение.
• adb pull — скопировать файл/папку с устройства на компьютер.
• adb push — скопировать файл/папку с компьютера на устройство.
• adb kill-server — завершить сервер ADB.
• adb start-server — запустить сервер ADB.
• adb help — показать справку.
• adb shell — открыть оболочку устройства.
• adb logcat — посмотреть логи системы и приложений.
• adb sideload — применить обновление в режиме recovery.

Примеры команд для работы с пакетами и компонентами приложений:

Список пакетов:

adb shell pm list packages

Параметры:

• -d — только отключённые пакеты.
• -e — только включённые пакеты.
• -s — только системные пакеты.

Удаление предустановленных приложений для текущего пользователя (без рута):

adb shell pm uninstall -k --user 0 

Это не удаляет APK из образа системы, но скрывает пакет для текущего пользователя (освобождает незначительное место и убирает приложение из лаунчера).

Просмотр компонентов приложения (активности, сервисы):

adb shell dumpsys package 

Ищите секции Activity Resolver Table и Service Resolver Table, чтобы увидеть доступные активности и сервисы.

Типичные сценарии использования и примеры

1. Скопировать фото с устройства на компьютер:

adb pull /sdcard/DCIM/Camera/IMG_1234.jpg ~/Pictures/

2. Установить приложение из APK:

adb install ~/Downloads/app.apk

3. Перезапустить процесс системного приложения:

adb shell am force-stop com.example.app
adb shell am start -n com.example.app/.MainActivity

4. Просмотр логов приложения (фильтрация по тегу):

adb logcat -s MyAppTag:V

Устранение неполадок — пошаговый план (runbook)

1. Проверка кабеля и порта: используйте оригинальный или качественный кабель.
2. Проверка режима USB: переключитесь на «Передача файлов» (MTP).
3. Выполните adb kill-server && adb start-server.
4. Проверьте, выдан ли доступ на устройстве (Allow USB debugging).
5. На Windows проверьте драйвер ADB (OEM‑драйвер или Google USB Driver).
6. Если устройство в статусе «unauthorized», удалите запись доверия на телефоне и повторно подключитесь.
7. Для беспроводного режима убедитесь, что ПК и телефон в одной подсети Wi‑Fi и что firewall не блокирует порт.

Критерии приёмки:

• Команда adb devices показывает серийный номер в статусе device или online.
• adb shell успешно открывает оболочку и выполняет простые команды (ls, ps).
• После установки приложения оно отображается в списке приложений.

Чек‑листы по ролям

Разработчик

• Включить USB‑отладку и оставить «Всегда разрешать» для рабочего ПК.
• Установить Android SDK Platform Tools и добавить в PATH.
• Проверить adb logcat для отладки исключений.

Power‑user (продвинутый пользователь)

• Сделать резервное копирование важных данных перед массовыми изменениями.
• Использовать adb shell pm uninstall только для приложений, которые можно восстановить.

IT‑администратор

• Ограничить доступ к USB‑отладке на корпоративных устройствах.
• Внедрить MDM и работу с налаженными профилями, а не вручную через ADB в массовом масштабе.

Когда ADB не подходит — альтернативы

• Используйте официальные инструменты разработки (Android Studio) для глубокого отладки и профилирования.
• Для массовой установки/удаления приложений в корпорациях используйте MDM/EMM‑решения.
• Для простого копирования файлов используйте MTP или облачные сервисы.

Безопасность и приватность

• Доступ по ADB позволяет считывать персональные данные. Никогда не разрешайте отладку на чужом компьютере.
• Отключайте USB‑отладку, когда она не нужна.
• Не храните постоянные скрипты с логинами/параметрами, если они дают доступ к устройствам других пользователей.

Риски и смягчения:

• Эксплойт уровня ADB: минимизируется отключением ADB и использованием защищённых сетей.
• Утечка данных при подключении к незнакомому ПК: не ставьте галочку «Всегда разрешать».

Пользовательский плейбук: подключение и откат изменений

Шаги при модификации устройства через ADB:

1. Создайте резервную копию важных папок: adb pull /sdcard/…
2. Снимите список установленных приложений: adb shell pm list packages > packages.txt
3. Выполните нужные изменения (uninstall, push, shell команды).
4. Тестируйте функциональность.
5. При проблеме — восстановите файлы и переустановите приложения, используя adb install или adb sideload.

Критерии отката:

• Приложение запускается и основные функции работают.
• Нет критических исключений в logcat.

Частые ошибки и их причины

• Устройство не отображается: проблема в кабеле, драйвере или авторизации.
• «device unauthorized»: не подтверждён ключ на телефоне.
• Подключение по Wi‑Fi не работает: телефон и ПК в разных подсетях или порт заблокирован.

Быстрый справочник команд (cheat sheet)

• adb devices
• adb shell
• adb install
• adb uninstall
• adb pull
• adb push
• adb logcat
• adb tcpip
• adb connect

Глоссарий — 1‑строчные определения

• adb: инструмент для связи ПК и Android‑устройства.
• adbd: демон на устройстве, принимающий команды.
• Platform Tools: набор утилит Android SDK, содержащий ADB.
• MTP: протокол передачи файлов по USB.

Часто задаваемые вопросы

Q: Нужно ли рутировать устройство для большинства команд ADB?

A: Нет. Многие команды работают без рута. Некоторые действия с системными файлами потребуют прав root.

Q: Безопасен ли ADB over Wi‑Fi?

A: В локальной защищённой сети — да; в публичной сети — рискованно. Используйте только в доверенной сети.

Q: Как отменить «uninstall –user 0»?

A: Команда скрывает пакет для пользователя. Чтобы вернуть, выполните adb shell cmd package install-existing (если APK всё ещё присутствует в системе).

Подведём итоги

• ADB — мощный инструмент для контроля Android‑устройств.
• Настройка простая: включите USB‑отладку, установите Platform Tools и подтвердите доступ.
• Используйте беспроводную отладку только в доверенных сетях.
• Имеется набор стандартных команд для установки, копирования, управления пакетами и получения логов.

Summary:

• Всегда делайте резервные копии перед критическими изменениями.
• Ограничивайте доступ к ADB на рабочих и корпоративных устройствах.
• Если что‑то не работает, начните с проверки кабеля и перезапуска adb server.

Дополнительные материалы и приложения для ADB вы можете найти в официальной документации Android и в популярных утилитах сообщества. После изучения команд и безопасного практического применения ADB вы получите гибкий инструмент для настройки и восстановления устройств.