Настройка ADB и Platform-tools на Windows, macOS и Linux

Короткий ответ: скачайте официальный архив Platform-tools от Google или установите пакет через менеджер (Homebrew/apt), распакуйте/установите, добавьте папку platform-tools в PATH, включите на устройстве «Отладку по USB» и проверьте командой adb devices — дальше можно использовать adb и fastboot.

Где безопасно скачать и что входит в пакет

Скачивайте только официальные Platform-tools (Android SDK Platform-tools) или используйте репозитории вашей ОС. В пакете обычно есть:

  • adb — Android Debug Bridge;
  • fastboot — работа с загрузчиком;
  • дополнительные утилиты (systrace и т. п.).

Не скачивайте сборки с форумов или торрентов — риск вредоносного ПО и устаревших бинарников.

Подготовка Android-устройства

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

Если устройство спрашивает режим подключения — выберите MTP (Передача файлов) для надёжного соединения.

Установка на Windows — шаги

  1. Скачайте SDK Platform-Tools for Windows и распакуйте, например в C:\platform-tools.
  2. Добавьте путь в PATH:
    • Win + R → sysdm.cpl → Дополнительно → Переменные среды → Path → Изменить → Создать → C:\platform-tools.
  3. Откройте новое окно PowerShell или cmd и проверьте:
    • adb version
  4. При необходимости установите USB-драйверы для производителя (через Диспетчер устройств).

Совет: если команда «adb» не найдена — закройте и откройте терминал, проверьте правильность пути.

Установка на macOS

Вариант A — официальный архив:

  1. Распакуйте в ~/platform-tools или ~/Library/Android/sdk/platform-tools.
  2. В терминале добавьте в PATH (zsh по умолчанию):
    • nano ~/.zshrc
    • добавьте: export PATH=$PATH:$HOME/platform-tools
    • source ~/.zshrc
  3. Проверьте: adb version

Вариант B — Homebrew:

  • brew install android-platform-tools Плюс: обновление — brew upgrade android-platform-tools.

Установка на Linux

Вариант A — через репозиторий (Ubuntu/Debian):

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

Вариант B — официальный архив:

  1. Распакуйте в ~/Android/platform-tools.
  2. Добавьте в ~/.bashrc или ~/.profile: export PATH=$PATH:$HOME/Android/platform-tools
  3. source ~/.bashrc

Чтобы запускать adb без sudo, создайте udev-правила:

  1. sudo nano /etc/udev/rules.d/51-android.rules
  2. Добавьте строки для VID производителя, например:
    • SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"
  3. sudo udevadm control --reload-rules && sudo udevadm trigger

Проверка работы и первые команды

  1. Подключите устройство по USB.
  2. Выполните:
    • adb kill-server
    • adb start-server
    • adb devices При первом подключении подтвердите отладку на телефоне. В выводе статус device — готово; unauthorized — нужно подтвердить; offline — попробуйте сменить кабель/порт и перезапустить adb.

Полезные команды:

  • adb shell — попасть в оболочку устройства;
  • adb install путь_к_файлу.apk — установить APK;
  • adb push local remote — скопировать на устройство;
  • adb pull remote local — скачать с устройства;
  • adb reboot — перезагрузить;
  • adb reboot bootloader — перейти в bootloader/fastboot.

Для работы с прошивками используйте fastboot (устройство должно быть в режиме bootloader).

Частые ошибки

  • adb не найден: путь к platform-tools не добавлен в PATH или терминал не перезапущен.
  • устройство не видно: отключена отладка, «зарядный» кабель без передачи данных, проблемы с драйверами (Windows) или правами udev (Linux).
  • unauthorized: нужно подтвердить запрос на телефоне или отменить авторизации в настройках разработчика и повторно подключиться.
  • fastboot не работает: устройство не в режиме загрузчика или производитель блокирует доступ (OEM lock).

FAQ

  • Нужно ли устанавливать Android Studio? Нет: для adb достаточно Platform-tools. Android Studio нужна, если вы хотите SDK/IDE.
  • Можно ли обновлять Platform-tools вручную? Да — скачайте новую версию и замените файлы, либо обновите через пакетный менеджер.
  • Как вернуть устройство в норму, если adb мешает? Просто закройте adb: adb kill-server; отключите отладку на телефоне.

Мини‑чеклист перед началом:

  • скачан официальный Platform-tools;
  • распаковано в постоянную папку;
  • путь добавлен в PATH или пакет установлен менеджером;
  • на устройстве включена отладка по USB;
  • adb devices показывает устройство со статусом device.

Следуя этим шагам, вы за 10–15 минут настроите ADB и Platform-tools и сможете выполнять отладку, устанавливать APK и работать с fastboot.