Running RinSim examples using Eclipse

Prerequisites:

• installed Eclipse 4.2 or later
• installed Maven plugin for Eclipse

Instructions:

1. Open Eclipse, choose File -> New -> Project...
   
   
   

2. Choose Maven Project and click Next >
   
   
   

3. Check Create a simple project (skip archetype selection) and click Next >
   
   

4. For Group Id: choose a unique personal identifier, often a reversed Internet domain name is used for this. For Artifact Id: choose an identifier for your project.
   Click Finish
   
   
   

5. In your Package Explorer you should see the following:
   
   Note that by default Maven uses (the ancient) Java 1.5. Since RinSim requires at least Java 1.7 we will change this in the next steps.

6. Open the pom.xml file with the Maven POM Editor. Choose the pom.xml tab in the bottom.
   
   

7. You will see an XML view of the file. Add (paste) the following XML code between the project tags. Make sure to not overwrite the existing XML tags.

    <dependencies>
        <dependency>
            <groupId>com.github.rinde</groupId>
            <artifactId>rinsim-example</artifactId>
            <version>x.y.z</version>
        </dependency>
    </dependencies>
   
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
            </plugin>
        </plugins>
    </build> 
   

8. Replace x.y.z with the current latest version (the latest version is shown here). The pom file should now look similar to this:
   
   
   Check that the JRE System Library as shown by Eclipse is version 1.7 (or higher), if this isn’t the case it often helps to force Maven to update the project: right click on your project -> Maven -> Update Project... If that doesn’t work it may be that Eclipse can’t find a correct Java version in which case you need to update your Eclipse settings.

9. Maven will now start downloading the dependencies. When it is done, make sure your can find the rinsim-example-x.y.z.jar in your Package Explorer:
   
   
   

10. Right click rinsim-example-x.y.z.jar -> Run As -> Java Application
    
    
    

11. You will see the following window, select SimpleExample and click Ok
    
    
    

12. You should now see the following window:
    

Congratulations, Your setup is complete, you can start working with RinSim! Click Control -> Play to start the simulation. For more information about the other available examples, click here.