Configuring Eclipse for Developing Mulgara

Subversion contains a .classpath and .project file for use with Eclipse.

However, to completely build everything Eclipse expects to see some generated Java source files which are not available after a clean build. To address this issue, there is a target called ideSupport which builds a jar file called ideSupport.jar. This contains all the extra classes that Eclipse needs to get going.

To get going in Eclipse:

  1. Make sure you have Subclipse installed.
  2. Create a new project.
    1. File | New | Project...
    2. Open the SVN option in the Wizards, and select "Checkout Projects from SVN". Press Next.
    3. If you haven't checked out Mulgara before, select "Create a new repository location" and press Next. If you've checked out Mulgara in the past you can use the existing repository location, and skip the next step.
    4. In the Url field type: "https://mulgara.org/svn/mulgara". Press Next.
    5. Wait a moment while SVN retrieves the available projects:
      1. If you want the main project, select "trunk".
      2. If you want a previous release, select "tags", and then the release you are interested in.
      3. If you want a branch that someone is currently working on, then select "branches", and then the name of the branch you want.
    6. Press Next to go to the next screen. The wizard will pause while it gathers info on the project.
    7. Enter a Project Name appropriate to your use (e.g. "Mulgara-trunk"). Press Next.
    8. Pressing Finish at this point will use the default workspace location (usually desirable). You can select another if required. Note this directory for step "4" below.
    9. Be patient. Eclipse will take some time to check the project out.
  3. Start a command line tool. On Linux/Solaris/Mac OS X this will be a shell prompt. On Windows this is CMD.EXE.
  4. Change to Eclipse's default workspace directory. This was shown in step 8 of creating the new project.
  5. Change into the subdirectory you just created for the project.
  6. Build the ideSupport target with the provided script:
    On Linux/Solaris/OS X:
    ./build.sh ideSupport
    On Windows:
    build ideSupport
  7. Go back to Eclipse. Select the project and refresh with F5.