Android Auto教程开发APP真机不显示仅模拟器可见，求解决方案

可能原因 #

• 签名不兼容：物理车机对应用签名要求比模拟器严格，调试签名大概率不被认可
• 清单配置有误：缺少Car App必要权限，或者Car服务组件的声明不符合规范
• 版本兼容性问题：应用依赖的Car App Library版本、目标SDK版本与物理车机不匹配
• 连接同步异常：设备连接时未触发应用同步，或权限未完全授予

解决步骤 #

1. 更换应用签名 #

• 用正式签名密钥给应用签名，生成签名APK/App Bundle后安装到手机，再重新连接车机。调试签名仅适用于模拟器，部分车机完全不接受
• 测试阶段如果不想用正式密钥，也可以尝试把debug keystore的SHA-1指纹配置到相关地方，但优先推荐正式签名

2. 核对Manifest配置 #

• 确认添加了必要权限：

  <uses-permission android:name="android.permission.CAR_APP"/>
  <uses-permission android:name="android.permission.INTERNET"/> <!-- 按需添加 -->
  

• 检查CarAppService组件的声明，确保meta-data和intent-filter正确：

  <service
      android:name=".MyCarAppService"
      android:exported="true">
      <intent-filter>
          <action android:name="androidx.car.app.CarAppService" />
      </intent-filter>
      <meta-data
          android:name="androidx.car.app.minCarApiLevel"
          android:value="1" /> <!-- 根据车机支持的API级别调整 -->
  </service>
  

• 如果应用用到明文网络请求，在<application>标签里加上android:usesCleartextTraffic="true"，部分车机默认限制明文流量

3. 适配版本兼容性 #

• 检查车机的Android Auto版本，调整build.gradle里的Car App Library依赖版本，比如：

  implementation 'androidx.car.app:app:1.4.0'
  

• 确保应用的目标SDK版本不超过车机支持的最高版本，老车机可能不支持Android 13及以上的目标SDK

4. 重置连接同步 #

• 断开手机和车机的连接，关闭手机上的Android Auto应用，清除它的缓存
• 重新配对设备，在手机上确认给Android Auto所有必要权限（通知、位置、存储等）
• 进手机的Android Auto设置，删除已保存的车机连接，重新配对

5. 检查车机端设置 #

• 部分车机除了手机端的「允许未知来源」，自身也有第三方应用开关，去车机的Android Auto设置里确认开启
• 把车机系统更到最新版本，旧系统可能存在兼容性bug

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