h1. HOWTO build FLOSS Dispenser



h2. Install Maven


On Debian/Ubuntu (as root):
<pre>
 apt-get install maven2
</pre>


h2. Download the Android SDK


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 [[FreeSDK|directions]] in our wiki.

* "the necessary SDK support":http://developer.android.com/sdk/adding-components.htmlInstall
** 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"


h2. Install maven-android-sdk-deployer


This will allow us to set up a Maven dependency for particular versions of Android.

** Get "the latest stable version":http://github.com/mosabua/maven-android-sdk-deployer/archives/master of maven-android-sdk-deployer
** Set your ANDROID_HOME environment variable to point to your copy of the Android SDK:
<pre>
export ANDROID_HOME=/path/to/sdk/
</pre>
** 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).


h2. Add SDK tools/ directories to PATH


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.
<pre>
export PATH=${PATH}:<your_sdk_dir>/tools
export PATH=${PATH}:<your_sdk_dir>/platforms/android-1.5/tools
</pre>


h2. Get FLOSS Dispenser sources

<pre>
mkdir fd-readonly
cd fd-readonly
git clone git://gitorious.org/replicant/floss-dispenser.git
</pre>


h2. Download necessary libraries and build FLOSS Dispenser

<pre>
mvn clean install
</pre>