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

Настольное головное устройство (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 поддерживает поворотный контроллер. При его включении поддерживаются следующие действия:

• Нажатие кнопок вверх, вниз, влево и вправо на 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

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

Некоторые автомобили оснащены кластерными дисплеями, способными отображать разнообразную визуальную информацию, например фрагменты карты. Начиная с версии DHU 2.1 (в настоящее время доступной через канал обновления 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)

Для поддержки других соотношений сторон головное устройство может при необходимости задать поле для формата «почтовый ящик» (pillarbox). Например, если вам нужен экран размером 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.