== 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 [http://code.google.com/p/opendatakit/source/list?repo=collect opendatakit collect repository] with this command:
{{{
hg clone https://collect.opendatakit.googlecode.com/hg/ opendatakit-collect
}}}

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), or use the configured Sahana Eden application downloadable from Android Market, enable accept self signed certificates to work with Sahana Eden demo site.


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

----
BluePrintMobileClient

UserGuidelinesMobile