| 1 | |
| 2 | == Downloading and compiling OCR Collect, an Android XForms client == |
| 3 | |
| 4 | |
| 5 | |
| 6 | Using Windows syntax since if you know *nix you'll understand the windows command line. |
| 7 | |
| 8 | * Install Java 1.6+ |
| 9 | |
| 10 | * Install Android SDK http://developer.android.com/sdk/index.html |
| 11 | |
| 12 | * Install ANT, primarily a cross platform Java build automation tool. |
| 13 | Download and extract Ant (1.8.1 at time of writing): http://ant.apache.org/bindownload.cgi [[BR]] |
| 14 | # Create 'ANT_HOME' environment variable.[[BR]] |
| 15 | # Add '%ANT_HOME%\bin' directory to 'PATH' environment variable.[[BR]] |
| 16 | |
| 17 | * Clone "Collect" source from repository |
| 18 | |
| 19 | First you need yet another SCM tool, introducing HG Mercurial: |
| 20 | Install HG Mercurial appropriate to your platform: http://mercurial.selenic.com/downloads/ During setup defaults will suffice. |
| 21 | |
| 22 | * Next we'll copy the code per http://code.google.com/p/opendatakit/source/checkout?repo=collect |
| 23 | |
| 24 | Get a local copy of the opendatakit collect repository with this command: ''hg clone https://collect.opendatakit.googlecode.com/hg/ opendatakit-collect'' |
| 25 | |
| 26 | 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]] |
| 27 | |
| 28 | Import project into Eclipse (loaded with Android plugin http://developer.android.com/sdk/eclipse-adt.html) |
| 29 | |
| 30 | Run or Debug as desired (Tested on HTC Incredible SDK 3.0+ required) |
| 31 | |
| 32 | Use an Emulator if you do not have a phone connected via USB. |
| 33 | |
| 34 | 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). |
| 35 | |
| 36 | References: |
| 37 | 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 |