Aggiungere il supporto di Android Auto all'app per il parcheggio

Sui dispositivi con Android 15 o versioni successive, Android Auto supporta l'esecuzione di app nelle categorie di app parcheggiate supportate direttamente sull'unità principale. Per saperne di più sull'esperienza utente delle app per auto parcheggiata su Android Auto, consulta la sezione App per auto parcheggiata.

Dichiara il supporto di Android Auto

Per dichiarare che la tua app supporta Android Auto, devi includere il seguente elemento <category> nel filtro per intent di un'attività nel manifest dell'app:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

In genere, l'elemento categoria android.intent.category.CAR_LAUNCHER può essere inserito nello stesso filtro per intent dell'elemento android.intent.category.LAUNCHER, ma può trovarsi in un altro se preferisci.

Voci del manifest specifiche per categoria

Oltre al requisito precedente, i giochi hanno un requisito aggiuntivo. Consulta Contrassegnare l'app come gioco.

Supportare le dimensioni dello schermo comuni di Android Auto

Per garantire la migliore esperienza utente possibile, ti consigliamo di rendere la tua app completamente adattabile a diverse dimensioni dello schermo. Come minimo, per garantire un'esperienza di alta qualità nella varietà di auto che supportano Android Auto, le app non devono essere sottoposte a pillarbox in modo significativo sugli schermi orizzontali, come indicato dalle DO-2 norme sulla qualità delle app per auto.

Ad esempio, se un'app viene eseguita con proporzioni verticali con pillarbox su uno schermo orizzontale, verrà rifiutata durante la revisione del Play Store. Un'app in esecuzione con proporzioni orizzontali con un pillarbox minimo su uno schermo orizzontale è accettabile, così come un'app in esecuzione con proporzioni orizzontali con letterbox su uno schermo verticale.

Testare le dimensioni dello schermo canoniche

Quando crei e testi la tua app per Android Auto, puoi utilizzare le seguenti configurazioni dell'unità principale di prova (DHU) per verificare che la tua app soddisfi i requisiti precedenti:

[general]
resolution = 800x480
dpi = 160
...

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

Rilevare l'utilizzo su Android Auto

Se vuoi rilevare quando la tua app viene utilizzata tramite Android Auto (ad esempio a fini di analisi), puoi esaminare due indicatori:

• Lo stato della connessione segnalato dall'API CarConnection. Quando Android Auto è connesso, questo sarà CONNECTION_TYPE_PROJECTION.
• L'ID display del display attivo. Quando la tua app viene eseguita su un display diverso da uno schermo integrato, ad esempio quando viene utilizzata tramite Android Auto, questo è un valore diverso da DEFAULT_DISPLAY.

Il seguente snippet mostra come combinare questi indicatori per rilevare l'utilizzo tramite Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY