Configurare i file manifest

. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

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 in Avvio applicazioni per un'icona di attribuzione da utilizzare da componenti della UI 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 nella UI di sistema, specifica le icone dell'app che Android Auto e AAOS devono utilizzare. Sono necessarie queste due icone:

Definire l'icona in Avvio applicazioni
Definire l'icona di attribuzione

Definisci l'icona in Avvio applicazioni

L'icona in Avvio applicazioni rappresenta la tua app nell'UI di 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 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. Consigliamo vivamente di utilizzare una risorsa vettoriale per evitare un'icona sfocata.

Figura 1. Icona dell'attribuzione sulla scheda multimediale.

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 intenso dell'app

Il colore intenso 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 intenso viene estratto dall'elemento colorAccent della risorsa di stile android:theme dell'elemento <application> della tua app.

Per utilizzare un colore intenso 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: