Освойте отладку Android: от ADB до Android Studio

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

Отладка — ключевой этап разработки Android-приложений. Без эффективного использования инструментов отладки поиск и исправление ошибок превращаются в хаотичный процесс, отнимающий часы. Это руководство даст вам системное понимание основных инструментов: ADB, Logcat и встроенного отладчика Android Studio. Вы сможете быстро находить причины падений, анализировать поток данных и тестировать код в реальных условиях на устройстве.

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

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

1. Android Studio (версия Arctic Fox 2020.3.1 или новее) с компонентами Android SDK и Android SDK Platform-Tools.
2. Устройство на Android (версии 5.0 и выше) с включенной опцией "Отладка по USB" (находится в Настройки → Параметры разработчика).
3. USB-кабель (желательно качественный, поддерживающий передачу данных).
4. Для Windows: установленные драйверы USB для вашего устройства. Для Linux: настроенные udev-правила.
5. Базовые знания работы с терминалом/командной строкой.

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

На самом устройстве необходимо активировать режим разработчика и разрешить отладку.

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

⚠️ Важно: При первом подключении устройства к компьютеру на экране появится диалоговое окно с запросом "Разрешить отладку по USB?". Обязательно поставьте галочку "Всегда разрешать с этого компьютера" и нажмите "OK".

Шаг 2: Подготовьте компьютер: установите драйверы/правила

Без правильных драйверов компьютер не увидит устройство.

Для Windows:

1. Скачайте драйверы:
   • Универсальные: Google USB Driver (через менеджер SDK Android Studio).
   • Производительские: Драйверы с сайта Samsung (Kies), Xiaomi (Mi PC Suite), Huawei и т.д.
2. Установите драйвер через Диспетчер устройств (Win + R → devmgmt.msc).
3. Найдите неизвестное устройство (обычно с желтым восклицательным знаком) в разделе "Другие устройства" или "Android Device".
4. Щелкните правой кнопкой → "Обновить драйвер" → "Выполнить поиск драйверов на этом компьютере" → укажите папку с распакованным драйвером.

Для Linux (Ubuntu/Debian):

1. Создайте файл правил:

   sudo gedit /etc/udev/rules.d/51-android.rules
   

2. Вставьте правила для вашего производителя. Например, для общих устройств Google:

   SUBSYSTEM=="usb", ATTR{idVendor}=="0bb4", MODE="0666", GROUP="plugdev"
   

   Полный список vendor ID: https://developer.android.com/studio/run/linux-usb
3. Установите права и перезагрузите udev:

   sudo chmod a+r /etc/udev/rules.d/51-android.rules
   sudo udevadm control --reload-rules
   sudo udevadm trigger
   

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

Теперь нужно убедиться, что связь установлена.

1. Откройте терминал (Linux/macOS) или Command Prompt/PowerShell (Windows).
2. Перейдите в папку с платформ-тулз (обычно ~/Library/Android/sdk/platform-tools/ на macOS или C:\Users\<User>\AppData\Local\Android\Sdk\platform-tools\ на Windows) или добавьте её в PATH.
3. Выполните команду:

   adb devices
   

4. Ожидаемый вывод:

   List of devices attached
   0123456789ABCDEF    device
   

   Если вместо device стоит unauthorized, проверьте диалог на устройстве. Если устройство не отображается — вернитесь к шагу 2.

Шаг 4: Настройте проект в Android Studio

1. Откройте ваш проект в Android Studio.
2. Убедитесь, что в файле build.gradle (уровня модуля) указана актуальная версия compileSdk и minSdk.
3. На панели инструментов вверху справа найдите выпадающий список "Select Deployment Target".
4. В открывшемся окне ваше устройство должно отобразиться в разделе "Connected Devices". Выберите его и нажмите "OK".
5. Для отладки нажмите кнопку "Debug" (иконка жука). Приложение установится и запустится в режиме отладки.

