wiki:DeveloperGuidelines/Mobile/Android

Version 2 (modified by Charles B Havranek, 11 years ago) ( diff )

--

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 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
# Create 'ANT_HOME' environment variable.
# Add '%ANT_HOME%\bin' directory to 'PATH' environment variable.

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

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

  • 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

Note: See TracWiki for help on using the wiki.