Test mit der Desktop-Haupteinheit

Mit der Desktop Head Unit (DHU) können Sie auf Ihrem Entwicklungscomputer ein Android Auto-Infotainmentsystem emulieren, um Android Auto-Apps auszuführen und zu testen. Das DHU kann unter Windows, macOS und Linux ausgeführt werden.

Nachdem Sie die DHU installiert haben, können Sie Ihre Android Auto-Apps testen, indem Sie Ihr Mobilgerät über einen der unterstützten Verbindungsmechanismen, die unter DHU ausführen beschrieben sind, damit verbinden.

Wenn Sie Fehler melden oder Funktionen für die DHU anfordern möchten, verwenden Sie die Problemverfolgung.

DHU installieren

So installieren Sie die DHU auf Ihrem Entwicklungscomputer:

1. Aktivieren Sie den Entwicklermodus auf einem Mobilgerät mit Android 9 (API-Level 28) oder höher, wie unter Entwickleroptionen auf dem Gerät konfigurieren beschrieben.
2. Kompilieren Sie Ihre App und installieren Sie sie auf dem Gerät.
3. Installieren Sie Android Auto auf dem Gerät. Wenn Android Auto bereits installiert ist, achten Sie darauf, dass Sie die aktuelle Version verwenden.

4. Öffnen Sie in Android Studio den SDK-Manager, rufen Sie den Tab SDK Tools auf und laden Sie das Paket Android Auto Desktop Head Unit Emulator herunter.

   

   Die DHU ist im Verzeichnis SDK_LOCATION/extras/google/auto/ installiert.

5. Führen Sie auf Linux- oder macOS-Systemen den folgenden Befehl in diesem Verzeichnis aus, um die DHU-Binärdatei ausführbar zu machen:

chmod +x ./desktop-head-unit

Zusätzliche Schritte für Linux

Wenn Sie DHU Version 2.x auf einem Linux-System ausführen, müssen Sie einige zusätzliche Bibliotheken installieren. Das DHU-Binärprogramm hängt von GLIBC Version 2.32 oder höher ab. Sie können die GLIBC-Version Ihres Systems mit diesem Befehl prüfen:

ldd --version

Wenn die Version niedriger als 2.32 ist, aktualisieren Sie GLIBC auf 2.32 oder höher. Dazu müssen Sie möglicherweise das Betriebssystem auf eine Version aktualisieren, die mit GLIBC 2.32 oder höher kompatibel ist.

Außerdem müssen Sie die Bibliotheken libc++1 und libc++abi1 installieren. Das Installationsverfahren hängt von Ihrer Linux-Distribution ab. Unter Debian-basierten Linux-Distributionen können Sie die Bibliotheken beispielsweise mit diesem Befehl installieren:

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

Vorabversionen des DHU installieren

Wenn Sie auf Vorabversionen von DHU zugreifen möchten, können Sie entweder eine Vorabversion von Android Studio verwenden oder den Update-Channel Ihrer vorhandenen Android Studio-Installation in den Betakanal ändern.

DHU ausführen

Nachdem Sie die DHU installiert haben, können Sie Ihre Android Auto-Apps testen, indem Sie Ihr Mobilgerät und Ihre Workstation über USB verbinden. Führen Sie das DHU aus, indem Sie Ihr Mobilgerät über den Zubehör-Modus (empfohlen für DHU 2.x) oder ADB-Tunneling mit einem Entwicklercomputer verbinden.

Verbindung über den Zubehör-Modus herstellen

Android Auto unterstützt die Verbindung zur DHU-Version 2.x über das Android Open Accessory (AOA)-Protokoll mit dem folgenden Befehl:

./desktop-head-unit --usb

Standardmäßig durchsucht das DHU die Liste der verfügbaren USB-Geräte und versucht, eine Verbindung zum ersten kompatiblen Gerät herzustellen. Wenn Sie ein bestimmtes Gerät als Ziel festlegen möchten, geben Sie die Geräte-ID als Teil des --usb-Befehls an:

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

Verbindung über ADB-Tunneling herstellen

Für diese Methode muss eine Verbindung zum Android Auto-Infotainmentsystemserver über die Android Debug Bridge (adb) eingerichtet werden. Führen Sie die folgenden Schritte aus, um das Tunneling einzurichten und die DHU auszuführen:

1. Aktivieren Sie den Android Auto-Entwicklermodus, falls er noch nicht aktiviert ist.

