Esegui un test utilizzando l'unità principale del desktop

L'unità principale del computer (DHU) consente alla tua macchina di sviluppo di emulare un'unità principale Android Auto in modo da poter eseguire e testare le app Android Auto. L'unità DHU viene eseguita su sistemi Windows, macOS e Linux.

Dopo aver installato l'unità principale di test, puoi testare le tue app Android Auto collegando il tuo dispositivo mobile a quest'ultima utilizzando uno dei meccanismi di connessione supportati descritti in Esegui l'unità principale di test.

Per segnalare bug o richiedere funzionalità relative all'unità di gestione dei dati, utilizza lo strumento di monitoraggio dei problemi.

Installare l'unità DHU

Per installare l'DHU sulla macchina di sviluppo:

1. Attiva la modalità sviluppatore su un dispositivo mobile con Android 9 (livello API 28) o versioni successive, come descritto in Configurare le opzioni sviluppatore sul dispositivo.
2. Compila e installa l'app sul dispositivo.
3. Installa Android Auto sul dispositivo. Se Android Auto è già installato, assicurati di utilizzare l'ultima versione.

4. In Android Studio, apri SDK Manager e vai alla scheda Strumenti SDK, poi scarica il pacchetto Emulatore dell'unità principale di Android Auto.

   

   L'unità principale è installata nella directory SDK_LOCATION/extras/google/auto/.

5. Sui sistemi Linux o macOS, esegui questo comando nella directory per rendere eseguibile il file binario DHU:

chmod +x ./desktop-head-unit

Passaggi aggiuntivi per Linux

Se esegui DHU versione 2.x su un sistema Linux, devi installare alcune librerie aggiuntive. Il binario DHU dipende da GLIBC versione 2.32 o successive. Puoi controllare la versione di GLIBC del tuo sistema eseguendo questo comando:

ldd --version

Se la versione è precedente alla 2.32, aggiorna GLIBC alla versione 2.32 o successive, il che potrebbe richiedere l'upgrade del sistema operativo a una versione compatibile con GLIBC 2.32 o versioni successive.

Devi anche installare le librerie libc++1 e libc++abi1. La procedura di installazione varia a seconda della distribuzione Linux. Ad esempio, sulle distribuzioni Linux derivate da Debian, puoi installare le librerie con questo comando:

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

Installare le versioni pre-release dell'unità head-up

Per accedere alle versioni pre-release di DHU, puoi utilizzare una versione di anteprima di Android Studio o modificare il canale di aggiornamento dell'installazione di Android Studio esistente con il canale beta.

Esegui DHU

Dopo aver installato DHU, puoi testare le tue app Android Auto collegando il tuo dispositivo mobile e la tua workstation tramite USB. Esegui DHU collegando il tuo dispositivo mobile a una macchina di sviluppo utilizzando la modalità accessorio (consigliata per DHU 2.x) o il tunneling ADB.

Connettersi utilizzando la modalità Accessorio

Android Auto supporta la connessione alla DHU versione 2.x con il protocollo Android Open Accessory (AOA), utilizzando il seguente comando:

./desktop-head-unit --usb

Per impostazione predefinita, l'unità principale esegue la scansione dell'elenco dei dispositivi USB disponibili e tenta di connettersi al primo compatibile. Per scegliere come target un dispositivo specifico, includi l'ID dispositivo come parte del comando --usb, come segue:

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

Connettiti utilizzando il tunneling ADB

Questo metodo richiede la configurazione di una connessione al server dell'unità principale di Android Auto tramite Android Debug Bridge (adb). Segui questi passaggi per configurare il tunneling ed eseguire DHU:

1. Attiva la modalità sviluppatore di Android Auto, se non l'hai già fatto.

2. Se il server dell'unità principale non è già in esecuzione, apri il menu overflow e seleziona Avvia server dell'unità principale, come mostrato nella figura 1.

   Sul dispositivo, nell'area di notifica viene visualizzato un servizio in primo piano che indica che il server è in esecuzione, come mostrato nella Figura 2.

   

   Figura 1. Menu contestuale con le opzioni sviluppatore.

   

   Figura 2. Notifica che il server dell'unità principale è in esecuzione.

3. Nell'app Android Auto, tocca Auto connesse in precedenza nella parte superiore delle Impostazioni e verifica che l'opzione Aggiungi nuove auto ad Android Auto sia attivata.

4. Collega il dispositivo mobile alla macchina di sviluppo tramite USB.

5. Assicurati che lo schermo del dispositivo mobile sia sbloccato in modo che possa avviare l'unità principale.

6. Sulla macchina di sviluppo, esegui il seguente comando adb per inoltrare le connessioni socket dalla porta 5277 della macchina di sviluppo allo stesso numero di porta sul dispositivo mobile. Questa configurazione consente all'unità DHU di connettersi al server dell'unità principale in esecuzione sul dispositivo mobile tramite un socket TCP.

   adb forward tcp:5277 tcp:5277

