== Downloading and compiling OCR 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

First you need yet another SCM tool, introducing HG Mercurial:
Install HG Mercurial appropriate to your platform:  http://mercurial.selenic.com/downloads/ During setup defaults will suffice.

  * Next we'll copy the code per http://code.google.com/p/opendatakit/source/checkout?repo=collect

Get a local copy of the opendatakit collect repository with this command: ''hg clone https://collect.opendatakit.googlecode.com/hg/ opendatakit-collect''

Assuming the source : "https://collect.opendatakit.googlecode.com/hg/ opendatakit-collect" and destination of c:\temp\collect, source files from Google will be located @ c:\temp\collect\src[[BR]]

  * 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, "Collect" Google code repository; http://code.google.com/p/opendatakit/source/checkout?repo=collect, http://developer.android.com/sdk/installing.html