BuildingRaplaWithEclipse

Steps to build rapla in Eclipse (4.2 or higher recommended)

This build instructions refer to the latest version of rapla 1.8.x

1 Creating a new Project from git

1. right click in the "perspective" and choose new/repository location url:
   https://github.com/rapla/rapla

1. open repository and right-click on trunk
   
2. select "checkout"
   
3. click finish, wait for svn 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.bootstrap.RaplaStandaloneLoader.
   
2. You can test Rapla by selecting junit and a test from the test-src directory.

3) Running/Debugging the server

1. select org.rapla.bootstrap.RaplaServerLoader
2. Right click and choose run as and then run configurations
3. Click on the new icon
   
4. Choose run or debug to start the server.
   
5. Browse to http://localhost:8051 to check if the server is running
   
6. The applet and webstart doesnt work here (you need to perform 4 to build a binary-distribution)
   
7. If you want to test the client start a second procces org.rapla.bootstrap.RaplaClientLoader
8. You can stop the server by switching to the debug perspective and terminating the process (server and client)
   
9. 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 BuildGuide for more information regarding the build process
   
7. Build a distribution so so you can test the applet and webstart mode.