Mapbox macOS SDK

The Mapbox macOS SDK is an open-source framework for embedding interactive map views with scalable, customizable vector maps into Cocoa applications on macOS 10.10.0 and above using Objective-C, Swift, Interface Builder, or AppleScript. The Mapbox macOS SDK takes stylesheets that conform to the Mapbox Style Specification, applies them to vector tiles that conform to the Mapbox Vector Tile Specification, and renders them using OpenGL.

For setup information, consult the README.md that comes with this documentation. For further instructions, consult the macOS SDK documentation. The Mapbox iOS SDK’s API documentation and online examples apply to the Mapbox macOS SDK with few differences, mostly around unimplemented features like user location tracking. A full changelog is also available.

Mapbox does not officially support the macOS SDK to the same extent as the iOS SDK; however, bug reports and pull requests are certainly welcome.

Changes in version 0.3.1

This version of the Mapbox macOS SDK corresponds to version 3.4.2 of the Mapbox iOS SDK.

  • Fixed an issue causing MGLMapView’s camera’s heading to be set to a negative value, indicating an undefined heading, when the map view faces northwest. The heading is now wrapped to between zero and 360 degrees, for consistency with MGLMapView’s direction property. (#7724)
  • Fixed a crash that occurred when moving a window containing an MGLMapView from one screen to another. (#8004)
  • Fixed an issue preventing the use of the integrated GPU on machines that have more than one GPU. Follow the instructions in Technical Q&A 1734 to enable integrated GPU usage in your application. (#7834)
  • Fixed an issue causing the mouse cursor to jump after shift- or option-dragging a map view if the window opened on a screen with a different size than the screen with keyboard focus. (#7846)
  • Deprecated the style class methods in MGLStyle. (#7785)
  • Improved the performance of trivial camera animations. (#7125)