LIME Graphical Editor Eclipse Plugin
On this page you might find information about how to use the plugin and how to make it work. You don't need to have any special background about plugins to use LIME Graphical Editor.
Installing LIME GE
To make the plugin work in your Eclipse environment, you should add at least the following jar files to 'plugin' folder of your eclipse
- GEF - Graphical Editor Framework by eclipse that you could learn how to install it from here and you can download it from here
- Draw2D - is the drawing framework used by GEF so you have to obtain it, also from here
- LIME - LIME Graphical Editor jar file that you can obtain the latest version from here
Then restart your Eclipse (There is also a way of not restarting Eclipse, but to be honest restarting is faster)
Now to create a new Diagram select New -> Example -> LIME. You can do the followings with the plugin
- Draw components (which are boxes in the diagram)
- Add port to components, both input and output
- Draw arcs from output ports to input ports
- Draw associations between ports of the same type (either input or ouput)
- Modify the settings of each element (components, ports and arcs)
- Layout the diagram automatically
- View an outline of the elements in the diagram
- Use bird view option
- Have multiple nested components
- Also you can use make (if you have Eclipse C/C++ and LIME [library package] installed) the project and run the results This wiki uses the Creole syntax, and is fully compatible with the 1.0 specification.
You can do a lot more with the graphical editor. You would learn by doing.
If you use Eclipse C/C++ and you use this plugin, then you can create a Makefile C project and add your LIME codes inside that. You can draw a new diagram and write code for that. You can use only a diagram and write code as code fragments which is visually visible and you can build the project directly. So my suggestion for you is to always use Eclipse C/C++ and linux for a reliable LIME experience.
Problems in Downloading the Plug-in
It has been observed that if you try saving the jar file from the web interface by using 'save link as' or 'save target as' then the file being downloaded is not the same as when you are cloning it. The worse is that if you put this corrupted jar file in your fresh Eclipse's Plug-in folder, then your eclipse would never recognized your LIME-eclipse-jar file anymore, even if you clone it correctly. It seems that the web interface of BitBucket is mainly aimed for pure text files. Therefore, to avoid any further problems, try cloning the project (or the newest jar file) and then put it as instructed above in the plug-in folder of your Eclipse installation.
The easier way is to use raw version of the file. If you go to sources and click on one of the jar files. Then you would see an option raw on top right part of the box. If you click on raw you get the correct file.
Problems with Jar File Update
- There is also a problem when you put the new jar file in Eclipse Plug-in folder. The problem is if you use an older version of nl.tudelft.lime and you manage to use the newer version, then you simply close Eclipse put the file in plugin folder and then restart eclipse but that doesn't work! My experience shows (There might be a better way) that you should close Eclipse remove the previous file, restart Eclipse that it understands that the plugin is removed (In Eclipse C you don't have an option to disable the plugin afaik). Then put the new jar file there and start Eclipse again.
Weird Excpetion in XML
- MalformedURLException - when the diagram is read from XML you might get this error, that is because of the wrong path to the dtd. Path to gxf.dtd is stored in system.properties file, and it is by default '/xmldtd/gxf.dtd'. You have to make sure that correct dtd is stored in the mentioned folder. You can also use path to the online dtd file which is http://bitbucket.org/pjotr/lime/src/tip/doc/gxf.dtd**, if you have access to internet