配置清单文件

配置应用的清单文件,以与 Android Auto 和 Android Automotive OS (AAOS) 集成。如需允许这些平台发现和连接,请在清单中声明您的媒体浏览器服务。指定所需的应用图标,包括启动器图标和归因图标(供媒体控件等系统界面组件使用)。

如需详细了解清单文件,请参阅应用清单概览

声明媒体浏览器服务

Android Auto 和 AAOS 通过媒体浏览器服务连接到您的应用,以便浏览媒体项。在清单中声明媒体浏览器服务,以便让 Android Auto 和 AAOS 发现该服务并关联到您的应用。

此代码段展示了如何在清单中声明媒体浏览器服务。将此代码包含在 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="@mipmap/ic_launcher"
    ...
/>

如果要使用的图标与移动应用的图标不同,请在清单中为您的媒体浏览器服务的 <service> 元素设置 android:icon 属性:

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

定义提供方图标

提供方图标用于媒体内容优先的位置,例如媒体卡片上。您可以考虑重复使用用于表示通知的小图标。此图标必须是单色的。

媒体卡片上的提供方图标

图 1. 媒体卡片上的提供方图标。

您可以通过以下清单声明指定用于表示应用的图标:

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