Installation

Installing CommCare

1. To install CommCare, first install JavaRosa by running through all the setup instructions described here, except for one small difference: instead of cloning http://bitbucket.org/javarosa/javarosa, clone http://github.com/dimagi/javarosa. The latter is slightly more in sync with the CommCare build (although note that all changes committed to commcare/javarosa do get pushed to javarosa/javarosa).
2. Next, clone the CommCare repo in the same Eclipse workspace in which you have JavaRosa. The most stable code is available on the default branch. The latest functionality is available on the CommCare 1.1 branch.
3. Finally, resolve all the library dependencies.

4 Namely, CommCare has the same dependencies as JavaRosa. When you check out the commcare repo and attempt to build org.commcare.app/build.xml, it will expect these dependencies to be in the folder commcare/application/tools. You can either copy these jars directly into commcare/application/tools (not recommended), or you can update the 'dir.tools' variable in build.properties of the org.commcare.app to point to the javarosa/j2me/demo-app/tools. The reference jars include:

• j2merosa-libraries.jar
• j2meunit-javarosa.jar
• ant-contrib.jar

5 To get the Ant extensions working, go to Eclipse -> Windows -> Preferences -> Ant -> Global Runtime -> a dd jar, and select the location of antcontrib jar.

6 Similarly, you'll want to update the 'dir.lib' variable in build.properties to point to javarosa/lib, or copy the jars from javarosa-lib to commcare/application/lib (not recommended).