Steps to build rapla 1.* in Eclipse (3.3 or higher recommended)

1a) Creating a new Project from SVN

  1. Download install a SVN Plugin for eclipse (subversive or subclipse)
  2. click on the "SVN Repository Exploring Perspective" Icon in the left sidebar.
  3. right click in the "perspective" and choose new/repository location
    host: rapla.svn.sourceforge.net
    repository path: /svnroot/rapla
    for readonly-access use
    user: anonymous
    for rapla-developers use
    your sourceforge-login
  4. open repository and right-click on trunk
  5. select "checkout"
  6. click finish, wait for cvs and continue with 2.

1b) Creating a new Project from the src-distribution

  1. Unzip the source-distribution to a temporary folder
  2. Select File/Import/Existing Projects into Workspace
  3. choose the rapla-source-* folder
  4. Click finish
  5. Click finish, wait for the import and continue with 2.

2) Running/Debugging/Testing Rapla directly in eclipse

  1. You can run/debug Rapla with the run button: select java-application and select the main-class org.rapla.Main.
  2. You can test Rapla by selecting junit and a test from the test-src directory.

3) Running/Debugging the server

  1. Unfold the jetty.jar (in the subfolder Referenced Libraries) until you find the class org.mortbay.xml.XmlConfiguration or org.mortbay.jetty.Server in older Rapla Installations.
  2. Right click and choose run as and then run configurations
  3. Click on the new icon
  4. now click on the arguments page and enter jetty/jetty.xml
  5. Choose run or debug to start the server.
  6. Browse to http://localhost:8051 to check if the server is running
  7. The applet and webstart doesnt work here (you need to perform 5 to build a webapp)
  8. If you want to test the client start a second procces org.rapla.Main but choose run as and set client as argument
  9. You can stop the server by switching to the debug perspective and terminating the process (server and client)
  10. For debugging choose debug as instead of run as

4) Building Rapla Version

  1. Switch to the Java Perspective, right click on the build.xml and select Run As/Ant Build (The second one)
  2. Click on the Refresh-Tab and select Refresh resource upon completion and the project containing the selected resource
  3. Click on JRE-Tab and choose run in same JRE as Workspace
  4. Now you can press Run to start the build. You find the version in the dist/rapla-binary-{version} folder.
  5. Eclipse will create a shortcut to the build process in the toolbar (The green arrow with toolbox). So you can just click Rapla build.xml to start the build a second time.
  6. See [Build Guide] for more information regarding the build process

5) When you change a resource file or a plugin

  1. You need to run ant to generate the new resource files or plugin-list in the generated-src folder
  2. you need the target build or you can run the same build as above dist-webapp or dist-bin, because both include build

6) Problems

  1. On some installations eclipse complaints about javax.net.ssl.*.
    Dowload jsse.jar and jnet.jar from sun and put them in the lib directory and select them too.