Files

Lucas Wojciechowski 94734441ce Update & simplify INSTALL.md (#11155 )

* Update & simplify INSTALL.md

* Add "Launch Xcode" step

* Update INSTALL.md

2018-02-12 12:06:36 -08:00

2.3 KiB

Raw Blame History

Building & Developing Mapbox GL Native from Source

Just trying to use Mapbox GL Native? 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.

Still with us? These are the instructions you'll need to build Mapbox GL Native from source on a variety of platforms and set up a development environment.

Your journey will start with installing dependencies, then getting the source code, and then setting up a development environment, which varies depending on your operating system and what platform you want to develop for.

1: Installing dependencies

macOS

Install Xcode
Launch Xcode and install any updates
Install Homebrew
Install Node.js, CMake, and ccache with brew install nodejs cmake ccache
Install xcpretty with [sudo] gem install xcpretty (optional, used for prettifying command line builds)

Linux

Install the following:

clang++ 3.5 or later or g++ 4.9 or later
git
CMake 3.1 or later
cURL
Node.js 4.2.1 or later
libcurl (depends on OpenSSL)
ccache (optional, improves recompilation performance)

2: Getting the source

Clone the git repository:

 git clone https://github.com/mapbox/mapbox-gl-native.git
 cd mapbox-gl-native

3: Setting up a development environment & building

See the relevant SDK documentation for next steps:

4: Keeping up to date

This repository uses Git submodules, which should be automatically checked out when you first run a make command for one of the above platforms. These submodules are not updated automatically and we recommended that you run git submodule update after pulling down new commits to this repository.

2.3 KiB Raw Blame History