f964e40e7e
* Main gyp files are now standardized as platform/<platform>/platform.gyp. * Each platform gyp file defines appropriate loop_lib and headless_lib variables. * Each platform gyp file includes mbgl.gypi, which defines base targets which may be useful to all platforms. * CI targets are consistent across platforms: `make $(PLATFORM) && make test-$(PLATFORM)`. * Renamed the "linux" test app to "glfw". It's now built in OS X CI. * Android build flakiness is fixed. * iOS CI builds the bench and iosapp targets. * Mesa version is now in one place. * CI scripts use bash "strict mode" and correct error handling. * All build output goes to the build directory. * Removed vestigial iOS/OS X/Android Travis scripts.
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# Linux
|
|
|
|
A simple map application and test suite for Linux based on [Mapbox GL Native](../../README.md) and [GLFW](https://github.com/glfw/glfw).
|
|
|
|
We are using Ubuntu for development. While the software should work on other distributions as well, we are not providing explicit build instructions here.
|
|
|
|
This process gives you a Linux desktop app built on a Linux host system.
|
|
|
|
### Build
|
|
|
|
Install GCC 4.9+ if you are running Ubuntu 14.04 or older. Alternatively, you can also use [Clang 3.5+](http://llvm.org/apt/).
|
|
|
|
sudo add-apt-repository --yes ppa:ubuntu-toolchain-r/test
|
|
sudo apt-get update
|
|
sudo apt-get install gcc-4.9 g++-4.9
|
|
export CXX=g++-4.9
|
|
|
|
Ensure you have git and other build essentials:
|
|
|
|
sudo apt-get install curl git build-essential zlib1g-dev automake \
|
|
libtool xutils-dev make cmake pkg-config python-pip \
|
|
libcurl4-openssl-dev libpng-dev libsqlite3-dev \
|
|
libllvm3.4
|
|
|
|
Install glfw3 dependencies:
|
|
|
|
sudo apt-get install libxi-dev libglu1-mesa-dev x11proto-randr-dev \
|
|
x11proto-xext-dev libxrandr-dev \
|
|
x11proto-xf86vidmode-dev libxxf86vm-dev \
|
|
libxcursor-dev libxinerama-dev
|
|
|
|
Set the environment variable `MAPBOX_ACCESS_TOKEN` to your [Mapbox access token](ACCESS_TOKEN.md):
|
|
|
|
export MAPBOX_ACCESS_TOKEN=MYTOKEN
|
|
|
|
Then, you can then proceed to build the test application:
|
|
|
|
make glfw-app
|
|
|
|
Set an access token as described below, and then run:
|
|
|
|
make run-glfw-app
|
|
|
|
### Test
|
|
|
|
- `make test-*` Builds and runs all tests. You can specify individual tests by replacing * with their name (e.g. `make test-Sprite.CustomSpriteImages`).
|
|
|
|
The `zsh` will treat the * in this command as a glob, so you'll need to run
|
|
`make "test-*"` instead.
|
|
|
|
### Usage
|
|
|
|
Keyboard shortcuts for testing functionality are logged to the console when the test app is started.
|