COMP 310

Eclipse and Eclipse Plug-in Installations
    Current Home  Java Resources  Eclipse Resources

IMPORTANT:  Install ONLY the plug-ins that are required!

Not all plug-ins work with the current Eclipse and Java versions and installing them can cause installation and operational problems for other plug-ins.    See the instructions in your class year's instructions as to which plug-ins are required.

Quick Links to Install Instructions

 

Most people will NOT need to do the following:

 

In general, the best way to install plug-ins is to use the Eclipse Marketplace:

  1. From the main Eclipse menu, go to Help/Eclipse Marketplace...
  2. Search for the desired plugin and click the "Install" button.

 

Install the latest Java JDK

Please see the Comp310 Java Resources page.

 

Install Eclipse

8/15/16: Existing Eclipse users:  Upgrading from earlier Eclipse versions, e.g. "Mars" to the current latest version, "Neon" is NOT supported.   Recommendation:  Rename your current Eclipse installation directory so as not to lose anything, then do a fresh installation of Neon.   Get Neon working as you want and then delete the old version if desired.

If you are running a 32-bit operating system, please contact the staff immediately BEFORE installing anything!    (Recommendation: upgrade to a 64-bit operation system as a 32-bit system will only cause one problem after another.)

  1. Go to http://eclipse.org  and click the link for "Download"
  2. Download the installer for the latest version of Eclipse and run it.
  3. When the Eclipse installer asks, the version you want is called "Eclipse IDE for Java Developers", not Eclipse IDE for Java EE Developers.
  4. The installation instructions willv vary depending on the computer's operating system so just follow the on-screen directions.

Notes:

Note:  Particularly if you have upgraded Eclipse from an earlier version, e.g. Kepler to Luna, you may need to increase the amount of memory allocated to Eclipse in order to gid rid of "Out of Memory" or "GC Overhead Limit Exceeded" errors.    If you are encounter these errors, please see these directions.

Keep Eclipse Updated!   -- Periodically, run Help/Check For Updates from the Eclipse main menu.   

Windows users:  You may need to run Eclipse "as administrator" in order to perform updates (except Subclipse -- see below), depending on how Eclipse was installed.

 

Forcing Eclipse to Use a Specific JVM

Sometimes between the operating system and Eclipse, signals get crossed and Eclipse uses the wrong JVM (Java Virtual Machine, aka Java Run-time Engine/JRE) when it runs.   This can cause a multitude of confusing problems such as the inability to run some plug-ins (e.g. "incorrect version number in plug-in class file" error).   Here are some directions on how to manually configure Eclipse's initialization file to force it to use the proper JVM: http://wiki.eclipse.org/Eclipse.ini   

Updating Eclipse

One should regularly update Eclipse to make sure that you have the latest versions for Eclipse and all the plugins.

To manage update sites:

If you followed the directions below to install your plugins, the update sites should already be in Eclipse.   To add new update sites or to check that you have the ones for the installed plugins,

  1. In Eclipse, go to Windows/Preferences
  2. Expand the Install/Update node and select "Available Software Sites"
  3. You can add, remove, enable/disable and edit update sites here.

To manually perform an update:

  1. Go to Help/Check for Updates
  2. Eclipse will run through all its update sites looking for updates

To perform a major release update on Eclipse:

Eclipse will NOT automatically update itself from one major release to the next, e.g. from "Kepler" to "Luna".  

You need to explicitly add the update site for the new release (see above), whose name depends on the release, but is typically something on the order of

http://download.eclipse.org/releases/[release name]/
e.g.  http://download.eclipse.org/releases/kepler/

Once you add the update site for the new release, you can manually run the update as described above.  On Windows machines, updating Eclipse itself will probably require running Eclipse as an administrator (symptom: You get are unable to select the update due to "insufficient access privileges" or the like.)

For more information, see the documentation: FAQ How do I upgrade Eclipse?

 

 

Install Eclipse Plug-ins

Window Users: Note that updates to Eclipse itself may require that Eclipse be "run as administrator".   Note that when Eclipse restarts after an installation, it is still running as as administrator.   To return to normal operation, exit Eclipse completely and then run it again as normal.

 

"UML Lab" Diagramming Tool

UML Lab Home page: http://www.uml-lab.com/en/uml-lab/

UML Lab is a commercial UML diagramming tool for Eclipse that supports round-trip engineering, i.e. creating diagrams from code and creating code from diagrams.