7. Avvia l'unità principale virtuale eseguendo il comando desktop-head-unit.exe su Windows o ./desktop-head-unit su macOS o Linux dalla directory SDK_LOCATION/extras/google/auto/:

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

1. Se è la prima volta che connetti il dispositivo mobile all'unità principale, controlla lo schermo del dispositivo mobile per accettare i termini di servizio e regolare le impostazioni delle autorizzazioni in base alle esigenze.

Dopo l'avvio dell'unità principale, puoi utilizzare i comandi della console DHU per eseguire e testare la tua app.

Opzioni della riga di comando

Per impostazione predefinita, il server dell'unità principale si connette tramite la porta 5277. Per ignorare l'host o la porta, utilizza il flag --adb=<[localhost:]port>, come mostrato nell'esempio seguente:

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

Per impostazione predefinita, DHU emula un'unità principale compatibile con Android Auto con un'interfaccia utente touchscreen. Simula i tocchi dell'utente facendo clic sulla DHU con un mouse. Per emulare le autoradio che utilizzano un controller rotativo per l'input, puoi utilizzare il flag -i rotary, come mostrato nell'esempio seguente:

./desktop-head-unit -i controller

Quando l'HU è in modalità di controllo rotativo, puoi utilizzare le scorciatoie da tastiera per simulare le operazioni del controller. Per ulteriori dettagli, consulta la sezione Controller rotativo. In modalità controller rotativo, l'unità principale ignora i clic del mouse. Devi utilizzare Android Auto con le operazioni del controller rotativo simulato.

Altre opzioni della riga di comando per DHU sono elencate nella tabella seguente:

Guida dell'utente di DHU

Questa sezione descrive le funzionalità supportate dall'DHU e come utilizzarle.

I comandi vengono inseriti nella finestra del terminale in cui hai avviato DHU. È possibile eseguire più comandi sulla stessa riga separandoli con ;.

Sistema

Tatto e touchpad

Quando il tocco o il touchpad è abilitato, il clic nella finestra di visualizzazione, per il tocco, o nella finestra del touchpad, per il touchpad, viene registrato come evento touch.

Per il tocco, simula il multi-touch facendo clic con il tasto destro del mouse sulla posizione del primo dito, quindi facendo clic e tenendo premuto il tasto destro per il secondo dito. Il punto centrale delle due dita rimane fisso; spostando il mouse puoi ruotarle intorno al centro, pizzicarle verso l'interno e l'esterno o entrambe le azioni.

Per il touchpad, fai clic e tieni premuto il pulsante sinistro per scorrere tra i diversi elementi dell'interfaccia utente sullo schermo. Se fai clic sul pulsante destro, viene selezionato l'elemento su cui è attivo lo stato attivo.

Selettore rotativo

L'unità principale ha il supporto del controller rotativo. Quando è abilitata, sono supportate le seguenti azioni:

• Fare clic su Su, Giù, Sinistra e Destra sul D-pad
• Ruotare in senso orario e antiorario
• Eseguire uno scorrimento di rotazione (cinque passaggi contemporaneamente)
• Fare clic verso il basso e indietro sul controller

I comandi e le combinazioni di tasti sono elencati nella tabella seguente.

Una rotellina di scorrimento su un mouse invia comandi dpad rotate e il clic del tasto centrale del mouse, di solito la rotellina di scorrimento, invia comandi dpad click.

Tieni presente che la maggior parte delle auto è dotata di touchscreen. Alcune auto hanno solo controller rotativi e altre hanno un sistema ibrido di tocco e controller. Le auto possono supportare anche un touchpad, che può essere utilizzato per spostarsi nella mappa e inserire testo. Tieni presente queste diverse configurazioni quando simuli diverse unità principali del veicolo.

Microfono

L'unità principale supporta l'utilizzo di un microfono per l'input vocale o per riprodurre una traccia vocale preregistrata. Per comodità, con l'unità principale sono inclusi i seguenti file audio per i comandi vocali comuni. Questi file audio si trovano nella directory SDK_LOCATION/extras/google/auto/voice/.

Per eseguire un singolo file .wav nel prompt DHU, utilizza questo comando:

mic play /path/to/filename.wav

La tabella seguente elenca altri comandi relativi al microfono:

Sensori

L'unità principale supporta la simulazione delle modifiche ai dati dei sensori del veicolo con i seguenti comandi. Per simulare i dati dei sensori e inviarli ad Android Auto, i sensori corrispondenti devono essere attivati con il file di configurazione .ini utilizzato all'avvio di DHU.

Modalità giorno e notte

L'unità head-up display supporta la simulazione del passaggio dalla modalità giorno a quella notte con i seguenti comandi e combinazioni di tasti:

Gestione dello stato attivo

L'unità principale supporta la simulazione dell'attivazione o meno del focus di Android Auto sull'unità principale utilizzando i seguenti comandi:

Limitazioni e stato di guida

L'unità principale supporta la simulazione di determinate limitazioni quando il veicolo è in movimento, ad esempio la disattivazione della tastiera e il divieto di configurazioni dello smartphone, utilizzando i seguenti comandi:

