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

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

 1. Install [http://java.sun.com/javase/downloads/widget/jdk6.jsp Java JDK]
 2. Install [http://developer.android.com/sdk/index.html Android SDK]
 3. Install ANT, a cross platform Java build automation tool.
  * Download and extract Ant (1.8.1 at time of writing): http://ant.apache.org/bindownload.cgi
  * Create 'ANT_HOME' environment variable.
  * Add '%ANT_HOME%\bin' directory to 'PATH' environment variable.
=== 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
}}}

Sahana Eden Branded ODK Collect downloadable from Android Market, enable accept self signed certificates to work with Sahana Eden demo site.

jaxdroid has a tree with some changes here:
 * http://code.google.com/r/jaxtrx-edenodkcollect/
{{{
hg clone https://jaxtrx-edenodkcollect.googlecode.com/hg/ jaxtrx-edenodkcollect
}}}
=== Editing Code ===

 1. Install [http://www.eclipse.org/downloads/packages/pulsar-mobile-java-developers/galileosr2 Eclipse 3.5] (3.6 has problems with the Android plugin)
 2. Install [http://developer.android.com/sdk/eclipse-adt.html Android plugin]
 3. Import project into Eclipse (project name should avoid spaces)
 4. Run or Debug as desired (Tested on HTC Incredible SDK 3.0+ required)

Use an [http://developer.android.com/guide/developing/tools/emulator.html 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

----
BluePrintMobileClient

UserGuidelinesMobile