ADB на Mac: установка Platform-Tools и проверка подключения устройства

Чтобы пользоваться adb на Mac, не обязательно устанавливать весь Android Studio. Для командной строки достаточно официального пакета Android SDK Platform-Tools для Mac. Если Studio уже управляет вашим Android SDK, Google рекомендует брать Platform-Tools через SDK Manager, а не заводить ещё одну независимую копию.

Это руководство по документации Google, а не отчёт о практическом тесте: шаги не проверялись на Mac и Android-устройстве. Команды ниже предназначены для выполнения на вашем Mac с вашим устройством; результатов выполнения и снимков экрана здесь нет.

1. Выберите один источник установки

Если Android Studio уже установлен

Откройте Tools > SDK Manager. На вкладке SDK Tools выберите Android SDK Platform-Tools, затем Apply или OK и ознакомьтесь с условиями лицензии. Запишите значение Android SDK Location: установленный adb находится в подкаталоге platform-tools именно этого SDK.

android_sdk/platform-tools/ в документации Google — обозначение каталога вашего SDK, а не буквальный путь, который нужно вставить в Терминал. Не предполагайте, что SDK обязательно лежит в каталоге по умолчанию: ориентируйтесь на SDK Manager. Инструкция Google по SDK Manager.

Если нужен только adb

Откройте официальную страницу Platform-Tools, выберите Download SDK Platform-Tools for Mac, прочитайте условия Android SDK License Agreement и скачайте ZIP. Распакуйте архив и сохраните папку platform-tools в выбранном постоянном месте. Не запускайте вариант для Windows или Linux.

В Терминале введите cd с пробелом, перетащите распакованную папку platform-tools из Finder в окно Терминала и нажмите Return. Так вы перейдёте в реальный каталог без подстановки чужого имени пользователя или выдуманного пути. Затем проверьте:

./adb version

Префикс ./ означает «запустить adb из текущей папки». Само наличие файла в этой папке не означает, что команда adb без префикса найдётся через PATH. Для первых проверок добавлять каталог в глобальный PATH не требуется.

Google предоставляет отдельный ZIP для командной строки без Studio; официальный пакет распространяется по условиям SDK, а не по произвольной «бесплатной лицензии без ограничений». Источник и условия загрузки.

В карточке Platform-Tools на OpenNavo собраны сведения о пакете. На момент подготовки этой статьи рекомендация в каталоге приостановлена. Это состояние OpenNavo, а не заявление, что Google прекратил поставлять инструменты: официальный Mac ZIP по-прежнему указан на странице Google. Эта инструкция использует официальный источник, не меняя статус карточки.

2. Уточните, какую копию adb вы запускаете

Если ожидаете запускать adb из любого каталога, выполните:

which -a adb
adb version

which -a adb помогает увидеть найденные в PATH копии; adb version показывает версию запускаемого клиента. Сравните найденные пути с каталогом, выбранным на предыдущем шаге. Эти проверки решают разные задачи: известная версия сама по себе не доказывает, что вы используете нужную установку.

Если команда не найдена, вернитесь в выбранную папку platform-tools и используйте ./adb version. Для дальнейших команд в этой статье тогда также заменяйте начальное adb на ./adb: например, ./adb devices -l. Такой вариант работает и для каталога, установленного через SDK Manager.

Если обнаружено несколько установок, сначала определите, какая из них нужна вашему SDK или рабочему процессу. Не удаляйте другие копии и не переписывайте настройки оболочки наугад. Клиенты adb обращаются к общему серверу на локальном TCP-порту 5037, поэтому выбор файла клиента и состояние уже работающего сервера — не одно и то же. Для этого руководства достаточно последовательно использовать выбранную копию. Как работает adb.

3. Подключите своё Android-устройство по USB

1. На принадлежащем вам устройстве откройте параметры разработчика и включите USB debugging / Отладку по USB. Если раздел скрыт, следуйте инструкции Google по включению параметров разработчика; названия пунктов могут отличаться у производителей.
2. Подключите устройство к Mac кабелем, способным передавать данные. Разблокируйте экран.
3. Запустите команду списка устройств:

adb devices -l

4. Проверьте запрос на самом устройстве. Android 4.2.2 и новее запрашивает подтверждение RSA-ключа компьютера для отладки. Разрешайте доступ только своему доверенному компьютеру и только для ожидаемого подключения; на чужом компьютере не сохраняйте постоянное доверие.
5. После подтверждения снова выполните adb devices -l.

