Quick Look Extension does not load MapKit map properly anymore, after macOS Sequoia

It appears that starting with macOS Sequoia, Quick Look Preview extension no longer loads MapKit maps correctly anymore. Map tiles do not appear, leaving users with a beige background.

Users report that polylines do render correctly, but annotations appears black.

This was previously working fine in prior macOS versions including Sonoma.

STEPS TO REPRODUCE

  1. Create a macOS app project, with an associated document.
  2. Ensure project has a Quick Look preview extension, with necessary basic setups.
  3. Ensure that the extension mentioned in (2) must have a MKMapView. Any other cosmetic changes, etc, does not need to be implemented to observe the base issue. Do note that it has been reported that in addition to the map tiles not loading, annotations don't render correctly as well.

Since this is a change in behavior between what you had working in macOS 14 and macOS 15, you should start with a bug report, and include a test project that highlights the issue. Once you file that report, please post the FB number here.

As a means of a workaround, does your app require an interactive map in the preview? One thing you can consider as an alternative is that you can use MKMapSnapshotter to capture the map region you want to display in the preview as an image, rather than as a full MKKMapView. One of the strengths of using snapshots over a map view is that there is a lower memory overhead, which is generally important in extension contexts.

—Ed Ford,  DTS Engineer

Quick Look Extension does not load MapKit map properly anymore, after macOS Sequoia
 
 
Q