On Ubuntu 12:04 install these packages:

sudo apt-get install default-jdk ant

If you user 64bit system, install this (since Android SDK only available for 32bit):

sudo apt-get install ia32-libs

Check if you have a working version of java:

> java -version
java version "1.7.0_21"
Java(TM) SE Runtime Environment (build 1.7.0_21-b11)
Java HotSpot(TM) 64-Bit Server VM (build 23.21-b01, mixed mode)

And Apache Ant:

> ant -version
Apache Ant(TM) version 1.8.2 compiled on December 3 2011

Download Android SDK Tools from

> wget ''
> tar -xaf android-sdk_r21.1-linux.tgz

Open Android SDK Manager:

> ./android-sdk-linux/tools/android sdk

And follow these instructions:

You need to download Android 2.3.3 (API 10) folder. Alsou you can download SDK sources from Android 4.2.2 (API 17), since 2.3.3 does not provide this. Source are usefull for integration with editor. If you are not planing to do integration with editor, you will not need sources.

Setup environment variables for Android SDK:

> export ANDROID_HOME=$PWD/android-sdk-linux

Now you can compile and deploy app to your device (see Makefile):

make install

If you only want to compile, run:


Test project is alsow available but currently does not contain any tests. You can run tests using this command:

make test

Debugging notes

Use logcat to see what is happening on your device:

adb logcat '*:I'

Use adb shell to browse and manage your device:

adb shell

Data exchange format

For data exchange we use Akoma Ntoso XML schema designed for parliamentary, legislative and judiciary documents.