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 applicazioni 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>

Specificare 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 del browser multimediale:

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

Definisci l'icona dell'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.

Icona di attribuzione sulla scheda dei contenuti multimediali

Figura 1. Icona dell'attribuzione sulla scheda dei contenuti multimediali.

Puoi specificare un'icona da utilizzare 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 dell'interfaccia utente.

Per impostazione predefinita, il colore di contrasto 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 questa pagina, consulta le seguenti sezioni per i requisiti specifici della piattaforma: