mapbox / mapbox/mapbox-maps-ios

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

Open
#2,412 7 comments 1 reaction 1 assignee View on GitHub

@maios is already working on this.

Since Jun 23, 2026.

auto-triaged bug :beetle:
Dominant language
Swift
Stars
601
Forks
196
PR merge metrics
No merged PRs in 30d

Description

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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.