= HOWTO build FLOSS Dispenser =

On Debian/Ubuntu (as root): {{{
apt-get install maven2
}}}

Unfortunately, the most convenient way to get the SDK is distributed by the Android ''Open Source'' Project, but that copy contains proprietary Google code and is wrapped in a restrictive proprietary license agreement. You can obtain a free SDK by following the [wiki:FreeSDK directions] in our wiki.

• [http://developer.android.com/sdk/adding-components.html Install the necessary SDK support] * Include at least Android 1.1, 1.5, and 2.0 * You may need to create a `temp` directory at the top level of your SDK directory * You may also need to check the "Force HTTP" option under "Settings"

This will allow us to set up a Maven dependency for particular versions of Android. {{{
export ANDROID_HOME=/path/to/sdk/
}}} * Install maven-android-sdk-deployer * cd into the directory where you unpacked the maven-android-sdk-deployer sources. * Install maven-android-sdk-deployer according to the directions in the README file (either just `mvn install` for all platforms or `mvn install -P [platform]` if you want to install for just one).

• Get [http://github.com/mosabua/maven-android-sdk-deployer/archives/master the latest stable version] of maven-android-sdk-deployer
• Set your ANDROID_HOME environment variable to point to your copy of the Android SDK:

Add the Android SDK's primary and platform tools directories to your path (to give `mvn` access to `aapt` and `apkbuilder`). Currently, the build process targets Android 1.5, but if you've changed it to target a different platform, use that one in the second export command. {{{
export PATH=${PATH}:<your_sdk_dir>/tools
export PATH=${PATH}:<your_sdk_dir>/platforms/android-1.5/tools
}}}