Android Auto MapWithContentTemplate显示内容但无地图问题排查

问题描述 #

使用MapWithContentTemplate开发Android Auto应用时，面板和功能图标可正常显示，但地图区域始终为黑色，未加载出地图内容。依赖版本为androidx.car.app:app:1.7.0-beta03，已在DHU模拟器及实车测试验证。

核心解决步骤 #

1. 为地图设置初始相机位置 #

地图需要明确的初始视角参考点，否则会显示黑色背景。在创建MapController时添加初始坐标及缩放级别：

class CarHomeScreen(carContext: CarContext) : Screen(carContext) {
    @OptIn(ExperimentalCarApi::class)
    override fun onGetTemplate(): Template {
        val myPane = Pane.Builder().addRow(Row.Builder().setTitle("Row 1").build()).build()
        val myHeader = Header.Builder().setTitle("Header").build()
        val myPaneTemplate = PaneTemplate.Builder(myPane)
            .setHeader(myHeader)
            .build()
        val myActionStrip = ActionStrip.Builder()
            .addAction(Action.APP_ICON)
            .addAction(Action.PAN)
            .addAction(Action.BACK)
            .build()

        // 添加初始相机位置（示例坐标为旧金山，可替换为目标位置或当前用户位置）
        val initialCamera = CarLocation.create(37.7749, -122.4194)
        val myMapController = MapController.Builder()
            .setMapActionStrip(myActionStrip)
            .setInitialCameraPosition(initialCamera, 12.0f) // 第二个参数为地图缩放级别
            .build()

        val myMwcTemplate = MapWithContentTemplate.Builder()
            .setContentTemplate(myPaneTemplate)
            .setMapController(myMapController)
            .build()
        return myMwcTemplate
    }
}

如果需要使用用户当前位置，需确保已动态申请位置权限，并在获取到位置后更新相机视角。

2. 修改服务类别为导航类 #

当前Manifest中服务的类别为POI，而MapWithContentTemplate属于导航模板范畴，需切换服务类别：

<service
    android:name=".CarHomeService"
    android:stopWithTask="false"
    android:exported="true">
    <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <!-- 替换为导航类别 -->
        <category android:name="androidx.car.app.category.NAVIGATION"/>
    </intent-filter>
</service>

3. 确认依赖及权限配置 #

• 确保添加导航相关依赖：

  implementation 'androidx.car.app:app:1.7.0-beta03'
  implementation 'androidx.car.app:navigation:1.7.0-beta03'
  

• 动态申请位置权限：Android 6.0及以上需要在运行时申请ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION权限，否则地图无法获取位置数据加载内容。

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