Пошаговое решение ошибки adb not found в Android SDK

Что означает ошибка adb not found

Эта ошибка появляется, когда система не может найти исполняемый файл adb (Android Debug Bridge). Обычно она возникает в терминале при попытке выполнить команду adb devices, adb install или другую команду платформенных инструментов Android. Сообщение может звучать как adb: command not found или просто adb not found.

Причины возникновения

• Папка platform-tools отсутствует в переменной окружения PATH.
• SDK не установлен или версия платформенных инструментов устаревшая.
• Файл adb удален или поврежден в процессе обновления.
• Ошибки прав доступа к файлу adb (например, только для чтения).
• Использование старой версии терминала без перезагрузки окружения после изменений в PATH.

Способы решения

Способ 1: Проверка и добавление пути к platform-tools

Убедитесь, что файл adb существует в папке platform-tools внутри директории SDK. Затем добавьте путь к этой папке в переменную окружения PATH.

Пример для macOS:

export PATH=$PATH:/Users/username/Library/Android/sdk/platform-tools

Пример для Windows (в PowerShell):

$env:PATH += ";C:\Users\username\AppData\Local\Android\Sdk\platform-tools"

После изменения перезапустите терминал и проверьте командой adb version.

Способ 2: Переустановка platform-tools через sdkmanager

Используйте официальный менеджер пакетов Android для восстановления или установки нужной версии инструментов.

sdkmanager --install "platform-tools"

После завершения установки перезапустите терминал, чтобы изменения в PATH вступили в силу, и выполните adb devices для проверки связи с устройством.

Способ 3: Ручное скачивание и распаковка adb

Если sdkmanager недоступен или вы предпочитаете ручное управление, скачайте последнюю версию platform-tools с официального сайта Android Developers.

1. Скачайте архив (файл .zip).
2. Распакуйте его в удобную папку, например ~/android/platform-tools (macOS/Linux) или C:\Users\username\android\platform-tools (Windows).
3. Добавьте путь к этой папке в переменную PATH (см. команды из Способа 1).
4. Перезапустите терминал и проверьте работу командой adb shell.

Профилактика

• Регулярно обновляйте SDK через SDK Manager, чтобы версии инструментов были актуальными.
• Всегда добавляйте путь к папке platform-tools в переменную PATH сразу после установки или обновления Android‑инструментов.
• Избегайте удаления папки platform-tools вручную; используйте официальные методы удаления или обновления.
• При смене компьютера или профиля пользователя перенастройте переменные окружения заново.
• При использовании нескольких версий Android поддерживайте отдельные пути к platform-tools для каждой версии, чтобы избежать конфликтов.