5c93b0dead
For historical reasons, developers may come here when looking for the Mapbox Maps SDK. Direct them to the right repository so they don’t get confused thinking Mapbox only provides a C++ library.
35 lines
2.3 KiB
Markdown
35 lines
2.3 KiB
Markdown
# Mapbox GL Native
|
|
|
|
[](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) [](https://codecov.io/gh/mapbox/mapbox-gl-native)
|
|
|
|
A C++ library that powers customizable vector maps in native applications on multiple platforms by taking stylesheets that conform to the [Mapbox Style Specification](https://docs.mapbox.com/mapbox-gl-js/style-spec/), applying them to vector tiles that conform to the [Mapbox Vector Tile Specification](https://github.com/mapbox/vector-tile-spec/), and rendering them using OpenGL or Metal.
|
|
|
|
To embed interactive maps into a native application using a platform-specific language, install the Mapbox Maps SDK:
|
|
|
|
* [Mapbox Maps SDK for Android](https://github.com/mapbox/mapbox-gl-native-android/) (Java, Kotlin)
|
|
* [Mapbox Maps SDK for iOS](https://github.com/mapbox/mapbox-gl-native-ios/blob/master/platform/ios/) (Objective-C, Swift, Interface Builder)
|
|
* [Mapbox Maps SDK for macOS](https://github.com/mapbox/mapbox-gl-native-ios/tree/master/platform/macos/) (Objective-C, Swift, Interface Builder, AppleScript)
|
|
|
|
[Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is the WebGL-based counterpart to Mapbox GL Native that is designed for use on the Web.
|
|
|
|
## [Developing](DEVELOPING.md)
|
|
|
|
We use [CMake](https://cmake.org/cmake/help/latest/) to build Mapbox GL Native
|
|
for various platforms, including Linux, Android, iOS, macOS and Windows. The
|
|
following command, executed from the root of this repository tree, will build
|
|
Mapbox GL Native targeting your host architecture given that you have all the
|
|
dependencies installed and run the example app.
|
|
|
|
```
|
|
$ git submodule update --init --recursive
|
|
$ cmake . -B build
|
|
$ cmake --build build
|
|
$ MAPBOX_ACCESS_TOKEN=my_access_token_here ./build/platform/glfw/mbgl-glfw
|
|
```
|
|
|
|
## License
|
|
|
|
Mapbox GL Native is licensed under the [2-Clause BSD license](LICENSE.md). The licenses of its dependencies are tracked via [FOSSA](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fmapbox-gl-native):
|
|
|
|
[](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fmapbox-gl-native)
|