Skip to content

[Bug]: MapView renders blank (no map tiles) on CarPlay Dashboard scene since v11.17.0 #2412

@ankiimation

Description

@ankiimation

Environment

  • Xcode version: 26.2 (also tested on 16.x)
  • iOS version: iOS 18.5 and iOS 26.2 (both affected)
  • Devices affected: CarPlay Simulator (Dashboard scene), all iPhone simulators tested
  • Maps SDK Version: v11.17.0 through v11.19.0 (v11.16.0 works correctly)

Observed behavior and steps to reproduce

MapView renders blank (no map tiles) when placed in a CPTemplateApplicationDashboardScene window. The Mapbox logo and attribution (i) icon render correctly (UIView-based), but the Metal-rendered map tiles do not appear — the map area is completely black/empty.

Steps to reproduce:

  1. Create an iOS app with CarPlay support (maps entitlement) and CPSupportsDashboardNavigationScene = true in Info.plist
  2. Implement CPTemplateApplicationDashboardSceneDelegate
  3. In didConnect, create a MapView and add it to the dashboard window:
func templateApplicationDashboardScene(
    _ scene: CPTemplateApplicationDashboardScene,
    didConnect controller: CPDashboardController,
    to window: UIWindow
) {
    let vc = UIViewController()
    window.rootViewController = vc

    let mapInit = MapInitOptions(
        mapOptions: MapOptions(pixelRatio: window.screen.nativeScale),
        cameraOptions: CameraOptions(
            center: CLLocationCoordinate2D(latitude: 10.76, longitude: 106.68),
            zoom: 14
        ),
        styleURI: StyleURI(rawValue: "https://api.maptiler.com/maps/basic/style.json?key=YOUR_KEY")
    )
    let mapView = MapView(frame: vc.view.bounds, mapInitOptions: mapInit)
    mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
    vc.view.addSubview(mapView)
}
  1. Run on iOS Simulator, connect CarPlay Simulator
  2. Observe: CarPlay main scene (CPTemplateApplicationScene) renders the map correctly. Dashboard scene shows only the Mapbox logo — no map tiles.

Expected behavior

The MapView should render map tiles on both the CarPlay main scene and the Dashboard scene, just as it does on v11.16.0 and earlier.

Notes / preliminary analysis

Binary search results

We performed a systematic binary search across MapboxMaps iOS SDK versions:

Version Dashboard Rendering
11.6.0 ✅ Works
11.12.0 ✅ Works
11.14.0 ✅ Works
11.15.0 ✅ Works
11.16.0 ✅ Last working version
11.17.0 ❌ First broken version
11.19.0 ❌ Broken

The regression was introduced in v11.17.0.

What works vs. what doesn't

  • Phone MapView: ✅ Works on all versions
  • CarPlay MapView (CPTemplateApplicationScene / CPWindow): ✅ Works on all versions
  • Dashboard MapView (CPTemplateApplicationDashboardScene / regular UIWindow): ❌ Broken from v11.17.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    bug 🪲Something is broken!

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions