diff options
author | Thiago Marcos P. Santos <tmpsantos@gmail.com> | 2020-02-07 18:57:44 +0200 |
---|---|---|
committer | Thiago Marcos P. Santos <tmpsantos@gmail.com> | 2020-02-07 19:12:13 +0200 |
commit | ddd40ec19906df0d8e7eb0a97ba8965019e0f641 (patch) | |
tree | fb6c91d42e762607fac826caf8e8240a4f96fb03 | |
parent | 551d896260459714d45d2bd537cd8273c26b889d (diff) | |
download | qtlocation-mapboxgl-upstream/tmpsantos-new_buildsystem_migration.tar.gz |
[documentation] Updated README/INSTALL/etcupstream/tmpsantos-new_buildsystem_migration
To reflect changes in the buildsystem.
-rw-r--r-- | INSTALL.md | 15 | ||||
-rw-r--r-- | README.md | 46 |
2 files changed, 18 insertions, 43 deletions
diff --git a/INSTALL.md b/INSTALL.md deleted file mode 100644 index 463d199d10..0000000000 --- a/INSTALL.md +++ /dev/null @@ -1,15 +0,0 @@ -# Building & Developing from Source - -**Just trying to use one of the Mapbox Maps SDKs? You don't need to read this stuff! We -provide [easy-to-install, prebuilt versions of the Mapbox Maps SDKs for iOS and Android -that you can download instantly and get started with fast](https://www.mapbox.com/install/).** - -If you're certain you need to build from source, rather than using a prebuilt SDK, please -refer to the installation instructions for the platform of interest: - -* [Mapbox Maps SDK for Android](platform/android/README.md) -* [Mapbox Maps SDK for iOS](platform/ios/INSTALL.md) -* [Mapbox Maps SDK for macOS](platform/macos/INSTALL.md) -* [Mapbox Maps SDK for Qt](platform/qt/README.md) -* [Mapbox GL Native on Linux](platform/linux/README.md) -* [node-mapbox-gl-native](platform/node/DEVELOPING.md) @@ -1,42 +1,32 @@ # Mapbox GL Native +[![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) [![Coverage Status](https://codecov.io/gh/mapbox/mapbox-gl-native/branch/master/graph/badge.svg)](https://codecov.io/gh/mapbox/mapbox-gl-native) + A library for embedding interactive, customizable vector maps into native applications on multiple platforms. It takes stylesheets that conform to the [Mapbox Style Specification](https://github.com/mapbox/mapbox-gl-style-spec/), applies them to vector tiles that conform to the [Mapbox Vector Tile Specification](https://github.com/mapbox/vector-tile-spec), -and renders them using OpenGL. [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is the WebGL-based counterpart, +and renders them using OpenGL or Metal. [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) is the WebGL-based counterpart, designed for use on the Web. -| SDK | Languages | Build status | -| --------------------------------------------------- | ---------------------------------- | ---------------------------------------- | -| Mapbox GL Native Core | C++14 | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) [![Coverage Status](https://codecov.io/gh/mapbox/mapbox-gl-native/branch/master/graph/badge.svg)](https://codecov.io/gh/mapbox/mapbox-gl-native) | -| [Mapbox Maps SDK for Android](../platform/android/) | Java | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) | -| [Mapbox Maps SDK for iOS](../platform/ios/) | Objective-C or Swift | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) | -| [Mapbox Maps SDK for macOS](../platform/macos/) | Objective-C, Swift, or AppleScript | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) | -| [node-mapbox-gl-native](../platform/node/) | Node.js | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) | -| [Mapbox Maps SDK for Qt](../platform/qt) | C++03 | [![Circle CI build status](https://circleci.com/gh/mapbox/mapbox-gl-native.svg?style=shield)](https://circleci.com/gh/mapbox/workflows/mapbox-gl-native/tree/master) [![AppVeyor CI build status](https://ci.appveyor.com/api/projects/status/3q12kbcooc6df8uc?svg=true)](https://ci.appveyor.com/project/Mapbox/mapbox-gl-native) | +## Developing -[Additional Mapbox GL Native–based libraries](https://wiki.openstreetmap.org/wiki/Mapbox_GL#Libraries) for **hybrid applications** are developed outside of this repository. If your platform or hybrid application framework isn’t listed there, consider embedding [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) using the standard Web capabilities on your platform. +We use [CMake](https://cmake.org/cmake/help/latest/) to build Mapbox GL Native +to various platforms, including Linux, Android, iOS, macOS and Windows. -## License +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. -Mapbox GL Native is licensed under the [3-Clause BSD license](../LICENSE.md). - -## Developing +``` +$ git update submodules --init --recursive +$ cmake . -B build +$ cmake --build build +``` -The `next` directory contains the next generation buildsystem for Mapbox GL Native, based solely on CMake with the -goal of minimizing the use of scripts, increase portability and support building Mapbox GL Native as a subdirectory -of another CMake project. This new buildsystem is also designed to build offline, making use of pre-installed and -vendorized dependencies. When using the build bot docker image, the build should produce the exact same results as -the bots, making it a hermetically sealed build for Linux, Qt and Android. +Read more about how to build Mapbox GL Native for your platform [here](DEVELOPING.md). -### Building and running tests +## License -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. +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): -``` -$ mkdir build && cd build -$ cmake .. -$ make -j8 -$ make test ARGS=-V -``` +[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fmapbox-gl-native.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmapbox%2Fmapbox-gl-native) |