Configurar arquivos de manifesto

Configure os arquivos de manifesto do app para integrar com o Android Auto e o Android Automotive OS (AAOS). Para ativar a descoberta e a conexão por essas plataformas, declare o serviço de navegação de mídia no manifesto. Especifique os ícones de app necessários, incluindo um ícone de inicialização e um ícone de atribuição para uso por componentes da interface do sistema, como controles de mídia.

Para saber mais sobre arquivos de manifesto, consulte Visão geral do manifesto do app.

Declarar o serviço de navegação de mídia

O Android Auto e o AAOS se conectam ao seu app pelo serviço de navegador de mídia para procurar itens de mídia. Declare o serviço de navegador de mídia no manifesto para permitir que o Android Auto e o AAOS descubram o serviço e se conectem ao seu app.

Este snippet de código mostra como declarar o serviço de navegador de mídia no manifesto. A próxima seção deste guia, Criar um serviço de navegador de mídia, detalha o processo de implementação do serviço.

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

Especificar ícones do app

Para representar seu app na interface do sistema, especifique os ícones que o Android Auto e o AAOS devem usar. Estes dois ícones são necessários:

Definir o ícone na tela de início

O ícone na tela de início representa seu app na interface do sistema, como na tela de início e na bandeja de ícones.

Por padrão, o atributo android:icon do elemento <application> do app é usado como o ícone na tela de início:

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

Para usar um ícone diferente, defina o atributo android:icon do elemento <service> do serviço de navegação de mídia:

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

Definir o ícone de atribuição

O ícone de atribuição é usado em locais em que o conteúdo de mídia tem precedência, como cards de mídia. Reutilize a versão pequena usada nas notificações. Esse ícone precisa ser monocromático.

Ícone de atribuição no card de mídia

Figura 1. Ícone de atribuição no card de mídia.

Você pode especificar um ícone usado para representar seu app usando esta declaração de manifesto:

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

Especificar o marcador do app

Por padrão, o valor do atributo android:label do elemento <application> do app é usado como o nome de exibição do app na tela do carro.

Para usar um nome de exibição diferente ou se o app tiver vários serviços de navegação de mídia, defina o atributo android:label do elemento <service> do serviço de navegação de mídia.

Especificar a cor de destaque do app

A cor de destaque do app é usada pelo Android Auto e pelo AAOS para estilizar controles de reprodução e outros elementos da interface.

Por padrão, a cor de destaque é extraída do item colorAccent do recurso de estilo android:theme do elemento <application> do app.

Para usar uma cor de destaque diferente na sua experiência no carro, inclua um elemento <meta-data> para um recurso de estilo diferente que contenha um item colorAccent:

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

Configuração específica da plataforma

Além da configuração detalhada nesta página, consulte as seções a seguir para conferir os requisitos específicos da plataforma: