Содержание
- Шаг 1: Скачивание и установка
- Шаг 2: Запуск утилиты ADB
- Способ 1: «Командная строка» Windows
- Способ 2: Windows PowerShell
- Дополнительно. Подключение Android-устройства к ADB на ПК
- Вопросы и ответы
Шаг 1: Скачивание и установка
Прежде чем запуск консольной утилиты ADB станет возможным, конечно же, необходимо загрузить и инсталлировать её на компьютер. В действительности, существует множество вариантов получения и развёртывания софта, который обеспечивает функционирование Android Debug Bridge на ПК под управлением Windows 10, а следующая инструкция демонстрирует, как это сделать задокументированным разработчиками технологии Android Debug Bridge, а значит, самым надёжным и эффективным способом.
Скачать SDK Platform Tools (ADB и Fastboot) с официального сайта
- Перейдите по представленной перед этой инструкцией ссылке. В результате откроется веб-страница с описанием и возможностью загрузки включающего ADB пакета SDK Platform Tools на интернет-ресурсе Android Developers от Google.
- Переместитесь в раздел веб-страницы «Downloads»,
щёлкните по имеющейся здесь ссылке «Download SDK Platform-Tools for Windows».
- Прокрутите информацию в отобразившемся поверх веб-страницы окне до конца,
установите отметку в чекбоксе «I have read and agree with the above terms and conditions».
- Нажмите на ставшую активной после выполнения предыдущего шага кнопку «Download Android SDK Platform-Tools for Windows».
- Если это предполагают настройки браузера, укажите (и запомните) путь сохранения предоставляемого сайтом ZIP-архива на диске компьютера
(по умолчанию будет скачан в системную библиотеку Win 10 «Загрузки»). Подтвердите инициацию получения пакета
и дождитесь окончания этого процесса.
- По завершении скачивания файла platform-tools_rВЕРСИЯ-windows.zip откройте содержащую его папку
в Проводнике Windows.
Читайте также: Запуск «Проводника» в ОС Windows 10
- В результате разархивации пакета SDK Platform Tools образуется директория, которая содержит вложенную папку «platform-tools» –
именно она и является целевой в нашем случае.
По сути, на этом получение утилиты ADB можно считать завершённым, её уже можно запускать из указанной папки средствами консоли Windows 10 одним из предложенных далее в этой статье способов. При этом, для удобства в дальнейшем, а также полного соответствия рекомендациям разработчиков Android Debug Bridge необходимо скопировать или переместить каталог «platform-tools»
в корень
системного диска ПК (С:).
Кроме прочего, каталог с утилитой ADB можно переименовать по собственному усмотрению (например, сократить наименование или как-то иначе, но не применяя кириллических символов). При таком подходе запомните присвоенное каталогу с утилитой ADB имя, и точно вводите его вместо
platform-tools
при выполнении дальнейших инструкций из этого материала.
Далее извлеките всё содержимое архива в отдельный каталог. (С этой целью кликните правой кнопкой мыши по наименованию пакета, выберите «Извлечь всё» в открывшемся контекстном меню, подтвердите действие).
Подробнее: Распаковка ZIP-архивов в ОС Windows 10
Входящие в комплект SDK Platform Tools утилиты (не только рассматриваемая в этой статье ADB, но также Fastboot) в случае с Windows 10 могут быть запущены и эффективно эксплуатироваться в классической «Командной строке», а также её более современном аналоге – консольной оболочке «PowerShell». Далее рассмотрим подробно, как используются оба указанных инструмента для решения нашей задачи.
Способ 1: «Командная строка» Windows
По сути, чтобы получить доступ к функциям утилиты ADB через «Командную строку» Windows, достаточно открыть во второй содержащий компоненты первой каталог («platform-tools»). Практически это реализуемо минимум двумя путями, вы можете использовать тот, который кажется более удобным.
Вариант 1: Консольная команда «cd»
Самый распространённый и привычный большинству метод запуска консольной утилиты ADB заключается в открытии приложения «Командная строка» и переходе через неё в папку с целевым софтом с помощью специализированной текстовой команды:
- Любым способом запустите «Командную строку» Виндовс 10. К примеру, и быстрее всего с этой целью можно задействовать оснастку «Выполнить»: нажмите «Windows» + «R» на клавиатуре, введите в поле «Открыть» отобразившегося окошка следующий текст:
cmd
Щёлкните по кнопке «ОK» мышкой или нажмите «Enter».
Подробнее: Открытие «Командной строки» в Windows 10
- Введите команду перехода в каталог утилиты ADB – она состоит из указания
cd
и затем полного пути к целевой директории на диске компьютера. То есть, если вы точно следовали рекомендациям выше в статье, команда будет следующей:cd C:\platform-tools
Написав команду, отправьте её на выполнение — для этого нажмите «Ввод» на клавиатуре.
- Фактически всё, далее можно приступать к отправке текстовых команд ADB, — утилита готова к их приёму и обработке. Чтобы удостовериться в том, что отладочный мост введён в эксплуатацию, а также для получения списка основных команд ADB, можно ввести в консоли и отправить на выполнение следующее указание:
adb.exe
Вариант 2: Средства Проводника Windows
Более удобный и часто выполнимый быстрее, нежели вышеописанный, подход к запуску утилиты АДБ в классической «Командной строке» эксплуатирует возможности системного файлового менеджера Виндовс 10:
- Откройте Проводник Windows 10, перейдите в каталог ADB («platform-tools»).
- Кликните левой кнопкой мыши в (важно!) свободной от надписей области поля, которое расположено в верхней части окна Проводника и отображает путь
к текущей открытой вами папке.
- С клавиатуры введите следующий текст:
cmd
- Нажмите «Enter» — в результате запустится «Командная строка» Windows c уже открытой в ней папкой «platform-tools».
На этом наша задача считается решённой, вы можете приступать к вводу в «Командную строку» и отправке на выполнение команд Android Debug Bridge.
Способ 2: Windows PowerShell
Запуск ADB через поставляемое в комплекте ОС Windows 10 средство PowerShell выполняется не намного сложнее, нежели при использовании классической «Командной строки», а практически реализуется одним из двух нижеописанных путей.
Вариант 1: Консольная команда «cd»
Основной вариант запуска Android Debug Bridge средствами PowerShell фактически повторяет таковой в «Командной строке», — необходимо запустить консоль, а затем с помощью специальной команды открыть в ней каталог с утилитой ADB и сопровождающими её файлами.
- Откройте консольную оболочку PowerShell. Как и классическую «Командную строку» в Windows 10 это средство можно запустить большим числом способов, а быстрее всего — из меню дополнительных действий кнопки «Пуск» на «Панели задач» операционки: кликните по последней правой кнопкой манипулятора и выберите «Windows PowerShell» в отобразившемся перечне.
Подробнее: Запуск «PowerShell» в ОС Windows 10
- Введите команду перехода в папку утилиты ADB, — её синтаксис аналогичен рассмотренному выше в этом материале указанию для классической «Командной строки»:
cd C:\platform-tools
Нажав «Ввод» на клавиатуре, отправьте указание на выполнение консолью.
- Собственно, всё — средство ADB готово к выполнению своего предназначения. Дальнейшие ваши действия двухвариантные:
- При запуске ADB-команд в Windows PowerShell по умолчанию перед ними необходимо прописывать префикс
./
. То есть, к примеру, чтобы вывести в консоли список основных команд ADB в текущем случае, необходимо отправить на выполнение следующее текстовое указание:./adb.exe
После написания команды и нажатия «Enter» получаем следующий результат:
- Если подставлять
./
перед каждой передаваемой средствами ПоверШелл через Андроид Дебаг Бридж командой вы не желаете, то можете перед началом работы открыть себе доступ к «классической» командной строке в современной консольной оболочке. Для этого запустите в PowerShell команду:cmd
Далее отправляйте указания ADB мобильному девайсу c ОС Android без префикса:
- При запуске ADB-команд в Windows PowerShell по умолчанию перед ними необходимо прописывать префикс
Вариант 2: Расширенное контекстное меню папки
Ещё один метод запуска ADB в консольной оболочке PowerShell реализуется средствами Проводника Windows 10, а его использование часто оказывается более удобным, нежели описанный выше подход.
- Перейдите в папку с утилитой ADB через Проводник Win 10.
- Нажмите «Shift» на клавиатуре компьютера и, удерживая эту клавишу, щёлкните правой кнопкой манипулятора по свободному от элементов (значков файлов) месту в демонстрирующей содержимое каталога «platform-tools» области окна Проводника.
- По результату вышеописанной манипуляции откроется расширенное контекстное меню папки (после этого можно прекратить воздействие на кнопку «Shift» клавиатуры). В меню выберите пункт «Открыть окно Power Shell здесь».
- Итогом манипуляций станет запуск приложения Windows Power Shell c уже открытым в нём каталогом «platform-tools». На этом наша задача считается решённой, приступайте к вводу и отправке на выполнение команд Android Debug Bridge.
(Принцип здесь тот же, что и при рассмотренном выше варианте запуска утилиты: либо предварительно запустите команду
cmd
, а затем отправляйте ADB-команды в их «стандартном» виде; либо подставляйте префикс./
перед каждым указанием).
Дополнительно. Подключение Android-устройства к ADB на ПК
Чтобы скачивание, развёртывание и запуск ADB в среде Windows 10 позволили достичь конечных целей своего осуществления, то есть вы получили возможность производить вмешательство в работу системного ПО управляемого ОС Android мобильного девайса с компьютера, чрезвычайно важно правильно подключить смартфон или планшет к консольной утилите. Полный алгоритм выполнения данной операции изложен ниже.
Скачать универсальные драйверы от Google для работы с Android-девайсами через ADB
- Прежде чем приступать к выполнению вмешательства в работу системного ПО смартфона или планшета под управлением ОС Android с компьютера через ADB, на мобильном устройстве необходимо активировать особый режим функционирования – «Отладка через USB».
Сделайте это в первую очередь, а подробные инструкции по решению данного вопроса, если они необходимы, вы обнаружите в статьях по следующим ссылкам:
Подробнее:
Как включить «Отладку по USB» на Android-девайсе
Активация режима «Отладка по USB» на смартфонах Xiaomi (Mi, Redmi, POCO) - Подсоедините Андроид-девайс с активированной «Отладкой по ЮСБ» к USB-порту компьютера кабелем.
- Далее, например из контекстного меню кнопки «Пуск» на «Панели задач» операционки, откройте «Диспетчер устройств» Windows 10.
- Убедитесь, что мобильное устройство определилось операционной системой правильно и для него загружен необходимый драйвер. В таком варианте «Диспетчер устройств» отображает категорию «Android Phone», и в ней — запись «Android Composite ADB Interface» (последняя не должна сопровождаться какими-либо отметками, типа восклицательного знака на жёлтом фоне).
Если с определением Android-девайса в «Диспетчере устройств» Windows 10 наблюдаются какие-либо проблемы, чаще всего их следует решать путём установки/переустановки ADB-драйвера.
Читайте также: Инсталляция драйверов для работы с Android-девайсами с ПК
Опять же, в большинстве случаев, самым правильным выбором драйвера для обеспечения сопряжения ПК и Андроид-устройства через АДБ будет универсальный компонент, доступный для скачивания на интернет-ресурсе «Android Developers»
(ссылка доступна перед настоящей инструкцией).
- Запустите утилиту ADB любым из предложенных выше в этом материале способом.
Напишите и отправьте на выполнение консолью Windows 10 следующую команду:
аdb devices
- Если сопряжение ПК и мобильного устройства через Android Debug Bridge осуществляется впервые, «Командная строка»/«PowerShell» в ответ на указание из предыдущего пункта инструкции выдаст следующее:
List of devices attached
ID_Android-устройства unauthorized
В таком случае, возьмите (не отсоединяя от компьютера) смартфон или планшет, разблокируйте его. Поставьте отметку «Всегда разрешать отладку с этого компьютера» в отображаемом на экране Android-девайса окне «Отладка по USB», а после этого коснитесь кнопки «Разрешить».
Далее перейдите к окну консоли с запущенной утилитой ADB на компьютере, повторите запуск команды
аdb devices
. - Получив в «Командной строке» или «PowerShell» ответ в виде строчки
ID_Android-устройства device
, вы можете переходить к непосредственному решению возлагаемых на ADB задач, — смартфон/планшет теперь подключён к утилите правильно и готов к выполнению её (а по сути – ваших) указаний.
Что это такое?
ADB — Это Android Debug Bridge, что переводиться как «отладочный андроид мост». Служит он, как уже ясно из названия, для отладки андроида или отдельных приложений. С его помощью можно делать все действия, которые может делать пользователь и даже больше, однако для «больше» нужен ROOT доступ.
Чаще всего, ADB используется для прошивки или изменения каких то настроек, скрытых файлов и тд. Так-же можно просматривать логи прямо в реал-тайме (для этого есть спец. программы, которые куда удобнее командной строки), устанавливать программы, менять настройки и все в таком духе.
Я например использую подключение для тестирования своих андроид проектов. Нажимаешь кнопку «Build and run» и программа или игра собирается в пакет, отправляется на телефон и устанавливается, после чего еще и запускается. Удобно. Именно о таком способе использования и пойдет речь сегодня.
Как включить ADB?
Для того что-бы включить ADB на вашем устройстве на базе андроида, необходимо выполнить несложный ряд действий.
- Зайти в настройки -> О телефоне
- Нажимать на «Номер сборки», пока не появиться сообщение «вы стали разработчиком».
- Выйти в меню настроек и найти новый пункт «Для разработчиков»
- Включить пункт «отладка по USB»
По сути, это все, для включения ADB. Но для работы еще необходимы драйвера. Скачать универсальные можно тут . Эти драйвера подходят для большинства андроид телефонов, планшетов и других устройств на этой операционной системе. В 99% случаев у вас не будет с ними проблем. Однако производитель устройств часто выкладывают свои ADB драйвера на официальном сайте, часто, это просто копия универсальных драйверов, но бывают и исключения. Поэтому если ваше устройство не подключается с универсальными драйверами, попробуйте специальные от производителя.
Скачать ADB на компьютер
Конечно, для работы нужна сама программа ADB для пк. Точнее это архив с несколькими утилитами. Вот ссылка на официальную страницу от Google. ссылка. На странице есть ссылка на архив для windows, mac, linux. Жмем «Download SDK Platform-Tools for Windows» или другую платформу. Распаковываем архив в C:/adb для удобства.
Как пользоваться?
Пользоваться можно через командную строку или UI интерфейс. Через командную строку делается это так:
- Пуск -> выполнить или WIN+R
- Пишем команду «CMD«
- Переходим в папку с ADB с помощью команды «CD C:/adb»
Далее пишем команды которые необходимы. Например, проверим, подключился ли телефон по мосту.
Пишем «adb devices». В консоли пробегут строчки о запуске сервера и выдастся список подключенных девайсов
c:\adb>adb devices
List of devices attached
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
List of devices attached
1d886e2 device
Последняя строчка означает, что телефон подключен. Отлично!
Теперь можно вводить любые доступные команды, список которых можно посмотреть тут.
Консольки, это конечно хорошо, но давайте разберем конкретный пример.
Предположим, вы разрабатываете игру на Unity. Вам необходимо ее проверить на телефоне. Что для этого нужно? Просто подключите телефон к пк, а в Unity в окне Build выберете устройство из списка. Далее жмем кнопку «Build and run» и ждем. Готово.
Как использовать ADB по WIFI?
Да, да, вам не показалось, полный контроль можно получить и без проводов и да, это опасно. Однако, подключиться к телефону можно только если разрешить это делать.
- Во-первых нужно в меню разработчика включить эту функцию (есть не на всех устройствах).
- Во-вторых она выключается при перезагрузке.
- И в-третьих при первом подключении с неизвестного устройства вылезет запрос на подтверждение, можно ли подключиться.
Однако, не все так просто. Что-бы все заработало, кабель все же понадобиться.
- Подключаем девайс по USB
- Открываем консоль и переходим в папку ADB, как уже делали выше.
- Убеждаемся что девайс и комп в одной Wi-Fi сети.
- Пишем adb tcpip 5555
- Пишем adb connect IP_ДЕВАЙСА. Адрес можно подсмотреть в настройках wifi вашей сети.
Обычно после этого достаточно выполнять только пункт 5. После этого ADB должен работать без проводов. Пользоваться им точно так же как и по проводу.
3.23/5 (22)
Рейтинг: 3.5/5. на основе 2 оценок.
Пожалуйста, подождите…
12 мая, 2020
Android Debug Bridge (ADB) – утилита командной строки для универсального использования, с помощью которой можно открыть доступ к устройствам на Android.
ADB позволяет:
- Осуществлять установку файлов, а также их копирование и удаление;
- Выполнять установку программы на устройство;
- Записывать видео или делать скриншот экрана телефона;
- В случае сбоя работы устройства, выполнить его отладку;
- Изучать логи с телефона;
- Осуществлять прошивку программ и составляющих элементов системы;
- Получать полый доступ к данным об ОС и о самом устройстве.
Android Debug Bridge
Процесс установки ADB и настройка окружения для ПК с macOS
Чтобы установить ADB на компьютер с поддержкой macOS, необходимо выполнить следующий алгоритм действий:
- С официального источника загрузить файловый документ установки, разработанный для macOS.
- Разархивировать содержимое. Папку «Platform-tools» перенести в любое, удобное для вашего использования место.
- Активировать Launchpad, находящийся в каталоге «Other», открыть приложение Terminal;
- С помощью команды cd, перейти из «Terminal» в «Platform-tools».
- Перейдя в требующуюся директорию, необходимо изучить работоспособность ADB. Для этого потребуется в меню «Terminal», вписать команду «./adb».
- Если среди всех пунктов каталога «Terminal» отображаются данные о применяемых приложениях, значит, все функционирует должным образом.
Установка ADB и настройка окружения для ПК с ОС Windows
Чтобы установить Android Debug Bridge на Windows, необходимо:
- С официального источника загрузить файловый документ установки, разработанный для ОС Windows.
- Извлечь все данные из архива. Перенести папку «Platform-tools» в меню диска C:\.
- Выполнить переход в «Панель управления > Система и безопасность > Система» или воспользоваться набором клавиш Win+Pause/Break, после чего перейти в «Дополнительные параметры системы».
- Зайти в «Переменные среды».
- В «Системные переменные» выбрать «Path» и нажать на «Изменить».
- Вписать путь к «platform-tools», где хранятся adb-файлы.
- Выполнить перезапуск системы и активировать командную строку.
- Вписать команду «adb version». Если вы видите данные с версией ADB, то алгоритм установки выполнен правильно и программа полностью готова к использованию.
Подготовка ОС Android к работе с ADB
Чтобы полноценно работать с ADB на Android-устройствах, необходимо внедрить определенные изменения в параметрах телефона. В зависимости от производителя, конфигурационное меню может разниться, но в целом главные действия схожи:
- Заходим в меню «Settings», где находим раздел «About phone»;
- Быстро нажать по номеру билда до того момента, пока не появится сообщение о том, что вы стали разработчиком;
- В главных конфигурациях перейти в раздел «Developer option»;
- Нажать на «USB debugging»;
- Подключить устройство к ПК с помощью USB;
- На телефоне подтвердить отладку по USB.
Прежде чем приступать к работе, необходимо убедиться, что ПК обнаружило мобильное устройство и весь функционал работает правильно. Чтобы выполнить это на компьютерах с ОС Windows, в командной строке следует набрать «adb devices».
Работая на ПК с macOS, все команды нужно вводить, начиная с «./».
После всего этого, на экране должно появиться уведомление о том, что все шаги выполнены правильно и программа готова к использованию. Если же подобная информация не отобразилась, следует убедится, есть ли официальный драйвер утилиты.
Самые распространенные команды ADB
Команда | Содержание |
adb | Вывод всех команд в окно консоли |
adb devices | Вывод на дисплей данных об устройствах, которые подключены к ПК, а также их серии |
adb reboot | Перезагрузка Android |
adb logcat | Сбор логов и их просмотр с телефона. Логи отображаются в командной строке |
adb push C:\Users\user\Documents\temp.txt /sdcard | Позволяет отправлять документы с компьютера на мобильное устройство. Для этого требуется написать адрес к отправляемому файлу и место, где оно будет храниться на телефоне |
adb logcat -d > ~/test.log | Сбор логов с телефона и их запись в отдельный файловый документ |
adb shell screenrecord /sdcard/test.mp4 | Запись дисплея телефона, с указанием места хранения файла, наименования и расширения |
adb install C:\test.apk | Установка программы на устройство. Для этого нужно ввести путь к утилите |
adb shell screencap /sdcard/test.png | Скриншот с мобильного устройства, с указанием места хранения, наименования и расширения |
Таким образом
Android Debug Bridge – это универсальный инструмент, полезность которого в работе тестировщика очень высока, особенно, если это касается работы с Android-устройствами при проведении тестирования мобильных приложений.
Хоть интерфейс ADB сложно назвать привлекательным, его функциональные возможности очень широки, а это ключ к эффективной работе с мобильными устройствами.
Читая статьи о перепрошивке и рутинге Android-устройств, вы наверняка встречали упоминание консольной команды adb в тексте. Этот инструмент очень популярен среди энтузиастов ОС Android и применяется почти во всех графических и консольных утилитах для рутинга, снятия защиты и других действий. Однако, далеко не каждый пользователь знаком с этим инструментом и не знает его полезнейших возможностей, таких как установка и удаление приложений, синхронизация папок между настольной машиной и смартфоном, снятие скриншотов, открытие доступа в интерет через смартфон и многих других.
ADB это протокол или, проще говоря, система связи между настольной машиной и смартфоном по USB-кабелю, которая изначально была разработана сотрудниками Google для отладки и выполнения сервисных задач над смартфоном. Другими словами это инструмент для разработчиков, который тем не менее имеет множество функций, которые могут быть полезны и обычному пользователю.
ADB состоит из двух компонентов: сервера, который работает на смартфоне, и клиентской программы, которую пользователь запускает на большом брате. Сам клиент представляет собой небольшую консольную команду, которую следует запускать либо в окне DOS в Windows, либо в эмуляторе терминала в Linux. Вся работа с ADB сводится примерно к следующему: с помощью клиента пользователь отдает команду, а смартфон ее выполняет.
Как пользоваться ADB
Перед тем как начать использовать ADB следует обзавестись клиентом. По умолчанию он распространяется в составе Android SDK, однако если вы не хотите устанавливать SDK, клиент можно получить и отдельно. Архив с клиентами для Windows, Mac и Linux можно получить, например, здесь. Просто распакуйте этот архив на диск C: в Windows или в домашний каталог в Linux. Если вы работаете в Windows не забудьте установить все необходимые драйверы (обычно они устанавливаются автоматически при первом подключении смартфона/планшета с помощью USB-кабеля).
Теперь подключите устройство к USB и включите на нем режим отладки (Настройки — Для разработчиков — Отладка по USB). Откройте консоль (Пуск — Выполнить — сmd — Enter в Windows), перейдите и наберите следующие команды для проверки успешности соединения ADB-клиента с сервером:
cd c:\adb_fastboot
adb-windows.exe devices
Если все в порядке на экран должно быть выведено что-то вроде таких строк:
List of devices attached
0146A0D016016010 device
Сразу рекомендую переименовать файл adb-windows.exe в adb.exe для удобства (в дальнейшем я буду использовать именно такой вариант названия, тем более что в SDK он такой).
Установка и удаление приложений
С помощью ADB достаточно удобно устанавливать и удалять приложения со смартфона/планшета. Для этого предусмотрены команды “adb install” и “adb uninstall”. Так, например, чтобы установить пакет на смартфон, выполните такую команду в той же консоли:
Чтобы установить приложение на карту памяти добавьте ключ -s:
adb install -s c:/пакет.apk
Для удаления приложения используйте такую команду:
Обратите внимание, что следует использовать системное имя приложения, которое можно узнать просмотрев информацию о нужном приложении на смартфоне, либо получить список всех установленных приложений выполнив такую команду:
И уже из него выбрать необходимое.
Копирование файлов и синхронизация каталогов
Кроме установки и удаления пакетов вы также можете перемещать файлы и целые каталоги между компьютером и картой памяти устройства. Так, например, чтобы переместить папку c:/music на карту памяти достаточно выполнить такую команду:
adb push c:/music /sdcard
А чтобы получить папку с фотографиями с карты памяти — такую:
adb pull /sdcard/DCIM/Camera c:/
Однако, самое полезное применение ADB это синхронизация папок между компьютером и смартфоном. Допустим у вас есть папка c:/music, в которую вы постоянно добавляете новую музыку и хотели бы чтобы добавленная недавно музыка перекочевала на смартфон без необходимости копирования всей музыки, половина которой уже есть на смартфоне. Нет ничего проще, воспользуйтесь синхронизацией:
adb sync c:/music /sdcard/Music
Выход в интернет через смартфон
Еще одна очень интересная функция ADB это возможность проброса сетевых портов или, говоря на человеческом языке, возможность сделать так, чтобы выход в интернет происходил через смартфон. Да, для этого есть функция WiFi hotspot и различные приложения вроде PDANet, однако метод с использованием ADB поможет в случае экстренной ситуации, когда под рукой кроме смартфона и ADB нет ничего.
Чтобы воспользоваться этой функцией запустите ADB в режиме проброса портов:
adb forward tcp:8080 tcp:8080
Затем установите на смартфон и запустите приложение Proxoid и настройте браузер настольной машины на использование прокси по адресу “localhost:8080”.
Это все. Теперь выход в интернет будет происходить через смартфон. Сразу оговорюсь, что HTTPS-сайты работать не будут, поэтому получить доступ, например, к Gmail не получиться.
Бэкап и восстановление приложений и настроек
Современные версии ADB кроме всего перечисленного поддерживают также функцию бэкапа и восстановления установленных приложений и их настроек, что может пригодится при обнолвении прошивки или при экспериментах. Воспользоваться функцией очень просто. Чтобы сделать бэкап всех приложений и настроек достаточно выполнить следующую команду:
adb backup -f c:\\backup -apk -all
Все настройки и приложения будут сохранены в файл c:\backup. Для его восстановления достаточно выполнить такую команду:
Другие функции
Что еще можно сделать с помощью ADB? Например, получить доступ к консоли Android:
Имеет смысл использовать только в том случае, если вы знаете что это такое.
С помощью ADB также можно принудительно перезагрузить устройство:
Чтобы перезагрузиться в консоль восстановления используйте такую команду:
ADB по сети
Сервер ADB может работать и в сетевом режиме, когда вместо USB-кабеля для доступа к устройству используется локальная WiFi-сеть. В целях безопасности в стандартных прошивках сетевой режим отключен, но в таких прошивках как CyanogenMod, AOKP и других его можно активировать через настройки. А если получить root то и в любой прошивке с помощью бесплатного приложения WiFi ADB. Просто установите его, нажмите кнопку “Turn On” и наберите в консоли Windows строку, которая появится на экране, например:
adb connect 192.168.0.101:5555
Далее можно использовать все стандартные команды ADB
Выводы
ADB очень мощный инструмент, а если в придачу к нему вы изучите консоль Android, то сможете делать со своим смартфоном все, что угодно. Кстати, чтобы не вбивать все указанные в статье команды в консоли, можно создать несколько скриптов (текстовых файлов с расширением .bat) и добавить в них нужные команды. Тогда для запуска команд придется просто кликнуть по скрипту.
ADB (Android Debug Bridge) – консольная клиент-серверная программа, выполняет роль универсального интерфейса для управления Android-устройствами (или их эмуляторами).
Через ADB программы на компьютере можно взаимодействовать с телефоном или планшетом, например для синхронизации контактов, бэкапов данных или удаленного доступа к устройству.
Однако главное назначение ADB – это отладка приложений и сервисов при их разработке и тестировании. В этом случае взаимодействие с устройством осуществляется через консоль.
Возможности ADB:
- просмотр подключенных устройств;
- просмотр логов;
- копирование файлов;
- установка и удаление приложений;
- скриншоты (и запись видео) экрана устройства;
- удаление и перепрошивка раздела data;
- запуск различных скриптов;
- управление сетевыми параметрами.
В состав ADB входит три компонента:
- клиент, который запускается на компьютере и отправляет команды. Его можно вызвать его из командной строки, введя команду adb;
- демон, который запускается как фоновый процесс на Android-устройстве и выполняет команды клиента;
- сервер, который работает в фоне на компьютере и управляет клиентом и демоном.
Как работает ADB:
- при запуске adb-клиент проверяет наличие запущенного процесса adb-сервера, и если нет – запускает его на компьютере;
- сервер устанавливает соединение на порту 5037 и слушает на нем команды от adb- клиентов;
- затем сервер устанавливает соединения со всеми работающими устройствами, сканируя нечетные порты в диапазоне от 5555 до 5585. Для каждого устройства используется пара последовательных портов – порт с четным номером для соединений консоли, порт с нечетным номером – для соединений adb;
- после того как сервер настроил соединения с устройствами, можно использовать команды adb для доступа к ним.
Подготовка к использованию
Прежде чем начать отладку на устройстве, необходимо выполнить несколько действий:
- установить ADB на компьютере (драйвер для вашего Android-устройства, а так же пакет Android SDK Platform Tools);
- на Android-устройстве включить отладку по USB, а затем подключить его к компьютеру кабелем (или настроить отладку по Wi-Fi).
На устройствах под управлением Windows, установите драйвер для вашего Android-устройства.
Драйвера для устройств Google
OEM USB драйвера сторонних производителей
Если драйвера для вашего устройства не нашлось на указанных страницах, попробуйте поискать его на сайте производителя.
Для MacOS и Linux установка драйверов не требуется.
Далее потребуется установить Android SDK Platform Tools. Если вы используете Android Studio, скорее всего SDK Platform Tools у вас уже установлен.
Установка ADB в Windows
Скачайте SDK Platform Tools и распакуйте папку platform-tools на диск (рекомендуется в С:\platform-tools).
В системную переменную Path добавьте путь к распакованной папке, для этого:
- перейдите в Панель управления – Система и безопасность – Система;
- выберите пункт Дополнительные параметры системы;
- нажмите кнопку Переменные среды;
- в поле Системные переменные выберите значение Path и нажмите кнопку Изменить, чтобы добавить новое значение;
- укажите путь к папке platform-tools содержащую adb;
- перезагрузите компьютер.
Установка ADB в Linux
Чтобы установить SDK Platform Tools в Ubuntu выполните следующую команду.
apt-get install adb
или
sudo apt-get install android-tools-adb
Либо вручную скачать SDK Platform Tools, распаковать на диск и добавить путь к распакованной папке с platform-tools в переменную среды $PATH.
Установка ADB в MacOS
Самый простой способ установить SDK Platform Tools на MacOS, используя Homebrew.
brew cask install android-platform-tools
Либо установить вручную.
Сперва удалите предыдущую версию android-platform-tools, если такая имеется.
rm -rf ~/.android-sdk-macosx/
Затем скачайте SDK Platform Tools.
Перейдите в папку с загрузками, распакуйте скачанный архив и переместите файлы программы в удобное для вас место, например в домашнюю директорию.
cd ~/Downloads/ unzip platform-tools_*.zip mkdir ~/.android-sdk-macosx mv platform-tools/ ~/.android-sdk-macosx/platform-tools
Добавить путь к platform-tools в переменную среды $PATH.
echo 'export PATH=$PATH:~/.android-sdk-macosx/platform-tools/' >> ~/.bash_profile
Обновите bash профиль или перезапустите терминал.
source ~/.bash_profile
Проверка ADB
Зайдите в консоль и введите следующую команду:
adb version
Если все сделали верно, в ответ в консоль будет выведена информация о версии ADB.
Как включить отладку по USB на Android
Отладка по USB включается в настройках системы в разделе Параметры разработчика.
На Android 4.2 и выше раздел параметров разработчика по умолчанию скрыт. Чтобы сделать его видимым, перейдите в Настройки – О телефоне и нажмите Номер сборки (в редких случаях Номер модели) 7 раз (в редких случаях 10). На экране отобразится уведомление «Теперь вы разработчик!«
В настройках должен появиться пункт меню Параметры разработчика, найдите в нем пункт Отладка USB и активируйте его.
На некоторых устройствах раздел с параметрами разработчика может располагаться в других разделах настроек или иметь другое название.
Подробнее о параметрах разработчика на устройствах Android можно ознакомится на developer.android.com.
Отладка Android по Wi-Fi
Для начала разрешите на Android устройстве отладку по USB, как описано в предыдущем разделе.
Устройство и компьютер должны быть в одной Wi-Fi сети. Убедитесь, что ваш брандмауэр или антивирусное не блокирует adb соединения.
Подключите устройство к компьютеру с помощью USB кабеля.
Разрешите устройству принимать соединения TCP/IP через порт 5555. Для этого выполните в командной строке следующую команду.
adb -d tcpip 5555
Параметр -d отправит команду только на устройство подключенное через USB.
В ответ должно появиться сообщение restarting in TCP mode port: 5555.
Если подключенных устройств несколько, возможно придется дополнительно указать серийный номер устройства.
adb -s 9A301FFAZ00DQT tcpip 5555
Узнать серийный номер и получить информацию о подключенных устройствах можно следующей командой.
adb devices -l
После того, как разрешите устройству принимать соединения TCP/IP через порт 5555, отсоедините кабель USB от компьютера.
Далее понадобится узнать ip-адрес вашего Android-устройства.
Например, для устройств Nexus, ip-адрес можно посмотреть в разделе Настройки — О телефоне (О планшете) – Статус – IP-адрес. Иногда ip-адрес указан в настройках Wi-Fi.
Подключитесь к устройству по его ip-адресу.
adb connect device_ip_address
Убедитесь, что устройство появилось в списке.
adb devices
Теперь можно выполнять отладку по Wi-Fi, без использования кабеля.
Если соединение ADB потеряно. Убедитесь, что устройство и компьютер все еще подключены к одной Wi-Fi сети. Переподключитесь, выполнив adb connect снова. Или, если не поможет, перезагрузите хост adb:
adb kill-server
Затем повторите попытку.
После проделанных шагов вы сможете подключаться к устройству без использования USB-кабеля.
Команды ADB
Перед выполнением команд adb полезно знать, какие экземпляры устройств подключены к серверу adb. Список подключенных устройств можно посмотреть следующей командой.
adb devices -l
В ответ adb выведет серийный номер, состояние и описание (параметр -l) подключенных устройств.
В примере ниже показаны три устройства. Первые два — эмуляторы, третье — аппаратное устройство, подключенное к компьютеру.
$ adb devices List of devices attached emulator-5556 device product:sdk_google_phone_x86_64 model:Android_SDK_built_for_x86_64 device:generic_x86_64 emulator-5554 device product:sdk_google_phone_x86 model:Android_SDK_built_for_x86 device:generic_x86 0a388e93 device usb:1-1 product:razor model:Nexus_7 device:flo
Если запущен только один эмулятор или подключено только одно устройство, команда adb отправится на это устройство по умолчанию. Если же запущено несколько эмуляторов и / или устройств, необходимо использовать параметры -d, -e или -s, чтобы указать устройство, на которое должна быть направлена команда.
Нижеприведенная команда отправится на устройство с указанным серийным номером.
adb -s серийный_номер_устройства
Команда отправится только на устройство подключенное через USB. Выдаст ошибку, если подключено больше одного устройства.
adb -d
Команда отправится на устройство в эмуляторе. Выдаст ошибку, если подключено больше одного эмулятора.
adb -e
Подсоединиться к андроид хосту по протоколу TCP/IP (по умолчанию порт 5555, если не указан другой).
adb connect хост:порт
Отсоединиться от андроид подключенного через TCP/IP (по умолчанию порт 5555). Если не задан ни один параметр, отключиться от всех активных соединений.
adb disconnect хост:порт
Перезапуск демона с правами root.
adb root
В некоторых случаях может потребоваться остановить сервер adb, и перезапустить его, чтобы решить проблему (например, если adb не отвечает на команды).
Остановить сервер.
adb kill-server
Запустить сервер.
adb start-server
Копировать файл или папку на устройство.
adb push "путь на PC" "путь на андроид"
Например,
adb push foo.txt /sdcard/foo.txt
Копировать файл или папку с устройства на компьютер.
adb pull "путь на андроид" "путь на PC"
Копировать с компьютера на устройство только новые файлы. С ключом -l не копировать, только создать список.
adb sync каталог
Установить приложение на устройство.
adb install [-l] [-r] [-s] название_приложения.apk
Например,
adb -s 9A301FFAZ00DQT install ~/Downloads/mobyandex-master-arm_6_45.apk
Ключи:
-l блокировка приложения;
-r переустановить приложение, с сохранением данных;
-s установить приложение на карту памяти.
Чтобы удалить приложение с устройства используйте следующую команду.
adb uninstall [-k] название_приложения.apk
Ключ -k означает, не удалять сохраненные данные приложения и пользователя.
Сделать скриншот экрана устройства.
adb shell screencap /sdcard/screen.png
Полученный скриншот можно сразу забрать на компьютер.
adb pull /sdcard/screen.png
Для записи видео с экрана устройства используйте команду screenrecord.
adb shell screenrecord /sdcard/demo.mp4
или с параметрами
adb shell screenrecord --size 1920x1080 --bit-rate 6000000 --time-limit 20 --verbose /sdcard/video.mp4 adb pull /sdcard/video.mp4
Чтобы остановить запись используйте комбинацию клавиш Control + C (Command + C на Mac). По умолчанию максимальный лимит для видео составляет 3 минуты.
С полным списком команд adb можно ознакомиться на сайте developer.android.com.
ADB LogCat
Logcat — инструмент для работы с логами Android.
В простейшем случае, чтобы вывести журнал системных сообщений устройства используйте следующую команду.
adb logcat
или через shell
adb shell # logcat
Для остановки сбора логов нажмите Ctrl+C на клавиатуре (Command + C на Mac).
Чтобы вывести лог на экран и выйти из logcat используйте параметр -d.
В записях лога в Android указан приоритет:
- V — verbose (низший приоритет);
- D — debug;
- I — info;
- W — warning;
- E — error;
- F — fatal;
- S — silent (наивысший приоритет, ничего не выводится).
Фильтровать сообщения по приоритету можно следующим образом.
adb logcat '*:W'
Кроме приоритета у записей указан тэг компонента системы, от которого принято сообщение.
В дополнение к тэгу и приоритету в логе так же содержатся поля с метаданными. Формат можно изменять с помощью параметра -v, за которым следует один из нижеперечисленных форматов вывода:
- brief — показывать приоритет, тэг и PID процесса (формат по умолчанию);
- process — показывать только PID;
- tag — показывать только приоритет, тэг;
- thread — показывать только процесс, поток и приоритет, тэг;
- raw — показать необработанное сообщение, без полей метаданных;
- time — показывать дату, время вызова, приоритет, тэг и PID процесса;
- long — показывать все поля метаданных и отдельно сообщения с пустыми строками.
adb logcat -v thread -d > C:\logcat.txt
Список параметров команды logcat:
-d вывести лог на экран и выйти;
-b загрузить альтернативный буфер лога для просмотра, такой как event или radio;
-c очистить лог и выйти;
-f записать сообщения лога в файл. По умолчанию в stdout;
-g вывести размер указанного буфера лога и выйти;
-n установить максимальное количество ротаций лога;
-s устанавливает silent фильтром по умолчанию;
-v устанавливает формат вывода сообщений лога. По умолчанию brief.
С полным списком команд logcat можно ознакомиться на сайте developer.android.com.
ADB Shell
Android полноценная система Unix со своим Shell, к которому можно подключаться по adb.
adb shell
или
adb [-d | -e | -s serial_number] shell
Команда подключит ваш терминал к shell устройства и вы сможете взаимодействовать с ним используя Unix команды, cat, ls, df и другие, а также запускать скрипты.
Чтобы выполнить одну команду, не переходя в shell используйте команду оболочки следующим образом.
adb shell shell_command
Например,
adb shell df
Команда выше выдаст информацию о количестве свободной памяти на устройстве.
Следующая команда откроет на устройстве экран с настройками.
adb shell am start -a android.settings.SETTINGS
А две последующие через ADB включают и отключают соответственно прокси в настройках сети.
adb shell settings put global http_proxy 192.168.1.10:8888 (тут ip и порт вашего прокси) adb shell settings put global http_proxy :0 (отключает прокси)
Данные команды могут быть полезными, когда к настройкам устройства нет явного доступа, например на устройствах с голосовыми интерфейсами. Я часто пользуюсь ими при отладке Яндекс.Станции.
Полезные ссылки
Android Debug Bridge
Что такое ADB
Утилита Android Debug Bridge
Run apps on a hardware device
SDK Platform Tools
Configure on-device developer options
Logcat command-line tool
Set up ADB on Mac OS X
На этом всё. Но вы можете поддержать проект. Даже небольшая сумма поможет нам писать больше полезных статей.
Если статья помогла или понравилась, пожалуйста поделитесь ей в соцсетях.