boinc/android/Vagrant.README.md

Goals

Provide a turn-key VM for Android development

Requirements

• Vagrant
• VirtualBox
• Host:
  • 4 CPU cores (2 used by VM)
  • ~18 GB disk space
  • 4 GB RAM (2 used by VM)
• Download volume (once): ~3.5 GB

HOWTO

1. On your host: open a terminal
   1. cd <BOINC_REPO>/android
   2. vagrant up
   3. Wait until the final reboot finished
   4. From this point on you don't need Vagrant anymore
      1. Don't run vagrant up again!
      2. Just use VirtualBox to stop/start your new shiny VM
2. In the VM:
   1. Log in with vagrant/vagrant
   2. Open a terminal
      1. cd BOINC/android
      2. ./build_all.sh
   3. Start Android Studio
   4. No need to change anything in the setup assitant (just complete it)
      • OK / Next / Next / Finish / Finish
   5. Import the BOINC App as Gradle project from: ~/BOINC/android/BOINC
   6. Ignore potential Gradle Plugin warning: Don't remind me again
3. Hook up your Android device via USB (and remember to attach it to VirtualBox)
4. Happy hacking :-)

Known 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).