summaryrefslogtreecommitdiff
path: root/docs/ANDROID_SIMULATOR.md
diff options
context:
space:
mode:
authorTom MacWright <tom@macwright.org>2015-10-26 11:36:19 -0400
committerTom MacWright <tom@macwright.org>2015-10-27 16:43:54 -0400
commit3fca2455ad8d9734d35c68333b14b104f3d5de5b (patch)
tree6bd3b999302b81514c9c6c1ecb388098dc9b24e5 /docs/ANDROID_SIMULATOR.md
parentaf5271cd3ec6b86d7121201243c1678426e64b62 (diff)
downloadqtlocation-mapboxgl-3fca2455ad8d9734d35c68333b14b104f3d5de5b.tar.gz
[docs] Recreate structure of documentation
Diffstat (limited to 'docs/ANDROID_SIMULATOR.md')
-rw-r--r--docs/ANDROID_SIMULATOR.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/ANDROID_SIMULATOR.md b/docs/ANDROID_SIMULATOR.md
new file mode 100644
index 0000000000..98959f298c
--- /dev/null
+++ b/docs/ANDROID_SIMULATOR.md
@@ -0,0 +1,21 @@
+# Setting up Android emulator
+
+If you want to run the test app in the emulator, we recommend the x86 build because it will run a lot faster.
+
+First ensure you have an `MAPBOX_ACCESS_TOKEN` environment variable set, as described below. Then, create an x86 build:
+
+ make android-lib-x86
+
+In Android Studio, create an x86 AVD (Android Virtual Device):
+
+- Open AVD Manager via the Tools menu -> Android -> AVD Manager
+- Click "Create Virtual Device" at the bottom on AVD Manager window
+- Select one of the device profiles, for example the Nexus 4
+- Click "Next"
+- Select a Lollipop or Kitkat release with ABI of x86. If the line is greyed out click Download to download the OS files.
+- Click "Next"
+- Under "Emulated Performance" check "Host GPU" and uncheck "Store a snapshot for faster startup"
+- Click "Finish"
+- Close the AVD Manager
+
+Now when you run or debug the Android project you will see a window "Choose Device". Select your new AVD from drop down under "Launch emulator". If you select "Use same device for future launches" Android Studio will remember the selection and not ask again.