配置清单文件

配置应用的清单文件，以与 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 应使用的应用图标。必须提供以下两种图标：

定义启动器图标

启动器图标用于在系统界面中表示您的应用，例如在启动器和图标托盘中。

默认情况下，应用的 <application> 元素的 android:icon 属性用作启动器图标：

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

如需使用其他图标，请设置媒体浏览器服务的 <service> 元素的 android:icon 属性：

<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>

指定应用的标签

默认情况下，应用的 <application> 元素的 android:label 属性的值会用作应用在车载屏幕上的显示名称。

如需使用其他显示名称，或者如果您的应用有多个媒体浏览器服务，请设置媒体浏览器服务的 <service> 元素的 android:label 属性。

指定应用的强调色

Android Auto 和 AAOS 会使用应用的强调色来设置播放控件和其他界面元素的样式。

默认情况下，强调色是从应用的 <application> 元素的 android:theme 样式资源的 colorAccent 项中提取的。

如需为车载体验使用其他强调色，请添加一个 <meta-data> 元素，该元素指向包含 colorAccent 项的其他样式资源：

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

针对具体平台的配置

除了本页面中详述的配置之外，如需了解平台专属的要求，请参阅以下部分：