Настроить файлы манифеста

Настройте файлы манифеста вашего приложения для интеграции с Android Auto и Android Automotive OS (AAOS). Чтобы обеспечить обнаружение и подключение этими платформами, укажите службу медиабраузера в манифесте. Укажите необходимые значки приложения, включая значок запуска для значка атрибуции, который будет использоваться компонентами системного пользовательского интерфейса, такими как элементы управления мультимедиа.

Дополнительную информацию о файлах манифеста см. в разделе Обзор манифеста приложения .

Объявите свой сервис медиабраузера

Android Auto и AAOS подключаются к вашему приложению через службу медиабраузера для просмотра медиафайлов. Объявите службу медиабраузера в манифесте, чтобы Android Auto и AAOS могли обнаружить её и подключиться к вашему приложению.

Этот фрагмент кода показывает, как объявить службу медиабраузера в манифесте. В следующем разделе руководства, «Создание службы медиабраузера» , подробно описывается процесс реализации службы.

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

Укажите значки приложений

Чтобы ваше приложение отображалось в системном интерфейсе, укажите значки, которые должны использовать Android Auto и AAOS. Эти два значка обязательны:

Определить значок запуска

Значок запуска представляет ваше приложение в системном пользовательском интерфейсе, например на панели запуска и на панели значков.

По умолчанию в качестве значка запуска используется атрибут android:icon элемента <application> вашего приложения:

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

Чтобы использовать другой значок, задайте атрибут android:icon элемента <service> службы вашего медиабраузера:

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

Определите значок атрибуции

Значок атрибуции используется там, где медиаконтент имеет приоритет, например, на карточках с медиафайлами. Рассмотрите возможность повторного использования маленького значка, используемого для уведомлений. Этот значок должен быть монохромным.

Значок атрибуции на карточке носителя

Рисунок 1. Значок атрибуции на карточке носителя.

Вы можете указать значок, который будет использоваться для представления вашего приложения, используя это объявление манифеста:

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

Укажите метку вашего приложения

По умолчанию значение атрибута android:label элемента <application> вашего приложения используется в качестве отображаемого имени вашего приложения на экране автомобиля.

Чтобы использовать другое отображаемое имя (или если в вашем приложении есть несколько служб медиабраузера), задайте атрибут android:label элемента <service> службы медиабраузера.

Укажите акцентный цвет вашего приложения

Цвет акцента вашего приложения используется Android Auto и AAOS для стилизации элементов управления воспроизведением и других элементов пользовательского интерфейса.

По умолчанию цвет акцента берется из элемента colorAccent ресурса стиля android:theme элемента <application> вашего приложения.

Чтобы использовать другой акцентный цвет для вашего опыта в автомобиле, включите элемент <meta-data> для другого ресурса стиля, содержащего элемент colorAccent :

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

Конфигурация, зависящая от платформы

В дополнение к конфигурации, подробно описанной на этой странице, ознакомьтесь со следующими разделами, посвященными требованиям к конкретной платформе: