ADB отладка на Android: пошаговая настройка и использование

Введение

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

Требования

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

• Компьютер с Windows, Linux или macOS.
• USB-кабель, поддерживающий передачу данных (не только зарядку).
• Android-устройство (версии 5.0 и выше).
• Доступ к интернету для загрузки инструментов.

Шаг 1: Установка Android SDK Platform-Tools

ADB входит в состав пакета Platform-Tools от Android SDK. Скачайте его с официального сайта:

1. Перейдите на страницу SDK Platform-Tools.
2. Выберите версию для вашей операционной системы (Windows, Linux, macOS).
3. Распакуйте архив в удобную папку, например, C:\platform-tools (Windows) или ~/platform-tools (Linux/macOS).
4. Добавьте путь к этой папке в системную переменную PATH:
   • Windows:
     Откройте "Система" → "Дополнительные параметры системы" → "Переменные среды". В разделе "Системные переменные" найдите Path, добавьте путь C:\platform-tools.
   • Linux/macOS:
     Добавьте строку export PATH=$PATH:~/platform-tools в файл ~/.bashrc или ~/.zshrc, затем выполните source ~/.bashrc (или source ~/.zshrc).
5. Проверьте установку, открыв новое окно терминала/командной строки и выполнив:

   adb version
   

   Вы должны увидеть номер версии ADB.

⚠️ Важно для Windows: Вам могут понадобиться драйверы USB для вашего устройства. Их можно найти на сайте производителя или использовать драйверы Google USB Driver (через Android SDK Manager). Если устройство не определяется, установите драйверы вручную через Диспетчер устройств.

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

По умолчанию опция отладки по USB скрыта. Чтобы её активировать:

1. Откройте Настройки → О телефоне (или Об устройстве).
2. Найдите пункт Номер сборки (Build Number) и нажмите на него 7 раз. Вы увидите сообщение "Вы стали разработчиком!".
3. Вернитесь в главное меню настроек. Теперь доступен пункт Для разработчиков (Developer options).
4. В Для разработчиков найдите и включите Отладка по USB (USB debugging).
5. (Опционально) Включите Авторизация USB-отладки (Revoke USB debugging authorizations) и затем снова отключите/включите отладку, чтобы сбросить старые авторизации.

Шаг 3: Подключение устройства и авторизация

1. Соедините устройство с компьютером с помощью USB-кабеля.
2. На устройстве появится диалоговое окно с запросом Разрешить отладку по USB?. Поставьте галочку Всегда разрешать с этого компьютера и нажмите OK.
3. Если запрос не появился, попробуйте переключить режим USB-подключения на Передача файлов (MTP) или PTP (в уведомлении о подключении USB).

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

Откройте терминал или командную строку и выполните:

adb devices

Вывод будет выглядеть примерно так:

List of devices attached
XXXXXXXXXXXX    device

Если ваше устройство отображается со статусом device, подключение установлено успешно.

Возможные статусы:

• unauthorized — вы не подтвердили авторизацию на устройстве. Проверьте диалог на телефоне.
• offline — устройство не отвечает. Попробуйте переподключить кабель или перезагрузить устройство.
• Ничего не выводится — устройство не обнаружено. Проверьте кабель, драйверы (Windows) и включенную отладку.

Шаг 5: Базовые команды ADB

Теперь вы можете выполнять полезные команды. Вот несколько примеров:

• Запуск оболочки устройства:

  adb shell
  

  
  После ввода вы окажетесь в командной строке устройства (как в Terminal на Android). Для выхода нажмите Ctrl+D или введите exit.
• Установка APK-файла:

  adb install путь/к/файлу.apk
  

  
  Добавьте флаг -r для переустановки с сохранением данных: adb install -r app.apk.
• Копирование файла с устройства на компьютер:

  adb pull /sdcard/файл.txt ./
  

• Копирование файла с компьютера на устройство:

  adb push файл.txt /sdcard/
  

• Просмотр логов (logcat):

  adb logcat
  

  
  Чтобы фильтровать логи вашего приложения, используйте adb logcat | grep "ВашеПриложение".
• Перезагрузка устройства:

  adb reboot
  

• Получение информации об устройстве:

  adb shell getprop ro.product.model   # модель
  adb shell getprop ro.build.version.release   # версия Android
  

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

После выполнения шагов вы должны успешно подключаться к устройству и выполнять команды. Проверьте, что команда adb devices показывает ваше устройство, а базовые операции (например, adb shell или adb install) работают без ошибок. Если все работает — вы готовы к отладке!

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

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

• Отладка по USB отключена. Вернитесь к шагу 2 и убедитесь, что опция включена.
• Нет авторизации. На устройстве должно быть подтверждение. Если вы нажали "Отклонить", откройте настройки разработчика и сбросьте авторизацию (пункт "Отозвать авторизацию USB-отладки"), затем переподключите.
• Проблемы с кабелем. Используйте оригинальный кабель, поддерживающий данные. Попробуйте другой USB-порт.
• Драйверы на Windows. Установите драйверы для вашего устройства. Для Google-устройств подходит Google USB Driver, для других — драйверы с сайта производителя.
• Конфликт с другим ПО. Программы вроде Samsung Kies, HTC Sync или Mi PC Suite могут перехватывать соединение. Закройте их.

Ошибка "error: device offline"

• Перезагрузите устройство и компьютер.
• Отключите и снова включите отладку по USB на устройстве.
• На Windows: попробуйте установить драйверы вручную через Диспетчер устройств (выберите "Android ADB Interface").

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

• Убедитесь, что adb запущен от имени администратора (на Windows) или с правами sudo (на Linux/macOS), если требуется доступ к USB-устройству.
• Проверьте, что в системе нет других экземпляров ADB (например, от Android Studio). Завершите их через Диспетчер задач.

ADB работает, но команды в adb shell не выполняются

• Некоторые команды требуют root-доступа. Получите root (если устройство рутировано) или ищите альтернативы через ADB без root.
• Для доступа к защищенным системным файлам используйте adb remount (требует root) или adb shell su -c "команда".

Медленная передача файлов

• Используйте adb pull/adb push вместо adb shell cp для больших файлов.
• Проверьте скорость USB-порта (USB 2.0 vs 3.0) и кабель.

Если проблема не решена, поищите конкретную ошибку в нашей базе знаний или на форумах разработчиков Android.