You can now access many of Understand’s most popular features from within Eclipse. Including the Entity Filter, Information Browser, Metrics, Treemaps, Butterfly graphs and Control Flow Graphs. The entity graphs also have interactive elements so you can quickly jump to the appropriate entity when navigating them.
These features can be reached either through the top level Understand menu, or by right clicking on an entity.
- Download and install Eclipse(4.2 or later) and Understand (build 760 or later).
- Add the Understand directory to your PATH
- Windows: PATH=$PATH;C:\Program Files\Scitools\bin\pc-win64
- Linux: export PATH=$PATH:[INSTALLDIR]/Scitools/bin/linux64
- Mac: export PATH=$PATH:/Applications/Understand.app/Contents/MacOS
- In eclipse select, Help->Install New Software
- In the “Work with:” area, click Add to get this dialog:
- Set the Name to “Understand” and the location to “http://eclipse.scitools.com/eclipse_plugin/”
- Click OK and you should see something like this:
- Make sure the “Contact all update sites during install to find required software” box is checked so that eclipse can download all the needed dependencies. Then click Next and accept the defaults for the rest of the dialog.
- You should now see an Understand top level menu in Eclipse. From that menu, if you go to the “recent” submenu, it should show the same recent project list that understand does. If this does not show up, it means that something went wrong, check the Troubleshooting section below.
When you can right click on an Eclipse project there are two options available: Create Understand Project and Open Associated Project. Create Project creates an Understand project with the files from the selected Eclipse project, however the project will need to be configured in the Understand GUI before it is fully functional. Create Project also associates the new database with the eclipse project as a property (changeable from the Understand page of the properties dialog for the project) and Open Associated Database will open that database if it is set in this manner.
Metric Table: (Columns can be hidden via the right click menu on the header, and sorted by single click)
The context menu for an entity should appear for all entities in the understand views, and also if you have the word highlighted in the editor (cursor inside the word is not enough, the word must be selected). The context menu has the options for the two graphs (control flow and butterfly) if they are applicable, view information, and edit definition. Edit definition will only be enabled for resolved entities.
The Understand top-level menu appears, but nothing appears in the recent menu. The whole plugin seems dysfunctional.
The plugin relies on native libraries installed as part of your Understand installation. Make sure that the PATH and CLASSPATH environment variables are set as described above.
Also, make sure your Understand version and Eclipse version are both 64 bit or both 32 bit. Eclipse 32 bit can’t load an Understand 64 bit native library.
Finally, the eclipse plugin version 1.1.4 requires an Understand installation 977 or newer. Make sure your plugin version and build match.
If none of these work, you can try checking the eclipse error log for the error that was thrown when the native library failed to load. If the error is thrown from System.loadLibrary, then eclipse didn’t find your understand installation on the path.
If you can’t use the update site, here are the steps to manually install the plugin
- Download and install Eclipse(4.2 or later) and Understand (build 977 or later).
- Understand needs to be on the system PATH for the plugin to work.
- Copy the .jar files from scitools\bin\pc-win64\Java to your Eclipse\dropins folder.
- Download the 3rd party draw2D plugin and copy its .jar file to the Eclipse\dropins folder. The download section can be confusing so here is a direct download link to the version we tested with.
- Restart eclipse.