Quadro strumenti

L'HU supporta l'emulazione di un quadro strumenti. Questo cluster si trova di solito dietro il volante e mostra le informazioni di base durante la navigazione sulla prossima svolta, ad esempio il nome della prossima strada o una freccia di svolta, la distanza o il tempo. Mostra anche informazioni sulle chiamate telefoniche in corso.

Questa opzione può essere attivata utilizzando la voce instrumentcluster nella sezione [general] del file di configurazione oppure utilizzando le voci navcluster o phonecluster per controllare separatamente ogni funzionalità.

[general]
...
instrumentcluster = true

Display del quadro strumenti

Alcuni veicoli sono dotati di display del quadro strumenti in grado di visualizzare informazioni visive avanzate, come le tessere della mappa. A partire dalla versione 2.1 dell'unità principale virtuale (attualmente disponibile utilizzando il canale di aggiornamento di Android Studio Beta), puoi emulare un display di questo tipo sul tuo computer di sviluppo.

Puoi farlo utilizzando un file di configurazione con una sezione [display] del cluster. Le sezioni [display] supportano le stesse opzioni di configurazione video del display principale configurato nella sezione [general] del file.

...

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

Questa configurazione può essere aggiunta direttamente a un file .ini esistente oppure puoi riutilizzarla inserendola in un file separato e passando più file di configurazione all'avvio della DHU. Quando utilizzi più file di configurazione, le definizioni successive di un determinato valore sostituiscono quelle precedenti.

# 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

Stato di riproduzione dei contenuti multimediali

L'unità principale supporta una visualizzazione di informazioni aggiuntive per mostrare lo stato di riproduzione dei contenuti multimediali, ad esempio la traccia in riproduzione.

Può essere attivato utilizzando la voce playbackstatus nella sezione [general].

[general]
...
playbackstatus = true

Keycode

L'unità principale virtuale fornisce un insieme di codici chiave predefiniti che simulano l'insieme di pulsanti di scelta rapida comunemente disponibili nei veicoli. Ad esempio, il codice tasto home può essere attivato nel prompt DHU nel seguente modo:

keycode home

La tabella seguente elenca altri codici chiave disponibili:

Configura l'unità di distribuzione dell'intestazione

L'unità principale supporta un file di configurazione .ini per cambiare le modalità di input tra il tocco e il controller rotativo e per impostare la frequenza fotogrammi, la risoluzione e i DPI che l'unità principale richiede allo smartphone.

La posizione predefinita del file di configurazione è ~/.android/headunit.ini. Per modificare la configurazione dell'unità principale del sistema, puoi modificare questo file.

Puoi anche specificare un file di configurazione da caricare utilizzando il flag -c:

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

Il seguente snippet mostra una configurazione di esempio:

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

I file di configurazione di esempio che mostrano diverse impostazioni dell'unità principale che puoi testare si trovano nella cartella SDK_LOCATION/extras/google/auto/config/. Per casi d'uso più avanzati, consulta le seguenti impostazioni supportate:

Configurazione dell'input

La tabella seguente elenca le opzioni di configurazione dell'input:

Configurazione video

Android Auto supporta tre risoluzioni video:

• 480p (800 x 480, valore predefinito)
• 720 p (1280 x 720)
• 1080p (1920x1080)

Per supportare altri formati, l'unità principale può specificare un margine per il letterbox (pillarbox) in base alle necessità. Ad esempio, se vuoi una schermata 1000 x 600, imposta la risoluzione su 720p (1280 x 720) e un marginwidth di 280 e un marginheight di 120. In questo modo, viene aggiunto un margine di 140 px sui bordi sinistro e destro e un margine di 60 px nella parte superiore e inferiore.

La seguente configurazione di esempio emula un tipico schermo da 6 pollici (750x450):

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

La seguente configurazione di esempio emula uno schermo molto ampio:

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

La tabella seguente elenca altre opzioni di configurazione dei video:

Configurazione del sensore

Per simulare i dati dei sensori e inviarli ad Android Auto, i sensori corrispondenti devono essere attivati utilizzando le seguenti opzioni. Se un sensore non è attivato, tutti i dati inviati per quel sensore utilizzando i comandi DHU vengono ignorati. Questa configurazione deve essere inserita in una sezione [sensors], non nella sezione [general] utilizzata per la maggior parte delle altre configurazioni.

[general]
touch = true
...

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

Opzioni di configurazione varie

La tabella seguente elenca altre opzioni di configurazione:

Risoluzione dei problemi

A volte la DHU mostra una schermata vuota quando viene connessa per la prima volta. Per risolvere il problema, segui questi passaggi:

1. Chiudi l'unità principale.
2. Segui il passaggio 5 descritto in Esegui DHU per arrestare e riavviare il server dell'unità principale.
3. Avvia di nuovo DHU.
4. Concedi eventuali autorizzazioni aggiuntive richieste sullo schermo dello smartphone. L'unità principale potrebbe spegnersi un'altra volta.
5. Se necessario, riavvia l'unità hub domestico.