2. Wenn der Server für das Infotainmentsystem noch nicht ausgeführt wird, öffnen Sie das Dreipunkt-Menü und wählen Sie Server für Infotainmentsystem starten aus (siehe Abbildung 1).

   Auf dem Gerät wird im Benachrichtigungsbereich ein Dienst im Vordergrund angezeigt, der darauf hinweist, dass der Server ausgeführt wird (siehe Abbildung 2).

   

   Abbildung 1: Kontextmenü mit Entwickleroptionen.

   

   Abbildung 2: Benachrichtigung, dass der Server für das Infotainmentsystem ausgeführt wird.

3. Tippen Sie in der Android Auto App oben in den Einstellungen auf Zuvor verbundene Autos und prüfen Sie, ob Neue Autos zu Android Auto hinzufügen aktiviert ist.

4. Verbinden Sie das Mobilgerät über USB mit dem Entwicklungscomputer.

5. Achten Sie darauf, dass das Display des Mobilgeräts entsperrt ist, damit die DHU gestartet werden kann.

6. Führen Sie auf dem Entwicklungscomputer den folgenden adb-Befehl aus, um Socketverbindungen vom Port 5277 des Entwicklungscomputers zum selben Port auf dem Mobilgerät weiterzuleiten. Mit dieser Konfiguration kann das DHU über einen TCP-Socket eine Verbindung zum Head-Unit-Server auf dem Mobilgerät herstellen.

   adb forward tcp:5277 tcp:5277

7. Starten Sie die DHU, indem Sie unter Windows den Befehl desktop-head-unit.exe oder unter macOS oder Linux den Befehl ./desktop-head-unit im Verzeichnis SDK_LOCATION/extras/google/auto/ ausführen:

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

1. Wenn Sie das Mobilgerät zum ersten Mal mit der DHU verbinden, sehen Sie auf dem Display des Mobilgeräts die Nutzungsbedingungen. Akzeptieren Sie diese und passen Sie die Berechtigungseinstellungen nach Bedarf an.

Nachdem die DHU gestartet wurde, können Sie DHU-Konsolenbefehle verwenden, um Ihre App auszuführen und zu testen.

Befehlszeilenoptionen

Standardmäßig stellt der Server für das Infotainmentsystem eine Verbindung über Port 5277 her. Verwenden Sie das Flag --adb=<[localhost:]port>, um den Host oder Port zu überschreiben, wie im folgenden Beispiel gezeigt:

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

Standardmäßig emuliert die DHU ein mit Android Auto kompatibles Infotainmentsystem mit Touchscreen-Benutzeroberfläche. Simulieren Sie Nutzerberührungen, indem Sie mit einer Maus auf das DHU klicken. Wenn Sie Head-Units emulieren möchten, die einen Drehregler für die Eingabe verwenden, können Sie das Flag -i rotary verwenden, wie im folgenden Beispiel gezeigt:

./desktop-head-unit -i controller

Wenn sich die DHU im Drehreglermodus befindet, können Sie mit Tastenkombinationen Regleraktionen simulieren. Weitere Informationen finden Sie im Abschnitt Drehknopf. Im Drehreglermodus ignoriert das DHU Mausklicks. Sie müssen Android Auto mit den simulierten Drehregler-Vorgängen bedienen.

Weitere Befehlszeilenoptionen für DHU sind in der folgenden Tabelle aufgeführt:

DHU-Nutzerhandbuch

In diesem Abschnitt werden die vom DHU unterstützten Funktionen und deren Verwendung beschrieben.

Befehle werden in das Terminalfenster eingegeben, in dem Sie DHU gestartet haben. Mehrere Befehle können in derselben Zeile ausgeführt werden, indem Sie sie durch ; trennen.

System

Touch und Touchpad

Wenn die Touch- oder Touchpad-Funktion aktiviert ist, wird ein Klick in das Display-Fenster (bei Touch) oder in das Touchpad-Fenster (bei Touchpad) als Touch-Ereignis registriert.

Um Multitouch-Gesten zu simulieren, klicken Sie mit der rechten Maustaste auf die Position des ersten Fingers und dann mit der linken Maustaste auf die Position des zweiten Fingers. Halten Sie die linke Maustaste gedrückt. Der Mittelpunkt der beiden Finger bleibt fixiert. Durch Bewegen der Maus können Sie die Finger um den Mittelpunkt drehen, zusammen- und auseinanderziehen oder beides.

