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:
- Create an iOS app with CarPlay support (maps entitlement) and
CPSupportsDashboardNavigationScene = true in Info.plist
- Implement
CPTemplateApplicationDashboardSceneDelegate
- 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)
}
- Run on iOS Simulator, connect CarPlay Simulator
- 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
Environment
Observed behavior and steps to reproduce
MapView renders blank (no map tiles) when placed in a
CPTemplateApplicationDashboardScenewindow. 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:
CPSupportsDashboardNavigationScene = truein Info.plistCPTemplateApplicationDashboardSceneDelegatedidConnect, create aMapViewand add it to the dashboard window: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:
The regression was introduced in v11.17.0.
What works vs. what doesn't
CPTemplateApplicationScene/CPWindow): ✅ Works on all versionsCPTemplateApplicationDashboardScene/ regularUIWindow): ❌ Broken from v11.17.0