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

Настольное головное устройство (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 Manager , перейдите на вкладку SDK Tools и загрузите пакет Android Auto Desktop Head Unit Emulator .

   

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

5. В системах 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 компьютера разработчика на тот же номер порта на мобильном устройстве. Эта конфигурация позволяет 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 поддерживает поворотный контроллер. При его включении поддерживаются следующие действия:

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

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

Колесо прокрутки мыши отправляет команды 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 Beta ), вы можете эмулировать такой дисплей на своем компьютере для разработки.

Это можно сделать с помощью конфигурационного файла с разделом [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. Закройте DHU.
2. Выполните шаг 5, описанный в разделе «Запуск DHU» , чтобы остановить и перезапустить сервер головного устройства.
3. Запустите DHU снова.
4. Предоставьте все дополнительные разрешения, запрошенные на экране телефона. Устройство DHU может снова отключиться.
5. При необходимости перезапустите DHU.