Installing mascopt in Eclipse

We discuss hear about the way to use mascopt in Eclipse. Eclipse is an IDE which helps to develop java (and other) projects. This section provides the main operation to install mascopt in Eclipse.

Retrieve the full version of Eclipse, including the java and cvs tools. You can find eclipse at here. Be sure to take the full tar.gz, for SDK. At the time of writting this page it is eclipse-SDK-3.1M3-linux-gtk.zip.

Unzip eclipse somewhere. Then, you have to run it:

cd eclipse
./eclipse

You may have to set the environnement variable "JAVA_HOME". Note also that eclipse needs a recent version of Java.

Now, we provides some screenshots to help you to install mascopt cleanly in mascopt.

1. First, click on Workbench:
   
2. Select New Project:
   
3. Select CVS. We are getting MascoptDev from the CVS repository:
   
4. Enter the CVS parameters. We use the ssh protocl to access to CVS:
   
5. Select the project you want to get that is in our case "mascoptDev":
   
6. Keep the first choice (use the wizard):
   
7. You may change your workspace location (where mascoptDev is put and used by eclipse):
   
8. Here you can select a branch. Select nothing (it means by default, the HEAD):
   
9. Select the Java project Wizard:
   
10. Put the name of the project managed by eclipse (for example "mascoptDev"):
    
11. Eclipse automatically propose to search sources in the tree directory. We propose to specify it later. Remove the entry you see in the tab "Sources":
    
12. You obtain this:
    
13. At this point, click on "Finish". Eclipse will download mascoptDev via CVS:
    
14. Then, you can browse the files. Now, you can go to the next section to learn how to configure Eclipse to be able to compile mascoptDev:
    

Now, we provides some screenshots to help you to configure mascopt cleanly in mascopt. It allows to compile mascoptDev using ant. If ant is not installed, please install it before processing.

1. Right click on "mascoptDev" to access the properties and click on "Properties" :
   
2. You get this. If the sections concerning Java are not here, your eclipse installation is not complete. You should download an other ecplise distribution containing the java tools:
   
3. Go to the "Builders" section. Disable the Java Builder. Then, create one builder clicking "New":
   
4. Select ant here:
   
5. Put a new name to your builder, like "ant builder". Then click on "Browse Workspace":
   
6. You can find here the rules to build mascoptDev. These rules are in the file "build.xml". Select it and validate:
   
7. You want to refresh when programming. Enable the "Refresh ressources upon completions" in the tab "Refresh".:
   
8. Your builder is configured. Now validate this view clicking "Ok":
   
9. Now, switch to "Java Build Path" from this view:
   
10. We will specify where are the sources. Remove any entry here. Then, click "Add Folder":
    
11. Select the three following folders: samples, src, and tests:
    
12. Now, you must specify the output folder. At the bottom click on "Browse":
    
13. In the popup, specify "classes". The directory may not exist; it will be automatically created:
    
14. Switch to the Libraries tab. Here you have to add extra ressources to be able to compile mascoptDev. Click on "Add Jars":
    
15. Select these jars and validate:
    
16. Now you have the needed external libraries. If you have cplex solver click on "add external jars":
    
17. If cplex is installed somewhere, find it and select cplex.jar:
    
18. If this occurs, apply:
    
19. Then click on "ok" to finish the configuration. Eclipse will build the project. If an error occurs when compiling, you may returns to the configuration of sources and jars :
    

You are now ready to use Eclipse !

If you want to autobuild the project each time a file ressource is updated and saved, go to: Project Properties, Builders, your ant builder, then the tab build options and enable "During Auto Builds". Then close the Builder and in the menu "Project" enable "Build Automatically".