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

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

Настройте файлы манифеста вашего приложения для интеграции с 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>

Конфигурация, специфичная для платформы

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