Project setup

We are currently targeting Android v2.3.6 because those are the devices that are currently used. However, this is going to change as we shall be supporting Android v4.0.x and above, since its getting very difficult to find 2.3.x devices in the first place.

Setup Android SDK

• Download the android sdk from the android developers website and unzip the same. If you are on Mac, it is recommended to use homebrew to install Ex: 'brew install android'
• Enter android sdk in your terminal to open the SDK manager, and install the following items:
  • Platform tools
  • Build tools
  • Extras > Android support library
  • Extras > Android maven repository
  • Android 2.3 API
  • Android 2.3 System Image for the emulator
• Enter android avd to open the AVD (Emulator) manager
  • Create an AVD (from within the SDK Manager) with the size 240320. The least resolution we would be using is 240320, so, testing for that resolution will help.
  • Launch the created AVD

As a faster alternative to using the android AVD, you can use Genymotion for instructions on how to setup and use Genymotion visit (https://cloud.genymotion.com/page/doc/)

IDE setup

IntelliJ Idea 13 Community Edition

• Click File -> Open Project and select the pom file, and the Maven project will be automatically imported. For more information on how to do this (http://www.jetbrains.com/idea/webhelp/importing-project-from-maven-model.html)
• Intellij comes with default Android support, so once the project is loaded it asks for configuring the android framework. Go ahead and configure the framework.
• From IntelliJ Preferences -> Plugins, install the Lombok Plugin. We are using Project Lombok to generate helper methods (like getters, setters, etc)
• To run the tests in IntelliJ select the appropriate test file and run it as a junit test
• If you get any error related to maven, then click on Preferences => Maven then specify the Maven home directory: to the path of the maven home (In Mac OSX its /usr/share/maven.)
• If you get an error saying "ANDROID_HOME" not found, go to IntelliJ Preferences > Path Variables, and add an entry for ANDROID_HOME. The ANDROID_HOME points to the "sdk" folder in your Android SDK.

Making Android Emulator Run Faster On Your machine

• Use GenyMotion to launch the AVDs