-
Notifications
You must be signed in to change notification settings - Fork 191
[Bug]: MapView renders blank (no map tiles) on CarPlay Dashboard scene since v11.17.0 #2412
Copy link
Copy link
Open
Labels
bug 🪲Something is broken!Something is broken!
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:
- Create an iOS app with CarPlay support (maps entitlement) and
CPSupportsDashboardNavigationScene = truein Info.plist - Implement
CPTemplateApplicationDashboardSceneDelegate - In
didConnect, create aMapViewand 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/ regularUIWindow): ❌ Broken from v11.17.0
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
bug 🪲Something is broken!Something is broken!