Compiling
=========

Preconditions
----------------

1. Android SDK installed (follow instructions from http://developer.android.com/sdk/index.html).
2. Android SDK tools and platform-tools reachable within $PATH
3. API version 15 installed.
4. Ant 1.6 or greater

Instructions to compile
-----------------------

1. cd $PROJECT_LOCATION/bitmask_android
2. ./compile.sh

Postconditions
--------------

1. $PROJECT_LOCATION/bitmask_android/bin/Bitmask for Android-debug.apk exists

Running on the emulator
=========================

Preconditions
-----------------

1. compile.sh script works.
2. An avd exists in ~/.android/avd/ (if you do not have one, follow instructions from http://developer.android.com/tools/devices/managing-avds-cmdline.html)

Instructions to run on the emulator
-----------------------------------

1. cd $PROJECT_LOCATION/bitmask_android
2. Run script: ./run.sh @AVD-NAME . (avd names are the names of the files in ~/.android/avd with extension .avd).

Postconditions
--------------

1. Bitmask for Android is running.

Debugging from console
======================

Preconditions
-----------------

1. run.sh script works
2. jdb is installed (this program is part of OpenJDK 7)

Instructions to debug from the console
-----------------------------------

1. cd $PROJECT_LOCATION/bitmask_android
2. Run script: ./debug.sh @AVD-NAME . (avd names are the names of the files in ~/.android/avd with extension .avd).

Postconditions
--------------

1. Bitmask for Android is running.
2. Bitmask for Android does not show the message "Application Bitmask for Android (process se.leap.bitmaskclient) is waiting for the debugger to attach".
3. You are in a jdb debugging session.