Тестирование с помощью настольного головного устройства

Головное устройство настольного компьютера (DHU) позволяет вашей машине разработки эмулировать головное устройство Android Auto, чтобы вы могли запускать и тестировать приложения Android Auto. DHU работает в системах Windows, macOS и Linux.

После установки DHU вы можете протестировать свои приложения Android Auto, подключив к нему свое мобильное устройство с помощью одного из поддерживаемых механизмов подключения, описанных в разделе «Запуск DHU» .

Чтобы сообщить об ошибках или запросить функции, связанные с DHU, используйте систему отслеживания проблем .

Установите DHU

Выполните следующие действия, чтобы установить DHU на вашу машину разработки:

1. Включите режим разработчика на мобильном устройстве под управлением Android 9 (уровень API 28) или более поздней версии, как описано в разделе Настройка параметров разработчика на устройстве .
2. Скомпилируйте и установите приложение на устройство.
3. Установите Android Auto на устройство. Если Android Auto уже установлен, убедитесь, что вы используете последнюю версию.
4. В Android Studio откройте диспетчер SDK и перейдите на вкладку «Инструменты SDK» , затем загрузите пакет эмулятора головного устройства Android Auto Desktop .

DHU устанавливается в каталог SDK_LOCATION /extras/google/auto/ .

1. В системах Linux или macOS выполните следующую команду в этом каталоге, чтобы убедиться, что двоичный файл DHU является исполняемым:

   chmod +x ./desktop-head-unit
   

Дополнительные шаги для Linux

Если вы используете DHU версии 2.x в системе Linux, вам необходимо установить некоторые дополнительные библиотеки. Бинарный файл DHU зависит от GLIBC версии 2.32 или выше. Вы можете проверить версию GLIBC вашей системы, выполнив эту команду:

ldd --version

Если версия ниже 2.32, обновите GLIBC до 2.32 или выше, что может потребовать обновления ОС до версии, совместимой с GLIBC 2.32 или выше.

Вам также необходимо установить библиотеки libc++1 и libc++abi1 . Процедура установки зависит от вашего дистрибутива Linux. Например, в дистрибутивах Linux, производных от Debian, вы можете установить библиотеки с помощью этой команды:

sudo apt-get install libc++1 libc++abi1

Установите предварительные версии DHU.

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

Запустите DHU

После установки DHU вы можете протестировать приложения Android Auto, подключив мобильное устройство и рабочую станцию ​​через USB. Запустите DHU, подключив мобильное устройство к машине разработки, используя режим аксессуаров (рекомендуется для DHU 2.x) или туннелирование ADB .

Подключитесь в режиме аксессуаров

Android Auto поддерживает подключение к DHU версии 2.x по протоколу Android Open Accessory (AOA) с помощью следующей команды:

./desktop-head-unit --usb

По умолчанию DHU просматривает список доступных USB-устройств и пытается подключиться к первому совместимому устройству. Чтобы настроить таргетинг на конкретное устройство, включите идентификатор устройства в команду --usb следующим образом:

./desktop-head-unit --usb=[DEVICE_ID]

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

Этот метод требует настройки соединения с сервером головного устройства Android Auto через Android Debug Bridge ( adb ) . Выполните следующие шаги, чтобы настроить туннелирование и запустить DHU:

1. Включите режим разработчика Android Auto, если это еще не сделано.

2. Если сервер головного устройства еще не запущен, откройте дополнительное меню и выберите «Запустить сервер головного устройства» , как показано на рисунке 1.

   На устройстве в области уведомлений появляется служба переднего плана, которая указывает на то, что сервер запущен, как показано на рисунке 2.

   

   Рисунок 1. Контекстное меню с опциями разработчика.

   

   Рисунок 2. Уведомление о том, что сервер головного устройства работает.

3. В приложении Android Auto нажмите «Ранее подключенные автомобили» в верхней части настроек и убедитесь, что параметр «Добавление новых автомобилей в Android Auto» включен.

4. Подключите мобильное устройство к машине разработки с помощью USB.

5. Убедитесь, что экран мобильного устройства разблокирован, чтобы можно было запустить DHU.

6. На компьютере разработки выполните следующую команду adb , чтобы перенаправить сокетные соединения с порта 5277 компьютера разработки на тот же номер порта на устройстве Android. Эта конфигурация позволяет DHU подключаться к серверу головного устройства, работающему на мобильном устройстве, через TCP-сокет.

   adb forward tcp:5277 tcp:5277
   

