== Downloading and compiling ODK Collect, an Android XForms client ==

Using Windows syntax since if you know *nix you'll understand the windows command line.

  * Install Java 1.6+

  * Install Android SDK: http://developer.android.com/sdk/index.html

  * Install ANT, primarily a cross platform Java build automation tool.
Download and extract Ant (1.8.1 at time of writing): http://ant.apache.org/bindownload.cgi [[BR]]
# Create 'ANT_HOME' environment variable.[[BR]]
# Add '%ANT_HOME%\bin' directory to 'PATH' environment variable.[[BR]]

=== Clone "Collect" source from repository ===

Install yet another SCM tool, [http://mercurial.selenic.com/downloads/ HG Mercurial]
 * defaults will suffice during setup

Get a local copy of the opendatakit collect repository with this command:
{{{
hg clone https://collect.opendatakit.googlecode.com/hg/ opendatakit-collect
}}}
=== Editing Code ===

Import project into Eclipse (loaded with Android plugin http://developer.android.com/sdk/eclipse-adt.html)  

Run or Debug as desired (Tested on HTC Incredible SDK 3.0+ required)

Use an Emulator if you do not have a phone connected via USB.

To deploy you'll need to create a self signed keystore and use the .apk packaging wizard(Right click on project, menu Android tools, Export signed).

=== References ===
 * ANT samples
  * http://code.google.com/p/autoandroid/wiki/AndroidAnt
  * http://www.disgruntledrats.com/?p=27

----
[wiki:BluePrintMessagingModuleJ2ME]