Features

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.

eclipse plugin features

 

​Install Instructions

  1. Download and install Eclipse(4.2 or later) and Understand (build 760 or later).
  2. Understand needs to be on the system PATH for the plugin to work. (e.g. C:\Program Files\Scitools\bin\pc-win64 needs to be on the PATH)
  3. In eclipse select, Help->Install New Software
  4. In the “Work with:” area, click Add to get this dialog:
    addrepo
  5. Set the Name to “Understand” and the location to “http://eclipse.scitools.com/eclipse_plugin/”
  6. Click OK and you should see something like this:
    EclipsePluginInstall
  7. 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.
  8. 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.
    understand_menu

 

Managing Projects

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.

project_menu

Notes:

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.

 

Troubleshooting

The Understand top-level menu appears, but nothing appears in the recents menu. The whole plugin seems dysfunctional.

The plugin relies on native libraries installed as part of your Understand installation. Make sure Understand is on the system PATH. (e.g. C:\Program Files\Scitools\bin\pc-win64 needs to be on the PATH).

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.0 requires an Understand installation 760 or newer, and earlier eclipse plugins require an Understand installation older than 760. 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.

Manual Installation

If you can’t use the update site, here are the steps to manually install the plugin

  1. Download and install Eclipse(4.2 or later) and Understand (build 760 or later).
  2. Understand needs to be on the system PATH for the plugin to work. (e.g. C:\Program Files\Scitools\bin\pc-win64 needs to be on the PATH).
  3. Copy the .jar files from scitools\bin\pc-win64\Java to your Eclipse\dropins folder.
  4. 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.
  5. Restart eclipse.