7. Запустите DHU, выполнив команду desktop-head-unit.exe в Windows или ./desktop-head-unit в macOS или Linux из каталога SDK_LOCATION /extras/google/auto/ :

   cd SDK_LOCATION/extras/google/auto
   desktop-head-unit.exe # Windows
   ./desktop-head-unit # macOS or Linux
   

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

После запуска DHU вы можете использовать консольные команды DHU для запуска и тестирования вашего приложения.

Параметры командной строки

По умолчанию сервер головного устройства подключается через порт 5277. Чтобы переопределить хост или порт, используйте флаг --adb=<[localhost:]port> , как показано в следующем примере:

./desktop-head-unit --adb=5999

По умолчанию DHU эмулирует головное устройство, совместимое с Android Auto, с пользовательским интерфейсом с сенсорным экраном. Имитируйте прикосновения пользователя, щелкая DHU мышью. Чтобы эмулировать головные устройства, которые используют поворотный контроллер для ввода, вы можете использовать -i rotary , как показано в следующем примере:

./desktop-head-unit -i controller

Когда DHU находится в режиме поворотного контроллера, вы можете использовать сочетания клавиш для имитации операций контроллера. Более подробную информацию см. в разделе «Поворотный контроллер» . В режиме поворотного контроллера DHU игнорирует щелчки мыши. Вы должны использовать Android Auto с имитацией операций поворотного контроллера.

Другие параметры командной строки для DHU перечислены в следующей таблице:

Руководство пользователя DHU

В этом разделе описаны функции, поддерживаемые DHU, и способы их использования.

Команды вводятся в окне терминала, где вы запустили DHU. Несколько команд можно запускать в одной строке, разделив их знаком ; .

Система

Сенсорный экран и тачпад

Если сенсорный экран или сенсорная панель включены , щелчок в окне дисплея для сенсорного экрана или в окне сенсорной панели для сенсорной панели регистрируется как событие касания.

Для сенсорного управления имитируйте мультитач, щелкнув правой кнопкой мыши место первого пальца, а затем нажав и удерживая правую кнопку второго пальца. Центральная точка двух пальцев остается фиксированной; перемещение мыши позволяет вращать их вокруг центра, сжимать и разводить или и то, и другое.

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

Поворотный контроллер

DHU имеет поддержку поворотного контроллера. Когда он включен , поддерживаются следующие действия:

• Нажатие вверх, вниз, влево и вправо на D-pad
• Вращение по часовой стрелке и против часовой стрелки
• Выполнение вращения (пять шагов одновременно)
• Нажатие вниз и обратно на контроллер

Команды и привязки клавиш перечислены в следующей таблице.

Колесо прокрутки мыши отправляет команды dpad rotate , а щелчок средней кнопки мыши (обычно колесо прокрутки) отправляет команды dpad click .

Обратите внимание, что большинство автомобилей имеют сенсорные экраны. Некоторые автомобили имеют только поворотные контроллеры, а некоторые — гибридный сенсорный и контроллер. Автомобили также могут поддерживать сенсорную панель, которую можно использовать для панорамирования карты и ввода текста. Помните об этих различных конфигурациях при моделировании различных головных устройств транспортных средств.

Микрофон

DHU поддерживает использование микрофона для голосового ввода или воспроизведения предварительно записанной голосовой дорожки. Для удобства в комплект DHU включены следующие звуковые файлы для общих голосовых команд. Эти звуковые файлы расположены в каталоге SDK_LOCATION /extras/google/auto/voice/ .

Чтобы запустить отдельный файл .wav в командной строке DHU, используйте следующую команду:

mic play /path/to/filename.wav

В следующей таблице перечислены другие команды, связанные с микрофоном:

Датчики

DHU поддерживает моделирование изменений в данных датчиков автомобиля с помощью следующих команд. Чтобы имитировать данные датчиков и отправить их в Android Auto, соответствующие датчики необходимо включить с помощью используемого файла конфигурации .ini при запуске DHU.

Дневной и ночной режимы

DHU поддерживает имитацию переключения между дневным и ночным режимом с помощью следующих команд и привязок клавиш:

Управление фокусом

DHU поддерживает имитацию того, фокусируется ли Android Auto на головном устройстве, с помощью следующих команд:

Ограничения и статус вождения

DHU поддерживает имитацию определенных ограничений во время движения автомобиля, например отключение клавиатуры и запрет конфигурации телефона, с помощью следующих команд:

Приборный щиток

DHU поддерживает эмуляцию комбинации приборов. Этот кластер обычно находится за рулевым колесом и во время навигации отображает основную информацию о следующем повороте, например название следующей дороги или стрелку поворота, расстояние или время. Он также отображает информацию о текущих телефонных звонках.