Klicken Sie auf dem Touchpad auf die linke Taste und halten Sie sie gedrückt, um zwischen verschiedenen UI-Elementen auf dem Bildschirm zu scrollen. Durch Klicken auf die rechte Maustaste wird das Element ausgewählt, das den Fokus hat.

Drehsteller

Das DHU unterstützt Drehregler. Wenn die Option aktiviert ist, werden die folgenden Aktionen unterstützt:

• Klicken Sie auf dem Steuerkreuz auf „Nach oben“, „Nach unten“, „Nach links“ und „Nach rechts“.
• Im Uhrzeigersinn und gegen den Uhrzeigersinn drehen
• Drehbewegung ausführen (fünf Schritte gleichzeitig)
• Auf dem Controller nach unten und zurück klicken

Die Befehle und Tastenkombinationen sind in der folgenden Tabelle aufgeführt.

Ein Mausrad sendet dpad rotate-Befehle und das Klicken auf die mittlere Maustaste, in der Regel das Mausrad, sendet dpad click-Befehle.

Die meisten Autos haben Touchscreens. Einige Autos haben nur Drehregler, andere eine Kombination aus Touchscreen und Drehregler. Autos können auch ein Touchpad unterstützen, das zum Schwenken der Karte und zur Texteingabe verwendet werden kann. Berücksichtigen Sie diese unterschiedlichen Konfigurationen, wenn Sie verschiedene Infotainmentsysteme simulieren.

Mikrofon

Das DHU unterstützt die Verwendung eines Mikrofons für die Spracheingabe oder zum Abspielen eines vorab aufgenommenen Voice-Tracks. Die folgenden Sounddateien für häufige Sprachbefehle sind im DHU enthalten. Diese Audiodateien befinden sich im Verzeichnis SDK_LOCATION/extras/google/auto/voice/.

Verwenden Sie den folgenden Befehl, um eine einzelne .wav-Datei in der DHU-Eingabeaufforderung auszuführen:

mic play /path/to/filename.wav

In der folgenden Tabelle sind weitere Mikrofonbefehle aufgeführt:

Sensoren

Mit den folgenden Befehlen können Sie mit dem DHU Änderungen an den Sensordaten des Fahrzeugs simulieren. Wenn Sie Sensordaten simulieren und an Android Auto senden möchten, müssen die entsprechenden Sensoren beim Starten der DHU mit der Konfigurationsdatei .ini aktiviert werden.

Tag- und Nachtmodus

Das DHU unterstützt die Simulation des Wechsels zwischen Tag- und Nachtmodus mit den folgenden Befehlen und Tastenkombinationen:

Fokusverwaltung

Mit den folgenden Befehlen kann simuliert werden, ob Android Auto den Fokus auf dem Infotainmentsystem hat:

Einschränkungen und Fahrstatus

Das DHU unterstützt die Simulation bestimmter Einschränkungen, wenn sich das Fahrzeug bewegt, z. B. das Deaktivieren der Tastatur und das Verhindern von Telefonkonfigurationen. Verwenden Sie dazu die folgenden Befehle:

Kombiinstrument

Das DHU unterstützt die Emulation eines Kombiinstruments. Dieses Cluster befindet sich in der Regel hinter dem Lenkrad und zeigt während der Navigation grundlegende Informationen zur nächsten Abbiegung an, z. B. den Namen der nächsten Straße oder einen Abbiegepfeil, die Entfernung oder die Zeit. Außerdem werden Informationen zu laufenden Telefonanrufen angezeigt.

Dies kann über den Eintrag instrumentcluster im Abschnitt [general] der Konfigurationsdatei oder über die Einträge navcluster oder phonecluster aktiviert werden, um die einzelnen Funktionen separat zu steuern.

[general]
...
instrumentcluster = true

Cluster-Display

Einige Fahrzeuge haben Kombiinstrumente, auf denen detaillierte visuelle Informationen wie Kartenkacheln angezeigt werden können. Ab Version 2.1 des DHU (derzeit über den Android Studio Beta-Updatekanal verfügbar) können Sie ein solches Display auf Ihrem Entwicklercomputer emulieren.

Dazu können Sie eine Konfigurationsdatei mit einem Clusterabschnitt [display] verwenden. [display]-Abschnitte unterstützen dieselben Videokonfigurationsoptionen wie die im [general]-Abschnitt der Datei konfigurierte Hauptanzeige.

...

# 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
...