По документации Google, для обнаружения устройства на macOS дополнительная настройка ОС не требуется. Не переносите сюда инструкции по USB-драйверам Windows или udev для Linux. Это не гарантия работы любого кабеля и любого устройства. USB-подключение и RSA-авторизация.

Команда devices перечисляет устройства, а -l включает подробный вывод. Команда adb tcpip 5555 не перечисляет устройства: она меняет режим прослушивания службы на устройстве. Для этой USB-проверки она не нужна и выполнять её не следует. Справочник команд adb.

4. Разберите результат, а не только наличие строки

Ниже описаны состояния, а не результаты тестирования конкретного устройства.

Что вы видите	Что это означает	Что проверить дальше
command not found	Оболочка не нашла команду по имени	Перейдите в выбранную папку и проверьте ./adb version; затем используйте ./adb devices -l
Заголовок списка без строк устройств	Этот запрос не показал подключённых устройств	Проверьте подключение, кабель для данных, разблокировку устройства и включённую USB-отладку; попробуйте другой исправный кабель или USB-порт
Строка с unauthorized	Подключение ещё не авторизовано для отладки	Посмотрите на разблокированный экран телефона и подтвердите ожидаемый RSA-запрос; если запроса нет, переподключите USB и снова проверьте список
Строка с device	Устройство подключено к серверу adb	Сверьте серийный номер и модель; это не доказывает полную загрузку Android или успешность будущих команд
Строка с offline	Устройство не подключено к adb или не отвечает	Проверьте соединение и состояние устройства; не считайте это успешной авторизацией
Несколько строк	Обнаружено несколько устройств или эмуляторов	Перед дальнейшей командой явно выберите нужное устройство

Проверки кабеля и настроек соответствуют рекомендациям Google по USB-подключению. Если они не помогают, обратитесь к документации производителя устройства; не отключайте защиту macOS и не пытайтесь обходить авторизацию телефона.

Google отдельно предупреждает: состояние device не означает, что Android полностью загрузился и уже готов ко всем операциям. Состояния в списке устройств.

5. Если устройств несколько, выберите одно явно

Скопируйте серийный номер нужной строки из adb devices -l. Для проверки состояния конкретного устройства можно использовать:

adb -s SERIAL get-state

SERIAL — заполнитель: замените его фактическим серийным номером своего устройства, не вводите это слово буквально. Если запускаете инструмент из текущего каталога, используйте ./adb -s SERIAL get-state. Это запрос состояния, а не установка приложения или изменение файлов.

Параметр -s выбирает устройство с указанным серийным номером. Не полагайтесь на порядок строк, особенно когда одновременно работает эмулятор. Выбор устройства в Google adb guide.

6. Завершите сеанс без лишнего доверия

После проверки отключите кабель и выключите USB-отладку, если она больше не нужна. Если вы разрешили компьютеру дальнейшую отладку и хотите отозвать это доверие, воспользуйтесь пунктом отзыва разрешений USB-отладки в параметрах разработчика устройства, если он доступен. Название и расположение зависят от производителя; отзыв может затронуть и другие ранее доверенные компьютеры.

Закрытие Терминала само по себе не означает отзыв доверия. Не удаляйте вручную ключи и служебные файлы ради этой проверки. Не публикуйте серийные номера, отпечатки ключей и другие идентификаторы устройства в скриншотах или отчётах.

Короткие ответы

Нужно ли устанавливать Android Studio только ради adb? Нет. Google предлагает отдельный пакет Platform-Tools для Mac. Уже используете Studio — удобнее оставить управление инструментами SDK Manager.

Почему ./adb version работает, а adb version — нет? Первый вариант указывает на файл в текущем каталоге, второй зависит от поиска команды оболочкой. Для этого руководства можно продолжать с ./adb, не меняя глобальные настройки.

device означает, что всё готово? Это признак соединения с adb, а не обещание полной загрузки системы, работоспособности приложения или безопасности любой следующей команды.

Нужна ли беспроводная отладка? Нет, для этого USB-сценария она не требуется. Здесь нет шагов открытия сетевого порта или беспроводного подключения.

Источники и границы проверки

• Google: SDK Platform-Tools и загрузка для Mac.
• Google: Android Debug Bridge — авторизация, список и выбор устройств.
• Google: SDK Manager.
• Google: подключение реального устройства и проверка USB.
• AOSP: справочник adb.

Материал составлен по официальной документации Google; практическая проверка на Mac и Android-устройстве не проводилась. Здесь нет подтверждённых результатов производительности, теста совместимости конкретной версии macOS или снимков экрана с якобы выполненными командами.