MapLibreParticleLab/docs/BUILD_OSX.md

Building Mapbox GL Native for OS X

This project provides an OS X SDK analogous to the Mapbox iOS SDK. Mapbox does not officially support it to the same extent as the iOS SDK; however, bug reports and pull requests are certainly welcome. This document explains how to build the OS X SDK and integrate it into your own Cocoa application.

Build

1. Run make xpackage, which produces a Mapbox.framework in the gyp/build/Release/ folder.

Install

1. Copy gyp/build/Release/Mapbox.framework into your project. It should happen automatically, but ensure that Mapbox.framework is listed in the Linked Frameworks and Libraries section of the General tab for your application target.

2. Mapbox vector tiles require a Mapbox account and API access token. In the project editor, select the application target. In the Info tab, set MGLMapboxAccessToken to your access token. You can obtain one from the Mapbox account page.

3. In a XIB or storyboard, add a Custom View and set its custom class to MGLMapView. If you need to manipulate the map view programmatically, import the Mapbox module (Swift) or Mapbox.h umbrella header (Objective-C).

Troubleshooting

You can also try clearing the Xcode cache with make clear_xcode_cache.