Это можно включить с помощью записи instrumentcluster в разделе [general] файла конфигурации или с помощью записей navcluster или phonecluster для управления каждой функцией отдельно.

[general]
...
instrumentcluster = true

Кластерный дисплей

Некоторые автомобили имеют кластерные дисплеи, способные отображать обширную визуальную информацию, например фрагменты карты. Начиная с версии 2.1 DHU (в настоящее время доступной через канал обновления бета-версии Android Studio ), вы можете эмулировать такое отображение на своей машине разработки.

Это можно сделать с помощью файла конфигурации с разделом кластера [display] . Разделы [display] поддерживают те же параметры конфигурации видео , что и основной дисплей, настроенный в разделе [general] файла.

...

# The display name following the colon can be whatever you like.
[display:cluster]
# Setting the displaytype as cluster is what lets the DHU know how to handle it.
displaytype = cluster
resolution = 800x480
dpi = 160
...

Эту конфигурацию можно либо добавить непосредственно в существующий файл .ini , либо использовать ее повторно, поместив в отдельный файл и передав несколько файлов конфигурации при запуске DHU. При использовании нескольких файлов конфигурации более поздние определения данного значения переопределяют предыдущие.

# Launch your landscape configuration with your cluster display configuration
./desktop-head-unit -c landscape.ini -c cluster.ini

# Launch the portait configuration with the same cluster display configuration
./desktop-head-unit -c portrait.ini -c cluster.ini

Статус воспроизведения мультимедиа

DHU поддерживает отображение дополнительной информации для отображения статуса воспроизведения мультимедиа, например, какая дорожка воспроизводится.

Это можно включить с помощью записи playbackstatus в разделе [general] .

[general]
...
playbackstatus = true

Коды клавиш

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

keycode home

В следующей таблице перечислены другие доступные коды клавиш:

Настройка DHU

DHU поддерживает файл конфигурации .ini для изменения режимов ввода между сенсорным и поворотным контроллером, а также для установки частоты кадров, разрешения и DPI, запрашиваемых головным устройством с телефона.

Местоположение файла конфигурации по умолчанию — ~/.android/headunit.ini . Чтобы изменить конфигурацию головного устройства в вашей системе, вы можете изменить этот файл.

Вы также можете указать файл конфигурации для загрузки, используя флаг -c :

./desktop-head-unit -c /path/to/config.ini

В следующем фрагменте показан пример конфигурации:

[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30
fueltypes = unleaded,electric,hydrogen
evconnectors = supercharger

Примеры файлов конфигурации, демонстрирующие различные настройки головного устройства, которые вы можете протестировать, находятся в папке SDK_LOCATION /extras/google/auto/config/ . Для более сложных случаев использования обратитесь к следующим поддерживаемым настройкам.

Конфигурация входа

В следующей таблице перечислены параметры конфигурации входа:

Конфигурация видео

Android Auto поддерживает три разрешения видео:

• 480p (800x480, по умолчанию)
• 720p (1280x720)
• 1080p (1920x1080)

Для поддержки других соотношений сторон головное устройство может при необходимости указать поле для почтового ящика (столбового ящика). Например, если вам нужен экран 1000x600, установите разрешение 720p (1280x720), marginwidth 280 и marginheight 120. Это приведет к добавлению поля в 140 пикселей по левому и правому краям и поля по 60 пикселей по краю. верх и низ.

Следующий пример конфигурации имитирует типичный 6-дюймовый экран (750x450):

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

Следующий пример конфигурации имитирует очень широкий экран:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220

В следующей таблице перечислены другие параметры конфигурации видео:

Конфигурация датчика

Чтобы имитировать данные датчиков и отправлять их в Android Auto, соответствующие датчики необходимо включить, используя следующие параметры. Если датчик не включен, любые данные, отправленные для этого датчика с помощью команд DHU , игнорируются. Эту конфигурацию необходимо поместить в раздел [sensors] , а не в раздел [general] , используемый для большинства других конфигураций.

[general]
touch = true
...

[sensors]
location = true
fuel = true
...

Различные варианты конфигурации

В следующей таблице перечислены другие параметры конфигурации:

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

Иногда при первом подключении DHU показывает пустой экран. Вы можете обойти это, выполнив следующие действия:

1. Закройте ДХУ.
2. Выполните шаг 5, описанный в разделе «Запуск DHU», чтобы остановить и перезапустить сервер головного устройства.
3. Запустите DHU снова.
4. Предоставьте любые дополнительные разрешения, запрошенные на экране телефона. DHU может снова отключиться.
5. При необходимости перезапустите DHU.