Environment setup
Having installed ruby you may find that you need to install a few basic programs to get off the ground.
gem install bundler
bundle install
####Optional
On OS-X gems will default to being saved in root owned location. It is possible to create a custom gem location and point ruby gems to use that.
bundle install gem_name --path /custom location
Or you can set all gems to a particular directory
mkdir -p ~/.gems
export GEM_HOME="$HOME/.gems"
export GEM_PATH="$GEM_HOME:/var/lib/ruby/gems/1.8"
Run the following shell commands to get the basic setup required
ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
brew doctor
brew install android-sdk
####Optional
brew install rbenv rbenv-gem-rehash ruby-build
rbenv install 2.1.2
rbenv global 2.1.2
rbenv rehash
Notice: Brew will have set your $ANDROID_HOME path so you don't need to worry about it.
It is important to make sure that before installing and AVD's you have the intel system image.
Also install HAXM support.
Note: Genymotion is an alternative to the native emulator.
Find AVD's available here..
It is important to enable the host GPU and prefer an Intel processor. In addition to this you may want to generate some SD card space to enable download of books in app.
For avd's to install APK's that have been created by developers in debug mode or release you will need to sign them.
To do this; generate a keystore.
keytool -genkey -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=Android Debug,O=Android,C=US"
A good generic set up steps needed for android-calabash to work with your apk can be found here: environment-setup-for-calabash-testing
Please find the README available that covers basic project usage.
For additional commands run rake -T in the project directory.