Android Auto中CarAppService未在车机显示的技术求助

我开发了一款需要渲染图标网格的应用，在**DHU（桌面主机模拟器）**中能正常显示运行，但在Android Auto车机端无法显示，也无法在Android Auto菜单中找到对应的CarAppService。以下是我的Manifest文件代码：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
    <uses-permission
        android:name="androidx.car.app.NAVIGATION_TEMPLATES" />

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

    <uses-permission
        android:name="android.permission.POST_NOTIFICATIONS" />

    <uses-permission
        android:name="android.permission.INTERNET"
        android:required="true" />

    <uses-permission
        android:name="android.permission.READ_MEDIA_VIDEO"
        android:required="true"/>

    <uses-permission
        android:name="android.permission.READ_MEDIA_AUDIO"
        android:required="true"/>

    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:required="true"/>

    <uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY"
        android:required="true"/>

    <application
        android:icon="@mipmap/icon"
        android:label="@string/app_name"
        android:appCategory="audio">

        <meta-data
            android:name="com.google.android.gms.car.application"
            android:resource="@xml/automotive_app_desc" />

        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="5" />

        <meta-data
            android:name="androidx.car.app.CarAppMetadataHolderService.CAR_APP_SERVICE"
            android:value=".CarMainService" />

        <service
            android:name=".CarMainService"
            android:exported="true"
            android:icon="@mipmap/auto"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="androidx.car.app.CarAppService" />
                <category android:name="androidx.car.app.category.NAVIGATION"/>
            </intent-filter>
        </service>
        <receiver
            android:name="androidx.media.session.MediaButtonReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MEDIA_BUTTON" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

核心问题排查与修复方案 #

1. 应用类别与Service类别不匹配 #

你的application标签设置了android:appCategory="audio"，但CarMainService的intent-filter声明的是androidx.car.app.category.NAVIGATION类别，Android Auto会因为类型不匹配过滤应用。必须将两者统一：

• 如果是音频类应用：把Service的category改为androidx.car.app.category.MEDIA
• 如果是导航类应用：把application的appCategory改为navigation

2. 权限配置过度严格 #

多个权限设置了android:required="true"（比如READ_MEDIA_VIDEO、ACCESS_NOTIFICATION_POLICY），如果车机端不支持或未授予这些权限，应用会被屏蔽。建议：

• 将非核心权限的android:required改为false
• 移除不需要的权限（比如如果不是导航类应用，删除androidx.car.app.NAVIGATION_TEMPLATES权限）

3. 最低API级别兼容性问题 #

当前minCarApiLevel="5"对应Android 11+，部分旧款车机系统版本低于此级别，导致应用无法显示。可尝试降低至3以兼容更多设备，同时确保依赖库版本与API级别匹配。

4. automotive_app_desc配置校验 #

检查@xml/automotive_app_desc文件，必须包含与应用类别匹配的声明，例如音频类应用需配置：

<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
    <uses name="media"/>
</automotiveApp>

5. 依赖版本一致性 #

确保项目中Android Auto相关依赖（如androidx.car.app:app、androidx.car.app:app-automotive）的版本与minCarApiLevel兼容，避免版本不匹配引发的兼容性问题。

修改后的Manifest示例（音频类应用） #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
    <uses-permission android:name="android.permission.INTERNET" android:required="true" />

    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" android:required="false"/>
    <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" android:required="true"/>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:required="false"/>
    <uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY" android:required="false"/>

    <application
        android:icon="@mipmap/icon"
        android:label="@string/app_name"
        android:appCategory="audio">

        <meta-data
            android:name="com.google.android.gms.car.application"
            android:resource="@xml/automotive_app_desc" />

        <meta-data
            android:name="androidx.car.app.minCarApiLevel"
            android:value="3" />

        <meta-data
            android:name="androidx.car.app.CarAppMetadataHolderService.CAR_APP_SERVICE"
            android:value=".CarMainService" />

        <service
            android:name=".CarMainService"
            android:exported="true"
            android:icon="@mipmap/auto"
            android:label="@string/app_name">
            <intent-filter>
                <action android:name="androidx.car.app.CarAppService" />
                <category android:name="androidx.car.app.category.MEDIA"/>
            </intent-filter>
        </service>
        <receiver
            android:name="androidx.media.session.MediaButtonReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MEDIA_BUTTON" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

内容的提问来源于stack exchange，提问作者Vincenzo Governali