Rice owns a license key for the full UML Lab functionality.    The course staff will tell you how to obtain this key.  The only restriction for the key is that it must be installed while on-campus and one must periodically (~ every 2 weeks) bring UML Lab up while on campus so it can renew its license.

A free but reduced functionality "Student Version" is available via their academic program: http://www.uml-lab.com/en/uml-lab/academic/.   This version is has no limitations with regards to being on-campus.

Installation:

  1. Have your license key in hand before you start the install!
  2. From Marketplace (recommended):
    1. In Eclipse, go to Help/Eclipse Marketplace...
    2. Search for "UML Lab"
    3. Select and install "UML Lab Modeling IDE" (not the "Class Diagram Editor"!)
  3. Manually (only if necessary):
    1. In Eclipse, go to Help/Install New Software
    2. In the "Work with" text field, type "http://update.uml-lab.com".   Click "Add".   (Note: this process sometimes takes a long time.   If it does, try cancelling the operation and trying again, as this seems to speed it up.)
    3. The "Add Site" dialog will ask you for a name.   Type in something useful, such as "UML Lab".  Click "Ok".
  4. In the main box in the center of the "Install" dialog, check off only the box labelled "UML Lab". 
  5. Check off any license agreements and click "Finish".
  6. Restart Eclipse.
  7. The first time you use UML Lab, you will be asked to input the license key.
  8. BEFORE YOU DO ANYTHING IN UML LAB, BE SURE TO SET THE PREFERENCES CORRECTLY!

UML Lab runs slightly differently than the other UML diagramming tools.   Be sure to check out the Using UML Lab page.

UML Lab Floating License Notes:

 

Subclipse Subversion Source Control

Subclipse Home page:  https://github.com/subclipse/subclipse/wiki

Subclipse provides Subversion source control capabilitiees for Eclipse to enable multi-developer access to a common, versioned source code repository.  It is also used as the assignment turn-in mechanism in the course.

Subversion home page: http://subversion.apache.org/

Installation:

Windows Users:  Do not use "Run as administrator" to install Subclipse (see below)

  1. Go to the Subclipse home page and check what the latest version of the plug is.   Be sure to install the latest version for your system.
  2. From Marketplace (recommended):
    1. In Eclipse, go to Help/Eclipse Marketplace...
    2. Search for "Subclipse"
    3. Select and install "Subclipse"
  3. Manually (only if necessary):
    1. In Eclipse, go to Help/Install New Software
    2. In the "Work with" text field, type the URL for the latest version and then click "Add":
      • As of 01/09/2017, the latest version is https://dl.bintray.com/subclipse/releases/subclipse/latest/  
    3. The "Add Site" dialog will ask you for a name.   Type in something useful, such as "Subclipse".  Click "Ok".
  4. In the main box in the center of the "Install" dialog, check off
  5. Click "Next".
  6. The next screen is a review of what is going to be installed.  Click on "Next".
  7. Accept the license agreement on the next screen and then click on  "Finish".
  8. Disregard any warnings about installing unsigned software and allow the software to install.
  9. Restart Eclipse when the installation is finished.

 

NOTE: As of 1/7/18, almost all Mac and Linux installations have required the use of the SVNKit to operate properly. In addition, a number of Windows machines have also needed it. If you are having problems with the JavaHL driver not being recognized, please follow the directions below to switch to the SVNKit driver.

Linux and Mac Issues:

Linux and Macs have some known problems with recognizing and/or interoperating with the JavaHL component of Subclipse.  JavaHL is a system-dependent Subversion client that either comes with Subclipse (usually only for Windows installations) or is already installed in the operationg system (typical of Macs and Linux).    This is often caused by the latest stable SVN client version for that OS platform being incompatible with the latest Subclipse version. 

The first thing to try if the above installation does not work, is the following work-around, which uses a pure-Java SVN client called "SVNKit":

Windows Issues:

If Subclipse was installed using "Run as administrator", the SVN operations may not be possible because no SVN client is available.   See Preferences/Team/SVN to see what the "default SVN client" is set to and what options are available.   The correct client for Windows is the JavaHL client.

The problem does not seem to appear if Subclipse is installed without "Run as administrator".

To fix the problem, uninstall all of Subclipse(see below) and reinstall it.

 

Uninstalling Subclipse:

