ADB / Android Debug Bridge
Входит в Macro DeckУправляйте телефоном или планшетом Android по USB или Wi-Fi: будите его, запускайте приложения, нажимайте, вводите текст и делайте снимки экрана.
Вкладка «Обзор» интеграции ADB / Android Debug Bridge с уведомлением о том, что ADB нужно включить в настройках
- Пробуждение, блокировка и перезагрузка подключённого устройства Android
- Запуск и принудительная остановка приложений, открытие ссылок на устройстве
- Отправка клавиш, нажатий, свайпов и текста
- Сохранение снимков экрана устройства в папку
- События устройства и переменные для заряда, экрана и активного приложения
Интеграция ADB управляет телефонами и планшетами Android через Android Debug Bridge (ADB), тот же инструмент, которым пользуются разработчики Android. Macro Deck находит программу adb, запускает сервер ADB и отслеживает устройства, подключённые по USB или по Wi-Fi. Он также может сам скачать официальные Android platform-tools.
Каждое действие работает с устройством, выбранным в действии, или с устройством по умолчанию, если поле Устройство оставлено пустым. Устройство по умолчанию выбирается кнопкой Сделать по умолчанию в разделе Настройки > ADB, а если оно не выбрано, используется единственное подключённое устройство.
Что можно делать
- Экран и питание: будить устройство, выключать экран (так Android блокирует устройство) или перезагружать его в Android, recovery или загрузчик.
- Приложения и ссылки: запускать приложение или принудительно останавливать его по имени пакета, например
com.spotify.music, и открывать ссылку в приложении, которое выберет устройство. - Ввод: отправлять клавиши, например Home, Back, Volume Up или Media Play Pause, нажимать на точку экрана, проводить от одной точки к другой или вводить текст в активное поле.
- Снимки экрана: сохранять снимок экрана как файл PNG в папку на компьютере и при желании записывать путь к файлу в переменную.
Несколько примеров:
- Кнопка, которая будит планшет на столе и запускает музыкальное приложение.
- Кнопка, которая отправляет на телефон Media Play Pause.
- Автоматизация по триггеру Устройство подключено, которая открывает на планшете страницу дашборда, как только вы его подключите.
Состояние в реальном времени
Интеграция сообщает, когда устройство подключается, отключается, авторизуется, теряет авторизацию, становится недоступным или снова появляется в сети, поэтому цепочки действий и кнопки могут на это реагировать. Переменные содержат число подключённых и авторизованных устройств, а для устройства по умолчанию его модель, производителя, уровень заряда, включён ли экран, показан ли экран блокировки и какое приложение на переднем плане. Каждое авторизованное устройство также получает собственные переменные, названные по его модели. Пока интеграция включена, заряд каждого устройства Android также показывается в виджете «Батарея».
Основные действия (клавиши, нажатия, свайпы, текст, приложения, ссылки, перезагрузка и снимки экрана) продолжают работать, пока Macro Deck заблокирован, поэтому кнопка с таким действием работает и на заблокированном компьютере.
Что понадобится
- Macro Deck 3 в Windows, macOS или Linux
- Устройство Android с включённой отладкой по USB в разделе «Для разработчиков»
- USB-кабель с передачей данных или беспроводная отладка для подключения по Wi-Fi
- Android platform-tools (adb): Macro Deck может скачать их в разделе «Настройки > ADB»
- В Linux у вашего пользователя должен быть доступ к USB-устройству, обычно через правило udev
Настройка
Шаг 1: Включите интеграцию ADB
На боковой панели нажмите Интеграции, а затем ADB / Android Debug Bridge. Интеграция выключена, пока вы не включите переключатель в правом верхнем углу. После включения на странице показывается ADB выключен, пока вы не включите ADB на следующем шаге.
Шаг 2: Включите ADB в Macro Deck
Откройте Настройки > ADB и включите Включить ADB. Если в поле Программа ADB указано Не найдено, нажмите Скачать platform-tools. Установленный Android SDK или
adbв вашемPATHнаходятся автоматически, а в поле Путь к исполняемому файлу можно указать другой.Шаг 3: Включите отладку по USB на устройстве
На телефоне или планшете откройте Настройки > О телефоне и семь раз нажмите Номер сборки, чтобы включить раздел Для разработчиков. Затем включите Отладка по USB в разделе Настройки > Для разработчиков. Точное расположение немного отличается у разных производителей.
Шаг 4: Подключите и авторизуйте устройство
Подключите устройство USB-кабелем и подтвердите на его экране запрос Разрешить отладку по USB?. Отметьте Всегда разрешать отладку с этого компьютера, чтобы запрос больше не появлялся. После этого устройство появится в списке Устройства в разделе Настройки > ADB со статусом Готово. Чтобы подключиться по Wi-Fi, введите IP-адрес и порт устройства в поле Подключиться по Wi-Fi, например
192.168.1.20:5555.Шаг 5: Выберите устройство по умолчанию
Если подключено несколько устройств, нажмите Сделать по умолчанию рядом с тем, которое должны использовать действия с пустым полем Устройство. Единственное устройство используется автоматически.
Шаг 6: Добавьте действие ADB на кнопку
На странице Панель убедитесь, что панель разблокирована (кнопка в правом верхнем углу называется Заблокировать), и нажмите на кнопку. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите ADB / Android Debug Bridge и затем действие, например Разбудить устройство или Запустить приложение. Заполните его поля, например поле Пакет для действия Запустить приложение, и оставьте поле Устройство пустым, чтобы использовать устройство по умолчанию. Эта категория показывается, только пока интеграция включена.
Шаг 7: Нажмите кнопку
Нажмите Сохранить и нажмите кнопку на панели. Если ничего не происходит, проверьте уведомления в разделе Интеграции, например Устройства не подключены или сообщение об устройстве, которому нужна авторизация.
Действия11
Назначьте их на кнопку или запускайте из цепочки действий.
- Разбудить устройство
- Включает экран устройства.
- Усыпить / заблокировать экран
- Выключает экран устройства: так Android блокирует устройство.
- Запустить приложение
- Запускает приложение по имени пакета или выводит его на передний план.
- Принудительно остановить приложение
- Принудительно останавливает приложение по имени пакета.
- Открыть ссылку
- Открывает URI на устройстве, как при нажатии на ссылку.
- Ввести текст
- Вводит текст в активное поле на устройстве.
- Отправить клавишу
- Отправляет одно событие клавиши Android, например Home, Back, Volume Up или Media Next.
- Нажатие
- Нажимает на экран в заданных координатах X и Y.
- Свайп
- Проводит по экрану от одной точки до другой за заданное время.
- Перезагрузить устройство
- Перезагружает устройство в режим «Обычный», Recovery или «Загрузчик».
- Сделать снимок экрана
- Делает снимок экрана устройства и сохраняет его как файл PNG в папку, при желании записывая путь в переменную.
Триггеры6
Кнопка или цепочка действий может реагировать на эти события.
- Устройство подключено
- Устройство Android подключено или впервые обнаружено Macro Deck.
- Устройство отключено
- Устройство Android отключено или Macro Deck потерял его из виду.
- Устройство авторизовано
- Запрос авторизации на устройстве принят.
- Устройство больше не авторизовано
- Ранее авторизованному устройству нужно снова принять запрос авторизации.
- Устройство снова в сети
- Авторизованное устройство снова доступно.
- Устройство стало недоступно
- Устройство, которое было доступно, больше не отвечает.
Переменные11
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
adb_connected_device_count- Число подключённых устройств Android.
adb_authorized_device_count- Число устройств, которые в сети и авторизованы.
adb_device_connected- Подключено ли устройство по умолчанию.
adb_device_authorized- Авторизовало ли устройство по умолчанию этот компьютер.
adb_device_model- Модель устройства по умолчанию.
adb_device_manufacturer- Производитель устройства по умолчанию.
adb_device_battery_level- Уровень заряда устройства по умолчанию в процентах.
adb_device_screen_on- Включён ли экран устройства по умолчанию.
adb_device_locked- Показывает ли устройство по умолчанию экран блокировки.
adb_device_foreground_app- Имя пакета приложения на переднем плане на устройстве по умолчанию.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Подключение, авторизация, модель и уровень заряда каждого авторизованного устройства.
<device>означает модель устройства строчными латинскими буквами, цифрами и подчёркиваниями; для других устройств той же модели добавляется_2,_3и так далее.
Часто задаваемые вопросы
Нужны ли Android Studio или Android SDK?
Нет. Macro Deck нужна только программа adb из Android platform-tools. Нажмите Скачать platform-tools в разделе Настройки > ADB, и Macro Deck скачает официальный пакет от Google размером около 15 МБ для собственного использования. Существующая установка находится автоматически.
Можно ли управлять устройством по Wi-Fi?
Да. Включите беспроводную отладку на устройстве и введите его IP-адрес и порт в поле Подключиться по Wi-Fi в разделе Настройки > ADB. Macro Deck сам устройства не сопрягает: в Android 11 и новее сначала выполните сопряжение устройства с этим компьютером или переключите его в режим отладки по сети через USB с помощью adb tcpip. Иначе устройство отклонит подключение.
Почему действие завершается с ошибкой «устройство не найдено»?
Если поле Устройство пустое, действие использует устройство по умолчанию. Если вы его не выбрали и подключено несколько устройств, устройства по умолчанию нет, поэтому выберите устройство в действии или нажмите Сделать по умолчанию в разделе Настройки > ADB. Также проверьте, что у устройства статус Готово, а не Не авторизовано.
Есть ли отдельное действие для блокировки?
Нет. В Android нет отдельной команды блокировки. Усыпить / заблокировать экран выключает экран, и устройство блокируется так же, как при нажатии кнопки питания.
Влияет ли интеграция ADB на другие программы, которые используют ADB?
Macro Deck использует обычный сервер ADB, поэтому такие программы, как Android Studio, используют его совместно с Macro Deck. Перезапустить сервер ADB в разделе Настройки > ADB ненадолго отключает и их устройства. При выходе Macro Deck оставляет сервер запущенным, если не включено Останавливать сервер ADB при выходе из Macro Deck.
Почему у устройства написано «Нет доступа к этому устройству»?
У компьютера нет разрешения на связь с устройством по USB. В Linux установите правила udev из platform-tools, в Windows установите USB-драйвер производителя устройства.
Ещё в группе «Ваш компьютер»
Система
Входит в Macro DeckУправляйте компьютером с панели: приложения, громкость, команды, уведомления, спящий режим и выключение.
Клавиатура
Входит в Macro DeckНажимайте сочетания клавиш, вводите текст и выполняйте последовательности клавиш на компьютере одной кнопкой.
Мышь
Входит в Macro DeckЩёлкайте, перемещайте указатель, перетаскивайте и прокручивайте на компьютере одной кнопкой.
Steam
Входит в Macro DeckЗапускайте и закрывайте игры Steam и показывайте на панели, во что вы играете, своих друзей и библиотеку.