Установите ADB за 5 минут: полное руководство для Windows, Mac и Linux

Введение

Android Debug Bridge (ADB) — это мощный инструмент командной строки, который позволяет взаимодействовать с Android-устройством с компьютера. С его помощью можно устанавливать приложения, отлаживать приложения, получать доступ к файловой системе и выполнять многие другие операции. В этом руководстве вы узнаете, как быстро установить ADB на компьютер с Windows, macOS или Linux.

Требования

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

• Компьютер с одной из поддерживаемых ОС: Windows 7 или новее, macOS 10.10 или новее, Linux (Ubuntu 18.04+ или аналогичные).
• Доступ в интернет для скачивания Platform-Tools.
• Android-устройство (опционально, для проверки работы ADB).
• Права администратора (для добавления в PATH на Windows/Linux).

Пошаговая инструкция

Шаг 1: Определите операционную систему

ADB доступен для трёх основных платформ. Узнайте, какая у вас операционная система, чтобы скачать правильный пакет.

• Windows: обычно 64-битная версия.
• macOS: для процессоров Intel или Apple Silicon (M1/M2).
• Linux: для вашего дистрибутива (обычно общий архив).

Шаг 2: Скачайте Android SDK Platform-Tools

1. Откройте браузер и перейдите на официальную страницу загрузки Platform-Tools: Android SDK Platform-Tools.
2. Выберите версию для вашей операционной системы:
   • Для Windows: platform-tools-windows.zip
   • Для macOS: platform-tools-mac.zip (для Intel) или platform-tools-mac-arm.zip (для Apple Silicon)
   • Для Linux: platform-tools-linux.zip
3. Скачайте архив. Файл весит около 10-20 МБ.

💡 Совет: Если у вас медленный интернет, можно использовать зеркала, но рекомендуется официальный сайт для актуальной версии.

Шаг 3: Распакуйте архив

1. Найдите скачанный ZIP-архив в папке загрузок.
2. Распакуйте его в удобное место:
   • Windows: например, C:\platform-tools
   • macOS/Linux: например, ~/platform-tools или /opt/platform-tools
3. Убедитесь, что в распакованной папке есть файлы adb, fastboot и другие (на Windows adb.exe).

Шаг 4: Добавьте путь к adb в системный PATH (рекомендуется)

Добавление в PATH позволяет запускать команду adb из любого места в терминале или командной строке.

Для Windows:

1. Нажмите Win + R, введите sysdm.cpl и нажмите Enter.
2. Перейдите на вкладку "Дополнительно" → "Переменные среды".
3. В разделе "Системные переменные" найдите переменную Path и нажмите "Изменить".
4. Нажмите "Создать" и добавьте путь к папке platform-tools, например C:\platform-tools.
5. Нажмите OK во всех окнах.
6. Перезапустите командную строку или PowerShell, чтобы изменения вступили в силу.

Для macOS:

1. Откройте Terminal.
2. Определите, какая оболочка вы используете: echo $SHELL. Обычно bash или zsh.
3. Для bash (старые версии): отредактируйте файл ~/.bash_profile или ~/.bashrc. Для zsh (новые macOS): отредактируйте ~/.zshrc.
4. Добавьте строку: export PATH=$PATH:~/platform-tools (если распаковали в ~/platform-tools).
5. Сохраните файл и выполните source ~/.zshrc (или source ~/.bash_profile), чтобы применить изменения.

Для Linux (Ubuntu/Debian):

1. Откройте терминал.
2. Отредактируйте файл ~/.bashrc или ~/.profile (в зависимости от оболочки).
3. Добавьте строку: export PATH=$PATH:~/platform-tools
4. Сохраните и выполните source ~/.bashrc.

⚠️ Важно: Убедитесь, что путь указан правильно. Если вы переместили папку platform-tools, обновите путь.

Шаг 5: Проверьте установку

1. Откройте новое окно терминала (или командной строки для Windows).
2. Введите команду:

   adb version
   

3. Если установка прошла успешно, вы увидите вывод с версией ADB, например:

   Android Debug Bridge version 1.0.41
   Version 31.0.3-7562133
   

Если команда не найдена, проверьте, правильно ли вы добавили путь в PATH.

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

Чтобы убедиться, что ADB работает корректно с устройством:

1. На вашем Android-устройстве включите Опции разработчика (нажмите 7 раз на "Номер сборки" в "Об устройстве").
2. Включите Отладку по USB.
3. Подключите устройство к компьютеру через USB-кабель.
4. На устройстве подтвердите запрос на разрешение отладки (если появится).
5. В терминале выполните:

   adb devices
   

6. Вы должны увидеть список подключённых устройств. Если устройство отображается как device, значит, ADB работает.

Если устройство не отображается, убедитесь, что драйверы установлены (для Windows) и кабель поддерживает передачу данных.

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

"adb" не является внутренней или внешней командой (Windows)

• Причина: Путь к adb не добавлен в PATH или добавлен некорректно.
• Решение: Перепроверьте шаг 4 для Windows. Убедитесь, что путь ведёт к папке, содержащей adb.exe. Перезапустите командную строку.

Устройство не отображается в adb devices

• Причина: Не включена отладка по USB, драйверы не установлены, кабель только для зарядки.
• Решение:
  • Включите отладку по USB на устройстве.
  • Для Windows: установите драйверы USB для вашего устройства (может потребоваться драйвер от производителя или Google USB Driver).
  • Попробуйте другой USB-порт или кабель.
  • Перезагрузите ADB-сервер: adb kill-server затем adb start-server.

ADB работает только после перезагрузки компьютера

• Причина: Изменения в PATH вступили в силу только после перезагрузки.
• Решение: Перезапустите терминал или добавьте путь в текущей сессии, выполнив export PATH=$PATH:/путь/к/platform-tools (для macOS/Linux) или установив переменную в Windows.

Ошибка "error: device offline" или "unauthorized"

• Причина: На устройстве не подтверждён запрос на отладку.
• Решение: На устройстве снимите уведомление и нажмите "Разрешить". Если не появляется, переподключите кабель или перезагрузите устройство.

Это основные проблемы. Для более сложных ошибок обратитесь к специфическим статьям в базе знаний.