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