Configurare i file manifest

Configura i file manifest della tua app per l'integrazione con Android Auto e Android Automotive OS (AAOS). Per consentire l'individuazione e la connessione da parte di queste piattaforme, dichiara il servizio di esplorazione dei contenuti multimediali nel manifest. Specifica le icone dell'app richieste, inclusa un'icona di avvio per un'icona di attribuzione da utilizzare da componenti dell'interfaccia utente di sistema come i controlli multimediali.

Per scoprire di più sui file manifest, vedi Panoramica del manifest dell'app.

Dichiarare il servizio di esplorazione dei contenuti multimediali

Android Auto e AAOS si connettono alla tua app tramite il servizio di navigazione multimediale per sfogliare gli elementi multimediali. Dichiara il servizio di navigazione multimediale nel manifest per consentire ad Android Auto e AAOS di scoprire il servizio e connettersi alla tua app.

Questo snippet di codice mostra come dichiarare il servizio di esplorazione dei contenuti multimediali nel manifest. La sezione successiva di questa guida, Creare un servizio di esplorazione dei contenuti multimediali, descrive in dettaglio la procedura di implementazione del servizio.

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

Specifica le icone delle app

Per rappresentare la tua app nell'interfaccia utente di sistema, specifica le icone dell'app che Android Auto e AAOS devono utilizzare. Sono necessarie queste due icone:

Definisci l'icona in Avvio app

L'icona di Avvio app rappresenta la tua app nell'interfaccia utente del sistema, ad esempio in Avvio app e nella barra delle icone.

Per impostazione predefinita, l'attributo android:icon dell'elemento <application> dell'app viene utilizzato come icona in Avvio applicazioni:

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

Per utilizzare un'icona diversa, imposta l'attributo android:icon dell'elemento <service> del servizio di esplorazione dei contenuti multimediali:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

Definisci l'icona di attribuzione

L'icona di attribuzione viene utilizzata nei punti in cui i contenuti multimediali hanno la precedenza, ad esempio nelle schede multimediali. Valuta la possibilità di riutilizzare l'icona piccola utilizzata per le notifiche. Questa icona deve essere monocromatica. Ti consigliamo vivamente di utilizzare una risorsa vettoriale per evitare un'icona sfocata.

Icona di attribuzione sulla scheda multimediale

Figura 1. Icona dell'attribuzione sulla scheda multimediale.

Puoi specificare un'icona utilizzata per rappresentare la tua app utilizzando questa dichiarazione del manifest:

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

Specificare l'etichetta della tua app

Per impostazione predefinita, il valore dell'attributo android:label dell'elemento <application> della tua app viene utilizzato come nome visualizzato per l'app sullo schermo dell'auto.

Per utilizzare un nome visualizzato diverso o se la tua app ha più servizi di esplorazione dei contenuti multimediali, imposta l'attributo android:label dell'elemento <service> del servizio di esplorazione dei contenuti multimediali.

Specificare il colore di accento dell'app

Il colore accento della tua app viene utilizzato da Android Auto e AAOS per lo stile dei controlli di riproduzione e di altri elementi della UI.

Per impostazione predefinita, il colore accento viene estratto dall'elemento colorAccent della risorsa di stile android:theme dell'elemento <application> della tua app.

Per utilizzare un colore accento diverso per l'esperienza in auto, includi un elemento <meta-data> per una risorsa di stile diversa contenente un elemento colorAccent:

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

Configurazione specifica della piattaforma

Oltre alla configurazione descritta in dettaglio in questa pagina, consulta le seguenti sezioni per i requisiti specifici della piattaforma: