Configurer les fichiers manifestes

Configurez les fichiers manifestes de votre application pour l'intégrer à Android Auto et Android Automotive OS (AAOS). Pour permettre à ces plates-formes de découvrir et de se connecter à votre service de navigateur multimédia, déclarez-le dans le fichier manifeste. Spécifiez les icônes d'application requises, y compris une icône de lanceur d'applications pour une icône d'attribution à utiliser par les composants de l'UI du système, tels que les commandes multimédias.

Pour en savoir plus sur les fichiers manifestes, consultez la présentation du fichier manifeste d'application.

Déclarer votre service de navigateur multimédia

Android Auto et AAOS se connectent à votre application via votre service de navigateur multimédia pour parcourir les éléments multimédias. Déclarez votre service de navigateur multimédia dans le fichier manifeste pour permettre à Android Auto et à AAOS de découvrir le service et de se connecter à votre application.

Cet extrait de code montre comment déclarer le service de navigateur multimédia dans votre fichier manifeste. La section suivante de ce guide, Créer un service de navigateur multimédia, décrit en détail le processus d'implémentation du service.

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

Spécifier des icônes d'application

Pour représenter votre application dans l'UI du système, spécifiez les icônes d'application qu'Android Auto et AAOS doivent utiliser. Ces deux icônes sont obligatoires :

Définir l'icône de lanceur

L'icône de lanceur représente votre application dans l'UI du système, par exemple dans le Lanceur d'applications et la barre d'icônes.

Par défaut, l'attribut android:icon de l'élément <application> de votre application est utilisé comme icône de lanceur :

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

Pour utiliser une autre icône, définissez l'attribut android:icon de l'élément <service> de votre service de navigateur multimédia :

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

Définir l'icône d'attribution

L'icône d'attribution est utilisée là où le contenu multimédia est prioritaire, par exemple sur les fiches multimédias. Nous vous conseillons de réutiliser la petite icône associée aux notifications. Cette icône doit être monochrome.

Icône d&#39;attribution sur la fiche multimédia

Figure 1 : Icône d'attribution sur la fiche multimédia

Vous pouvez spécifier une icône représentant votre application à l'aide de la déclaration de fichier manifeste suivante :

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

Spécifier le libellé de votre application

Par défaut, la valeur de l'attribut android:label de l'élément <application> de votre application est utilisée comme nom à afficher pour votre application sur l'écran de la voiture.

Pour utiliser un nom à afficher différent (ou si votre application comporte plusieurs services de navigateur multimédia), définissez l'attribut android:label de l'élément <service> du service de navigateur multimédia.

Spécifier la couleur d'accentuation de votre application

La couleur d'accentuation de votre application est utilisée par Android Auto et AAOS pour styliser les commandes de lecture et d'autres éléments d'UI.

Par défaut, la couleur d'accentuation est extraite de l'élément colorAccent de la ressource de style android:theme de l'élément <application> de votre application.

Pour utiliser une couleur d'accentuation différente pour votre expérience embarquée, incluez un élément <meta-data> pour une ressource de style différente contenant un élément colorAccent :

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

Configuration spécifique à la plate-forme

En plus de la configuration détaillée sur cette page, consultez les sections suivantes pour connaître les exigences spécifiques à chaque plate-forme :