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. Inclua esse código no arquivo de manifesto do seu módulo AAOS e no arquivo de manifesto do seu app para smartphones.

<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. Você pode especificar que quer usar o ícone do app para dispositivos móveis para representar o app de música do carro usando a seguinte declaração de manifesto:

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

Para usar um ícone diferente do seu app para dispositivos móveis, defina a propriedade android:icon no elemento <service> do serviço de navegação de mídia no manifesto:

<application>
    ...
    <service
        ...
        android:icon="@mipmap/auto_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>