Android Auto应用实体车机不显示（DHU正常），求Manifest排查方案

问题背景 #

现有一款已上架Play Store的应用，对应的Android Auto版本在DHU（桌面主机）中运行正常，但通过Play Store内部测试版安装到实体车机后，该应用未出现在Android Auto的可用应用列表中，怀疑Manifest配置存在问题但无法定位。

核心排查步骤 #

1. 检查Automotive App Manifest关键配置 #

• 确认应用代码开关：<application>标签的android:hasCode属性不能设为false，否则Auto组件无法加载（默认可不显式声明，若有设置需改为true）。
• 验证Auto服务声明：确保<service>正确关联androidx.car.app.CarAppService，并配置正确的intent filter：

  <service
      android:name=".YourCarAppServiceClass"
      android:exported="true">
      <intent-filter>
          <action android:name="androidx.car.app.CarAppService" />
      </intent-filter>
  </service>
  

• 权限与特性校验：
  • 若应用涉及位置功能，必须声明android.permission.ACCESS_FINE_LOCATION，且实体车机要手动授予该权限。
  • 确认<uses-feature>中汽车类型特性设置正确：

    <uses-feature android:name="android.hardware.type.automotive" android:required="true" />
    

2. 核对automotive_app_desc.xml配置 #

• 文件路径与Manifest关联：该文件必须放在res/xml/目录下，且在Manifest的<application>标签内通过meta-data绑定：

  <meta-data
      android:name="androidx.car.app.APP_DESC"
      android:resource="@xml/automotive_app_desc" />
  

• 应用分类与启动配置：
  • appCategory要与应用功能匹配（如NAVIGATION、MEDIA、COMMUNICATION等），错误分类会导致车机不显示。
  • launchIntent的组件名必须指向正确的Auto端Activity或服务，示例：

    <automotiveApp>
        <appCategory value="MEDIA" />
        <launchIntent>
            <component
                android:name="com.your.package.YourCarLaunchActivity"
                android:package="com.your.package" />
        </launchIntent>
    </automotiveApp>
    

3. 原手机应用Manifest一致性检查 #

• 包名统一：手机版与Auto版应用的包名必须完全一致，否则Play Store安装的APK无法被车机识别为关联应用。
• 避免冲突配置：手机版Manifest不要错误添加android.hardware.type.automotive特性，否则可能干扰Auto组件的识别。

4. 实体车机专属排查点 #

• Auto版本兼容性：部分旧款车机的Android Auto版本较低，不支持最新的Car App Library API，建议使用稳定版依赖（如androidx.car.app:app:1.4.0）。
• 车机白名单限制：部分车企会限制第三方应用显示，进入车机的Android Auto设置，确认已开启“允许未知来源应用”，或手动触发应用扫描。
• 安装状态验证：通过ADB连接车机，执行以下命令确认Auto版APK已正确安装：

  adb shell pm list packages | grep 你的应用包名
  

5. 日志定位问题 #

• 连接车机后，用ADB过滤Auto相关日志，查找具体错误：

  adb logcat -s CarAppService,CarAppLoader,CarAppManager
  

  重点关注CarAppService not registered、Invalid app description这类关键词，直接定位配置错误点。

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