Fastboot command not found: как исправить на Windows, Linux и macOS

Что означает ошибка "fastboot command not found"

Ошибка "fastboot command not found" (или на Windows: "fastboot не является внутренней или внешней командой") появляется, когда операционная система не может найти исполняемый файл fastboot в текущем контексте. Это означает, что либо fastboot не установлен на компьютер, либо он не добавлен в переменную окружения PATH, которая определяет, где система ищет исполняемые файлы.

Обычно эта ошибка возникает при попытке выполнить команду fastboot в терминале (Linux/macOS) или командной строке/PowerShell (Windows) для работы с Android-устройством в режиме fastboot (например, для прошивки, разблокировки загрузчика и т.д.).

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

1. Fastboot не установлен. Самый очевидный причиной — отсутствие самого fastboot на компьютере. Fastboot поставляется в составе Android SDK Platform-Tools, который нужно скачать и установить отдельно.
2. Fastboot не добавлен в PATH. Даже если fastboot установлен, система не сможет найти его, если путь к папке platform-tools (где находится fastboot) не указан в переменной окружения PATH.
3. Антивирус или система безопасности блокирует выполнение. Некоторые антивирусы могут ошибочно определять fastboot как потенциально опасное ПО и блокировать его запуск.
4. Повреждение установки fastboot. Файлы fastboot могли быть повреждены при скачивании или из-за сбоя диска, что приводит к невозможности их выполнения.
5. Неверный путь к fastboot. Если вы пытаетесь запустить fastboot из папки, которая не содержит исполняемый файл, или указываете неполный путь.

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

Способ 1: Установка Android SDK Platform-Tools

Это основной и самый надежный способ получить fastboot. Android SDK Platform-Tools — это официальный пакет от Google, который включает в себя fastboot, adb и другие утилиты для разработки под Android.

Для Windows:

1. Скачайте архив SDK Platform-Tools для Windows с официальной страницы Android.
2. Распакуйте архив в удобное место, например, C:\platform-tools.
3. Добавьте путь C:\platform-tools в системную переменную PATH:
   • Откройте Панель управления → Система → Дополнительные параметры системы.
   • Нажмите Переменные среды.
   • В разделе Системные переменные найдите переменную Path и нажмите Изменить.
   • Добавьте новый элемент с путем C:\platform-tools.
   • Нажмите OK во всех окнах.
4. Перезапустите командную строку или PowerShell.
5. Проверьте установку: выполните fastboot --version. Должна отобразиться версия fastboot.

Для Linux:

1. Скачайте архив SDK Platform-Tools для Linux с официального сайта.
2. Распакуйте архив, например, в домашнюю папку:

   tar -xzf platform-tools-latest-linux.zip -C ~/
   

3. Добавьте путь ~/platform-tools в файл ~/.bashrc или ~/.zshrc (в зависимости от вашей оболочки):

   echo 'export PATH="$HOME/platform-tools:$PATH"' >> ~/.bashrc
   source ~/.bashrc
   

4. Или создайте символьную ссылку в /usr/local/bin (требует прав sudo):

   sudo ln -s ~/platform-tools/fastboot /usr/local/bin/fastboot
   sudo ln -s ~/platform-tools/adb /usr/local/bin/adb
   

5. Проверьте: fastboot --version.

Для macOS:

1. Скачайте архив SDK Platform-Tools для macOS.
2. Распакуйте, например, в /Users/Имя/platform-tools.
3. Добавьте путь в ~/.bash_profile или ~/.zshrc:

   echo 'export PATH="$HOME/platform-tools:$PATH"' >> ~/.zshrc
   source ~/.zshrc
   

4. Или установите через Homebrew (см. Способ 3).
5. Проверьте: fastboot --version.

Способ 2: Использование Fastboot из Android Studio

Если у вас уже установлен Android Studio, то fastboot уже присутствует в составе SDK, который управляется Android Studio.

1. Запустите Android Studio.
2. Откройте Settings/Preferences → Appearance & Behavior → System Settings → Android SDK.
3. На вкладке SDK Tools убедитесь, что отмечена Android SDK Platform-Tools (должна быть установлена по умолчанию).
4. Запомните путь к Android SDK (указан вверху окна, например, C:\Users\Имя\AppData\Local\Android\Sdk).
5. Добавьте подпапку platform-tools этого пути в переменную PATH, как описано в Способе 1.
6. Перезапустите терминал и проверьте fastboot --version.

Способ 3: Установка через менеджер пакетов (Linux/macOS)

Для Linux и macOS можно использовать системные менеджеры пакетов, что упрощает установку и обновление.

Для Ubuntu/Debian:

sudo apt update
sudo apt install android-tools-adb android-tools-fastboot

После установки fastboot будет доступен глобально.

Для macOS с Homebrew:

brew install android-platform-tools

Это установит fastboot и adb в /usr/local/bin, которые уже обычно в PATH.

Примечание: Версии fastboot из менеджеров пакетов могут немного отставать от последней версии в SDK Platform-Tools, но для большинства задач этого достаточно.

Способ 4: Проверка антивируса и настроек безопасности

Иногда антивирусное ПО или встроенная система безопасности Windows (SmartScreen) блокируют запуск fastboot, считая его подозрительным.

1. Если при запуске fastboot появляется предупреждение антивируса, добавьте папку с platform-tools в исключения антивируса.
2. На Windows также может срабатывать SmartScreen. При появлении предупреждения "Windows защитил ваш компьютер" нажмите Подробнее → Всё равно запустить.
3. Убедитесь, что у вас есть права на выполнение файлов. На Windows: проверьте, что файл fastboot.exe не заблокирован (правой кнопкой → Свойства → если есть "Блокировано", снимите галочку).

Способ 5: Переустановка Fastboot

Если fastboot уже установлен, но не работает, возможно, файлы повреждены.

1. Удалите текущую папку platform-tools (или удалите пакет через менеджер пакетов).
2. Скачайте свежий архив с официального сайта Android.
3. Распакуйте и настройте PATH заново.
4. Проверьте установку.

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

Чтобы избежать проблемы "fastboot command not found" в будущем, следуйте простым рекомендациям:

• Всегда добавляйте папку platform-tools в PATH сразу после установки. Это гарантирует доступность fastboot из любого места.
• Используйте официальные источники для скачивания — Android SDK Platform-Tools с сайта Android Developers. Это обеспечит актуальную и безопасную версию.
• Обновляйте platform-tools регулярно. Новые версии исправляют баги и добавляют поддержку новых устройств.
• Добавьте папку platform-tools в исключения антивируса, если антивирус постоянно блокирует fastboot.
• Проверяйте целостность скачиваемого архива (на сайте есть контрольные суммы).
• Для Linux/macOS используйте менеджеры пакетов (Homebrew, apt), они автоматически обновляют и управляют путями.

Следуя этим шагам, вы обеспечите стабильную работу fastboot и избежите связанных с ним ошибок.