Replicant

= HOWTO build FLOSS Dispenser =

== Install Maven ==

On Debian/Ubuntu (as root):

{{{

 apt-get install maven2

}}}

== 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 [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"

== Install maven-android-sdk-deployer ==

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

  * 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:

{{{

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).

== 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.

{{{

export PATH=${PATH}:<your_sdk_dir>/tools

export PATH=${PATH}:<your_sdk_dir>/platforms/android-1.5/tools

}}}

== Get FLOSS Dispenser sources ==

{{{

mkdir fd-readonly

cd fd-readonly

git clone git://gitorious.org/replicant/floss-dispenser.git

}}}

== Download necessary libraries and build FLOSS Dispenser ==

{{{

mvn clean install

}}}