From c447506cb781878add85c75d35296f80b3db200d Mon Sep 17 00:00:00 2001
From: Oliver Bock <oliver.bock@aei.mpg.de>
Date: Wed, 29 Mar 2017 15:37:35 +0200
Subject: [PATCH] [#1829][android] Added README/HOWTO for Vagrant

---
 android/Vagrant.README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 android/Vagrant.README.md

diff --git a/android/Vagrant.README.md b/android/Vagrant.README.md
new file mode 100644
index 0000000000..d634d029bb
--- /dev/null
+++ b/android/Vagrant.README.md
@@ -0,0 +1,32 @@
+## Goals
+
+Provide a turn-key VM for Android development
+
+## Requirements
+
+* Vagrant
+* VirtualBox
+
+## HOWTO
+
+1. On your host: open a terminal
+   1. `cd <BOINC_REPO>/android`
+   1. `vagrant up`
+   1. Wait until the final reboot finished
+   1. `vagrant ssh`
+   1. `cd BOINC/android`
+   1. `./build_all.sh`
+1. In the VM:
+   1. Log in with `vagrant/vagrant`
+   1. Start Android Studio
+   1. No need to change anything in the setup assitant (just complete it)
+      * OK / Next / Next / Finish / Finish
+   1. Import the BOINC App as *Gradle* project from: `~/BOINC/android/BOINC`
+   1. Ignore potential Gradle Plugin warning: Don't remind me again
+1. Hook up your Android device via USB (and remember to attach it to VirtualBox)
+1. Happy hacking :-)
+
+## Know limitations
+
+* The Android Virtual Device Manager might not work properly as it needs virtualization
+  which isn't possible within a virtual machine (at least not using VirtualBox).