Diese Konfiguration kann entweder direkt einer vorhandenen .ini-Datei hinzugefügt oder wiederverwendet werden, indem sie in eine separate Datei eingefügt und beim Starten des DHU mehrere Konfigurationsdateien übergeben werden. Wenn Sie mehrere Konfigurationsdateien verwenden, werden frühere Definitionen eines bestimmten Werts durch spätere überschrieben.

# 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

Status der Medienwiedergabe

DHU unterstützt die Anzeige zusätzlicher Informationen zum Status der Medienwiedergabe, z. B. welcher Titel gerade abgespielt wird.

Dazu kann der Eintrag playbackstatus im Abschnitt [general] verwendet werden.

[general]
...
playbackstatus = true

Keycodes

Das DHU bietet eine Reihe von Standardschlüsselcodes, die die in Fahrzeugen häufig verfügbaren Schaltflächen für Tastenkombinationen simulieren. Der Tastencode home kann beispielsweise im DHU-Prompt so ausgelöst werden:

keycode home

In der folgenden Tabelle sind weitere verfügbare Tastencodes aufgeführt:

DHU konfigurieren

Das DHU unterstützt eine Konfigurationsdatei .ini, mit der die Eingabemodi zwischen Touch- und Drehregler geändert und die Bildrate, Auflösung und DPI festgelegt werden können, die das Head-Unit vom Smartphone anfordert.

Der Standardspeicherort für die Konfigurationsdatei ist ~/.android/headunit.ini. Wenn Sie die Konfiguration des Infotainmentsystems in Ihrem System ändern möchten, können Sie diese Datei bearbeiten.

Sie können auch eine zu ladende Konfigurationsdatei mit dem Flag -c angeben:

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

Das folgende Snippet zeigt eine Beispielkonfiguration:

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

Beispielkonfigurationsdateien mit verschiedenen Einstellungen für die Headunit, die Sie testen können, finden Sie im Ordner SDK_LOCATION/extras/google/auto/config/. Informationen zu komplexeren Anwendungsfällen finden Sie in den folgenden unterstützten Einstellungen:

Eingabekonfiguration

In der folgenden Tabelle sind die Optionen für die Eingabekonfiguration aufgeführt:

Videokonfiguration

Android Auto unterstützt drei Videoauflösungen:

• 480p (800 × 480, Standard)
• 720p: 1280 x 720
• 1080p (1920 × 1080)

Zur Unterstützung anderer Seitenverhältnisse kann die Head-Unit bei Bedarf einen Rand für das Letterboxing (Pillarboxing) angeben. Wenn Sie beispielsweise einen Bildschirm mit 1.000 × 600 Pixeln wünschen, legen Sie die Auflösung auf 720p (1.280 × 720) und marginwidth auf 280 und marginheight auf 120 fest. Dadurch wird ein Rand von 140 px an den linken und rechten Kanten und ein Rand von 60 px oben und unten hinzugefügt.

Die folgende Beispielkonfiguration emuliert einen typischen 6‑Zoll-Bildschirm (750 × 450):

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

Die folgende Beispielkonfiguration emuliert einen sehr breiten Bildschirm:

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

In der folgenden Tabelle sind weitere Optionen für die Videokonfiguration aufgeführt:

Sensorkonfiguration

Wenn Sie Sensordaten simulieren und an Android Auto senden möchten, müssen die entsprechenden Sensoren mit den folgenden Optionen aktiviert werden. Wenn ein Sensor nicht aktiviert ist, werden alle Daten, die für diesen Sensor mit den DHU-Befehlen gesendet werden, ignoriert. Diese Konfiguration muss in einen [sensors]-Abschnitt eingefügt werden, nicht in den [general]-Abschnitt, der für die meisten anderen Konfigurationen verwendet wird.

[general]
touch = true
...

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

Verschiedene Konfigurationsoptionen

In der folgenden Tabelle sind weitere Konfigurationsoptionen aufgeführt:

Fehlerbehebung

Manchmal wird auf dem DHU-Display nach der ersten Verbindung ein leerer Bildschirm angezeigt. So können Sie dieses Problem umgehen:

1. Schließen Sie die DHU.
2. Folgen Sie Schritt 5 unter DHU ausführen, um den Head Unit-Server zu beenden und neu zu starten.
3. Starten Sie das DHU neu.
4. Erteile alle zusätzlichen Berechtigungen, die auf dem Smartphone-Display angefordert werden. Das DHU wird möglicherweise noch einmal heruntergefahren.
5. Starte das DHU bei Bedarf neu.