Sometimes, you need to completely uninstall Subclipse and start over.  To uninstall Subclipse, go  to Help/Installation Details.  

There are many pieces to Subclipse, which need to be uninstalled one by one, though you do not need to restart Eclipse between each uninstall, only after the last one.  Uninstall the following, the details of which will depend on what you initially installed:

Once everything is uninstalled, restart Eclipse (not as administrator) and reinstall Subclipse.

 

 

If you are still having trouble even after configuring to use the SVNKit, contact a staff member immediately.   Do NOT proceed further unless cleared by a staff person!  

If no SVNKit is available, try the following solutions:  

Mac OS X

If neither the regular installation above nor the SVNKit installation above works, you can try the following as a last resort:

Information about JavaHL on Mac OS X: https://github.com/subclipse/subclipse/wiki/JavaHL-on-OSX

Linux

Information on JavaHL on Linux:  https://github.com/subclipse/subclipse/wiki/JavaHL-on-Linux

How to Use Subclipse

 

THE FOLLOWING PLUGINS DO NOT TYPICALLY NEED TO BE INSTALLED BY MOST USERS:  


Eclipse WindowBuilder

Eclipse Oxygen however does NOT appear to be bundled with WindowBuilder, so it will need to be explicitly installed for that version. WindowBuilder is included in the "Indigo" and later (e.g. "Neon") releases of Eclipse -- no installation needed if you use this latest release.

WindowsBuilder is not included in the Java EE version of Eclipse, so if you must use the EE version (NOT recommended!) then you must manually install WindowBuilder.

WindowBuilder home page: http://www.eclipse.org/windowbuilder/

WindowBuilder is a (free!) What-You-See-Is-What-You-Get ("WYSIWG") editor for creating graphical user interfaces ("GUI"'s) in Java.   The use of a an automated GUI builder such as WindowBuilder greatly simplifies and speeds up the development of GUI-based applications.

http://www.eclipse.org/windowbuilder/download.php

Installation (for previous versions of Eclipse):

  1. From Marketplace (recommended):
    1. In Eclipse, go to Help/Eclipse Marketplace...
    2. Search for "WindowBuilder"
    3. Select and install "WindowBuilder"
  2. Manually (only if necessary):
    1. In Eclipse, go to Help/Install New Software
    2. In the "Work with" text field, type in one of the following links that corresponds to your version of Eclipse.   Click "Add".
    3. The "Add Site" dialog will ask you for a name.   Type in something useful, such as "WindowBuilder".  Click "Ok".
  3. In the main box in the center of the "Install" dialog, check off at least the following components:
  4. Check off any license agreements and click "Finish".
  5. Restart Eclipse.

How to Use WindowBuilder

 

None of the following plugins are needed by COMP 310 or COMP 504, though they may be needed for other classes:

 

Eclipse Web Tools Platform ("WTP")

This plugin is useful for those who wish to do web development using Eclipse.   In particular, one of the few free WYSIWYG ("What You See Is What You Get") HTML editors is available here.

WTP Home Page:  http://www.eclipse.org/webtools/

Update site:  http://download.eclipse.org/webtools/repository/[eclipse_version]/   e.g. http://download.eclipse.org/webtools/repository/neon/

To get just the "Web Page Editor":

  1. Add the appropriate site above to Eclipse's "Available Software Sites" and open the update site in the "Install New Software" dialog in Eclipse.
  2. Expand the "Web Tools Platform" item
  3. Select "JSF Tools - Web Page Editor"
  4. Finish the installation of the plugin.

 

Google Plugin for Eclipse (Google App Engine)

This plugin is only needed if you are doing Google App Engine development in Eclipse, particularly in Java.    This tool includes the Google App Engine SDK and local emulator plus deployment tools.

 Note that as of 8/15/16, the Google Plugin above only supports Java development for Google App Engine, not Python, Php or Go.   To develop in these languages, you need install the stand-alone SDKs for those languages.

Google Plugin for Eclipse home page: https://developers.google.com/eclipse/

Update site:  https://dl.google.com/eclipse/plugin/[version] e.g. https://dl.google.com/eclipse/plugin/4.6  (check for the latest version in the home page first)

 

PyDev

This plugin is used for Python development in Eclipse. 

PyDev home page: http://pydev.org

Update site: http://pydev.org/updates/

 

 

 

 

© 2017 by Stephen Wong