Building JMoney from Source

These instructions are out of date. They will be updated eventually.

This section is written for software developers who wish to build JMoney from source. If you are not a developer or you wish only to use a released version of JMoney then you should go back and follow the instructions under 'install'. If you wish to try out the plug-in support in JMoney then you must build from source because the plug-in version has not yet been released.

Requirements

  • The Java SDK. JMoney must be compiled using Java 1.4 (any sub-version should work). If you have Java 5.0 installed then you should change the Eclipse preferences, Java, Compiler, set the Compiler Compliance Level to 1.4 and check "Use Default Compliance Settings". Expect problems if using a Java SDK version prior to 1.4.
  • Version 3.1 of the Eclipse Rich Client Platform. The final release is recommended but 3.1M6 and later should work. (Multi-column support in the Tree control was added in 3.1M6 and is used by JMoney). Eclipse 3.1 can be downloaded from www.eclipse.org.

Setting Up

Download Eclipse 3.1 and unzip the contents.

Start Eclipse by running eclipse.exe (found in the eclipse directory in the directory to which you unzipped Eclipse). You will be asked for a workspace. Enter a name of a directory that you would like Eclipse to create, for example "c:\jmoney". Next you will see a big purple screen. Click on the 'go to the workbench' icon in the top right corner.

Now follow these steps to load the source code for the plug-ins.

  • File -> Import... -> 'Checkout Projects from CVS' -> Next
  • Enter
    • host: cvs.sf.net
    • Repository Path: /cvsroot/jmoney
    • User: Anonymous
  • Leave all other fields at their default values:
    • Leave the password blank
    • Use Default Port
  • Select "Use an existing module" and you should see a list of modules. All of the modules are garbage except "jmoney" (with a lower-case j). Expand that module, expand 'plugins' and select all the projects under plugins (use the shift key to select a range). Press 'Next'.
  • Select "Checkout into the Workspace as Projects" and press "Finish".

You should now be in the Java perspective and the Java files should compile. You will see a few warning icons which may be ignored. If any plug-ins have errors, close the offending plug-in by right clicking on the plug-in and select 'Close Project'.

  • From the menu select 'Run', 'Debug...', select 'Eclipse Application' and press the 'New' button.
  • On the 'Main' tab
    • Select the 'Run a Product' option and select 'net.sf.jmoney.product'. If this is not in the list then there is something wrong with the net.sf.jmoney plug-in and you will have to do some troubleshooting.
  • 'On the 'Plug-ins' tab
    • select 'Choose plug-ins and fragments to launch from the list'
    • press 'Deselect All'. Then select 'Workspace Plug-ins' (or select individual workspace plug-ins if you do not want to run all plug-ins). Then press 'Add Required Plug-ins' to add the plug-ins that are requirements of the selected plug-ins.
    Hit the debug button and the JMoney application should run.

Problems

The most serious of the known problems are as follows:

  • Jasper reports are not working. It appears that the results are produced but they do not display in the control.