Configurar arquivos de manifesto

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

Configure os arquivos de manifesto do seu app para integração 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 na tela de início para um ícone de atribuição a ser usado 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 navegação de mídia para procurar itens de mídia. Declare o serviço de navegação 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 navegação de mídia no manifesto. A próxima seção deste guia, Criar um serviço de navegação 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 de app que o Android Auto e o AAOS devem usar. Esses dois ícones são obrigatórios:

Definir o ícone na tela de início
Definir o ícone de atribuição

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 android:icon atributo do <application> elemento do seu 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. Recomendamos o uso de um recurso vetorial para evitar um ícone borrado.

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

Especifique 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 rótulo do app

Por padrão, o valor do atributo android:label do elemento <application> do seu 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 do serviço de navegação de mídia <service>.

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 seu app.

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

<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 requisitos específicos da plataforma: