Android Debug Bridge (ADB) — это инструмент командной строки, входящий в состав Android SDK⁠. Это основной инструмент взаимодействия с гарнитурами Meta Quest на всех этапах разработки. ADB — чрезвычайно гибкий инструмент, необходимый для установки приложений и передачи других важных команд с компьютера на гарнитуру.

Это руководство содержит описание общих действий. Рекомендуем также ознакомиться с официальной документацией для Android⁠.

Чтобы получить список доступных команд и параметров, проверьте, установлен ли инструмент ADB, и введите следующую команду:

adb help

Подключение к устройству с помощью ADB

Оболочка ОС позволяет подключаться к устройству Android и взаимодействовать с ним как напрямую через порт USB, так и через соединение TCP/IP по Wi-Fi.

Если используется порт USB, подключите устройство к ПК с помощью совместимого USB-кабеля. После подключения откройте оболочку ОС и введите:

adb devices

Если устройство подключено правильно, ADB выведет список идентификаторов устройств, например:

List of devices attached
    ce0551e7                device

Вы не сможете использовать ADB, если устройство не обнаружено. Если вашего устройства нет в списке, скорее всего, проблема в том, что не установлен соответствующий драйвер USB (см. статью Драйверы для Oculus ADB). Проверьте также, включен ли на вашем устройстве режим разработчика в мобильном приложении Meta Horizon. В некоторых случаях проблемы с подключением можно решить, если использовать другой USB-кабель или порт.

Подключение ADB по Wi-Fi

Как правило, подключение к устройству через порт USB работает быстрее, чем через соединение TCP/IP, однако в некоторых случаях соединение TCP/IP незаменимо.

Для подключения через TCP/IP сначала убедитесь, что устройство уже подключено через порт USB, а затем введите следующую команду, чтобы определить его IP-адрес:

adb shell ip route

Полученный результат должен выглядеть примерно так:

10.0.30.0/19 dev wlan0  proto kernel  scope link  src 10.0.32.101

IP-адрес устройства указан после текста src. Используя этот IP-адрес и порт (обычно 5555), введите следующие команды:

adb tcpip <port>
adb connect <ipaddress>:<port>

Пример:

> adb tcpip 5555
    restarting in TCP mode port: 5555
> adb connect 10.0.32.101:5555
    connected to 10.0.32.101:5555

После этого устройство можно отключить от порта USB. Пока в adb devices выводится только одно устройство, все команды ADB будут отправляться на это устройство по Wi-Fi.

Чтобы прекратить работу с подключением по Wi-Fi, выполните следующую команду ADB в оболочке ОС:

adb disconnect

Установка приложений с помощью ADB

Чтобы установить APK на гарнитуру, выполните следующую команду:

adb install <APK_PATH>

Например, в Windows:

adb install C:\Dev\Android\MyProject\VrApp.apk

В macOS:

adb install ~/Dev/Android/MyProject/VrApp.apk

Используйте параметр -r, чтобы перезаписать существующий файл APK с таким же именем, уже установленный на целевом устройстве.

adb install -r <APK_PATH>

Примечание. Установка приложений с помощью adb install обходит обычный путь установки Quest. Инструмент резервного копирования в облако не зарегистрирует приложения, установленные таким образом, и не будет создавать для них резервные копии данных.

Подробнее см. в разделе Установка приложения⁠ руководства по Android Debug Bridge для Android.

Устранение неполадок подключения

Ниже описаны возможные решения распространенных проблем, возникающих при подключении с использованием ADB.

Компьютер не может обнаружить устройство

Причин, по которым компьютер не может обнаружить гарнитуру, может быть много. Ниже перечислены некоторые варианты.

Убедитесь, что вы включили режим разработчика в приложении-компаньоне Meta Quest на мобильном телефоне.

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

Убедитесь, что компьютер имеет все необходимые разрешения для доступа к гарнитуре. Обычно при подключении устройства к компьютеру через USB-кабель появляется запрос на разрешение доступа компьютера к устройству. Если по ошибке вам не было предоставлено разрешение, отключите USB-кабель, перезагрузите устройство, а затем вновь подключите кабель. Когда появится запрос разрешения, выберите Allow (Разрешить).

На некоторых устройствах подключение во время работы VR-приложения или ожидания устройства ADB может помешать правильному обнаружению устройства. В таких случаях попробуйте завершить работу приложения и остановить ADB, нажав Ctrl-C, а затем вновь подключить устройство. Кроме того, службу ADB можно остановить следующей командой, после чего служба ADB автоматически перезапустится:

adb kill-server

Терминал возвращает ошибку: команда `adb` не найдена

Для начала проверьте, правильно ли установлен adb. Перейдите в папку /Android/SDK/platform-tools/ и проверьте наличие инструмента adb. Если инструмент отсутствует, скачайте отдельный пакет Android SDK Platform-Tools⁠.

Проверьте, правильно ли вы установили переменные окружения.

Вы можете запустить adb из папки /Android/SDK/platform-tools/, добавив к команде adb префикс ./. Например, вместо adb devices используйте ./adb devices.

Одновременно подключены несколько устройств

Можно подключить сразу несколько устройств, что часто бывает полезно для отладки клиент-серверных приложений. Имейте в виду: если одно и то же устройство одновременно подключено по Wi-Fi и через USB, ADB покажет его как два устройства. Если в списке несколько устройств, ADB необходимо указать, на какое устройство ориентироваться. Это можно сделать с помощью ключа -s. Например, adb devices показывает следующее:

List of devices attached
    ce0551e7                device
    10.0.32.101:5555        device

Перечисленные устройства могут быть двумя отдельными или одним устройством, которое подключено как по Wi-Fi, так и через USB (возможно, для зарядки аккумулятора). В этом случае все команды ADB должны иметь следующий вид, где <device id> — идентификатор, который сообщает adb devices: