Cómo configurar archivos de manifiesto

Configura los archivos del manifiesto de tu app para que se integren con Android Auto y el SO Android Automotive (AAOS). Para permitir que estas plataformas descubran tu servicio de navegador multimedia y se conecten a él, decláralo en el manifiesto. Especifica los íconos de la app necesarios, incluido un ícono de selector y un ícono de atribución para que lo usen los componentes de la IU del sistema, como los controles multimedia.

Para obtener más información sobre los archivos de manifiesto, consulta la descripción general del manifiesto de la app.

Declara tu servicio de navegador multimedia

Android Auto y AAOS se conectan a tu app a través de tu servicio de navegador multimedia para explorar elementos multimedia. Declara tu servicio de navegador multimedia en el manifiesto para que Android Auto y AAOS puedan encontrarlo y conectarse con tu app.

En este fragmento de código, se muestra cómo declarar el servicio de navegador multimedia en tu manifiesto. En la siguiente sección de esta guía, Crea un servicio de exploración de contenido multimedia, se detalla el proceso de implementación del servicio.

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

Cómo especificar íconos de la app

Para representar tu app en la IU del sistema, especifica los íconos de la app que deben usar Android Auto y AAOS. Se requieren estos dos íconos:

Define el ícono de selector

El ícono de selector representa tu app en la IU del sistema, por ejemplo, en el selector y en la bandeja de íconos.

De forma predeterminada, el atributo android:icon del elemento <application> de tu app se usa como ícono de selector:

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

Para usar un ícono diferente, configura el atributo android:icon del elemento <service> de tu servicio de navegador multimedia:

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

Cómo definir el ícono de atribución

El ícono de atribución se usa en lugares en los que tiene prioridad el contenido multimedia, como en las tarjetas multimedia. Considera volver a utilizar el ícono pequeño que se usa para las notificaciones. Este ícono debe ser monocromático.

Ícono de atribución en la tarjeta multimedia

Figura 1: Ícono de atribución en la tarjeta multimedia

Puedes especificar el ícono que se usa para representar a tu app con esta declaración de manifiesto:

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

Especifica la etiqueta de tu app

De forma predeterminada, el valor del atributo android:label del elemento <application> de tu app se usa como el nombre visible de la app en la pantalla del auto.

Si quieres usar un nombre visible diferente o si tu app tiene varios servicios de navegador multimedia, configura el atributo android:label del elemento <service> del servicio de navegador multimedia.

Especifica el color de los elementos destacados de tu app

Android Auto y AAOS usan el color de énfasis de tu app para aplicar estilo a los controles de reproducción y otros elementos de la IU.

De forma predeterminada, el color de énfasis se extrae del elemento colorAccent del recurso de estilo android:theme del elemento <application> de tu app.

Para usar un color de énfasis diferente en la experiencia en el automóvil, incluye un elemento <meta-data> para un recurso de estilo diferente que contenga un elemento colorAccent:

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

Configuración específica de la plataforma

Además de la configuración que se detalla en esta página, consulta las siguientes secciones para conocer los requisitos específicos de cada plataforma: