The Code has been moved to BitBucket

So follow this link:

 Getting Started

Instructions below here are now outdated (DO NOT READ)

Getting Started with JavaROSA Development

Error: Failed to load processor TracNav
No macro or processor named 'TracNav' found

The repository is publicly accessible with read-only permissions. For write permissions, please contact a member of the javarosa-developers community.

For Unix(Linux and Mac OS) developers, go to http://code.dimagi.com/JavaRosa/wiki/JavaRosaOnUnix

Setting Up the Development Environment

Several of these installs are not small, make sure you are on a stable connection when you try to download them. Please use the versions listed below to avoid problems.

  1. Install  Java Standard Edition Development Kit (JDK) 5.0
    • We recommend the the JDK 5.0 Update NN link. It is the third download button from the top.
  2. Install  Sun Java Wireless Toolkit for CLDC v 2.5.2_01.
    • Install to the non-default location of C:\WTK2.5.2.
  3. Install  Eclipse IDE for Java Developers
  4. Install  EclipseME v1.7.9 J2ME plugin
  5. Install  Subclipse v1.6 Subversion plugin
    • Install all required projects under Subclipse.
  6. Install  J2ME-Polish v2.0.4.
    • Set the WTK directory during the install process to C:\WTK2.5.2.
    • Install J2MEPolish to a directory of your choice, for example: C:\Program Files\J2ME-Polish
  7. Configure Eclipse to support Polish.
    • Define a new classpath variable called J2ME_POLISH_HOME (Window->Preferences->Java->Build Path->Classpath Variables) and set its value to the installation directory of J2MEPolish
    • Set your default JRE in Java->Install JREs points to a JDK not a JRE.
    • Restart Eclipse.
  8. Optional: Install any vendor-specific SDKs you may be interested in.

Setup J2ME in Eclipse

  1. In Eclipse, go to Window -> Preferences.
  2. Select the J2ME node, go to Device Management, and select Import.
  3. Specify C:\WTK2.5.2 as your search directory, select Refresh and upon completion, select Finish.
  4. Double click each device listing and edit the group to read 'Sun Java(TM) Wireless Toolkit 2.5.2 for CLDC'
  5. Select DefaultColorPhone (or another phone of choice) as your default.
  6. Restart Eclipse.
  7. Optional: If you installed any vendor-specific SDKs, you can import them now.

Getting the Code

JavaRosa's code base is split into a large number of individual projects, each of which is named by the lowest common namespace for the source files in each project. For instance, the project org.javarosa.communication contains the transport layer code for transporting data on and off of the device. All of the projects used by a JavaRosa application should be checked out into their own projects into the same directory. This process is automated by the Team Project Set file mentioned below.

  1. If you are creating a new workspace, follow "Setup J2ME in Eclipse" instructions above.
  2. Download the  javarosa_workspace.psf which will be used by Eclipse.
  3. Open Eclipse and go to File -> Import.
  4. Under Team, select "Team Project Set" and click Next.
  5. Locate the Team Project File that you saved and click Finish.

Eclipse will automatically build your workspace and this may result in one error. This is caused by some difference in the preprocessing between EclipseME and J2MEPolish. It can be avoided by overwriting the FramedForm.class in your J2ME-Polish jar with the modified version attached at the foot of this page.

If the import fails, please follow the Alternate Checkout instructions below.

Building the Code

  1. The main project to use is org.javarosa.demo. It has dependencies to the other projects, enumerated both in its .classpath file, and its build.xml file.
  2. Open the org.javarosa.demo project.
  3. Open the build.properties file.
  4. Ensure the polish.home variable is set to the location of J2ME-Polish on your system.
  5. Ensure the wtk.home variable is set to the location of the Sun Wireless Toolkit on your system. Repeat for any vendor-specific toolkits.
  6. Set the app.class variable is set to the name of the MIDlet you wish to run.
  7. Right click on the build.xml file and select Run As -> Ant Build.

Alternate Checkout

If you continue to have problems with the Team Project file, follow the directions below to get a checkout of the code.

  1. In Eclipse, open the "SVN Repository Exploring" Perspective. This can be found in Window->Open Perspective->Other...
  2. Right click, and select "New->Repository Location"
  3. Enter the URL:  http://code.dimagi.com/svn/JavaRosa
  4. Expand the node for the repository location
  5. Expand the node for 'trunk'
  6. Expand the 'javarosa' and 'j2merosa' directories
  7. Inside both the 'javarosa' and 'j2merosa' directories, select all of the "org.javarosa.*" projects by clicking on the first node under 'j2merosa' and then shift-clicking the bottom node. Then control-click the remaining "org.javarosa.*" projects under the 'javarosa' node.
  8. Right click on the selection and click "Checkout"
  9. On the next screen, hit Finish.

Troubleshooting Dev Environment

Troubleshooting the Development Environment

Set up Debugging

Debugging Setup

Now What?

Attachments