Шаг 5: Используйте Logcat для анализа логов

Logcat — ваш главный источник информации о том, что происходит в системе и приложении.

1. В Android Studio откройте View → Tool Windows → Logcat.
2. В верхней части окна Logcat выберите:
   • Устройство: ваше подключенное устройство.
   • Процесс: процесс вашего приложения (обычно com.example.yourapp). Можно выбрать <your_package_name> или No Filters для всех.
   • Уровень логирования: установите Debug или Verbose для максимальной детализации, Error для только ошибок.
3. Чтобы быстро найти логи вашего приложения, используйте фильтр:
   • По тегу (Tag): введите tag:MyAppTag (если в коде вы используете конкретный тег).
   • По пакету: введите package:com.example.yourapp.
4. Ищите строки с E/ (Error), W/ (Warn) или AndroidRuntime (для необработанных исключений). Нажмите на строку с ошибкой — Android Studio перейдет в соответствующую строку кода (если исходники доступны).

Шаг 6: Запустите приложение в режиме отладки

Это основной способ пошагового анализа.

1. В редакторе кода установите точки останова (breakpoints): кликните на сером поле слева от номера строки, где хотите остановить выполнение (появится красный кружок).
2. Нажмите кнопку "Debug" (жучок) на панели инструментов.
3. Приложение запустится на устройстве. Как только выполнение дойдет до точки останова, оно приостановится.
4. На нижней панели появится окно отладчика:
   • Frames: стек вызовов.
   • Variables: текущие значения переменных в контексте.
   • Watches: добавьте выражение для отслеживания.
5. Используйте кнопки управления выполнением:
   • Resume (F9): продолжить до следующей точки останова.
   • Step Over (F8): выполнить текущую строку и перейти к следующей.
   • Step Into (F7): войти в метод, вызванный на текущей строке.
   • Step Out (Shift+F8): выйти из текущего метода.
6. Вы можете изменять значения переменных прямо в отладчике для тестирования разных сценариев.

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

После выполнения шагов вы должны:

1. Видеть свое устройство в списке adb devices.
2. Успешно запускать приложение на устройстве из Android Studio.
3. Видеть логи своего приложения в Logcat, отфильтрованные по пакету.
4. При постановке точек останова — приостанавливать выполнение кода и изучать состояние переменных.

Если все пункты выполняются — среда отладки настроена корректно.

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

Проблема: Устройство не отображается в adb devices или в Android Studio.

Решение:

• Переподключите USB-кабель, попробуйте другой порт.
• На устройстве откройте Настройки → Параметры разработчика и выключите/включите "Отладка по USB".
• Перезагрузите adb сервер:

  adb kill-server
  adb start-server
  adb devices
  

• Для Windows: проверьте в Диспетчере устройств, что устройство определяется как "Android Composite ADB Interface" без ошибок. Обновите драйвер вручную.

Проблема: В Logcat нет логов моего приложения.

Решение:

• Убедитесь, что в коде вы используете Log.d(tag, message) или аналоги, а не System.out.println.
• Проверьте фильтр Logcat: установите уровень на Debug или Verbose, попробуйте сбросить фильтр (No Filters).
• Убедитесь, что приложение запущено именно на том устройстве, которое выбрано в Logcat.
• На некоторых устройствах (особенно с MIUI) нужно дополнительно включить "Включить отладку по USB (настройки безопасности)" в Параметрах разработчика.

Проблема: Точки останова игнорируются, приложение не останавливается.

Решение:

• Убедитесь, что вы запустили приложение не через "Run", а через "Debug" (кнопка с жучком).
• Проверьте, что точка останова активирована (красный кружок, а не серый с обводкой). Серый означает, что код не будет загружен (например, точка в неиспользуемом классе).
• Очистите проект (Build → Clean Project) и перезапустите отладку.
• Если приложение уже запущено, остановите его полностью и запустите заново в режиме отладки.