Developing with Eclipse and Maven

2.3. Installing m2eclipse in Eclipse 3.5 (Gallileo)

2.3. Installing m2eclipse in Eclipse 3.5 (Gallileo)

2.3.1. Installing m2eclipse Core Components

To install m2eclipse, use the following Eclipse update site to install the core of the m2eclipse plugin. This Core update site contains a single component: "Maven Integration for Eclipse (Required)". When you install this component you will be installing all of the core Wizards, the POM Editor, Maven Repository integration, and Maven integration:

To install this plugin in the Eclipse IDE:

  1. Select Help > Install New Software. This should display the "Install" dialog.

  2. Paste the Update Site URL into the field named "Work with:" and press Enter. Pressing Enter should cause Eclipse to update list of available plugins and components.

  3. Choose the component listed under m2eclipse: "Maven Integration for Eclipse (Required)".

  4. Click Next. Eclipse will then check to see if there are any issues which would prevent a successful installation.

  5. Click Next and agree to the terms of the Eclipse Public License v1.0.

  6. Click Finish to begin the installation process.

Eclipse will then download and install the necessary components. Once the installation process is finished, Eclipse will ask you if you want to restart the IDE. Sonatype strongly recommends that you restart your IDE after installing m2eclipse.

Warning

You cannot upgrade from m2eclipse 0.9 to m2eclipse 0.10. If you are running m2eclipse 0.9.8 or 0.9.9 you must either uninstall m2eclipse from your Eclipse installation or start with a fresh installation of Eclipse.

If you've installed the plugin successfully, you should see a Maven option in the list of preference categories when you go to Window, Preferences....

2.3.2. Installing m2eclipse Extras

In addition to the core m2eclipse components, the following optional components are available from a separate update site. If you plan to use m2eclipse to materialize projects from Subversion or CVS, integrate Maven with the Eclipse Web Tools Project (WTP), or use the m2eclipse Mylyn integration you will need to install the following, extra components:

  • Maven SCM Integration

  • Maven SCM handler for Team/CVS

  • Maven SCM handler for Subclipse

  • Maven issue tracking configurator for Mylyn 3.x

  • Maven Integration for WTP

  • M2Eclipse Extensions Development Support

To install optional m2eclipse components, use the m2eclipse Extras update site. This update site contains the following m2eclipse components:

2.3.3. Installing Optional Prerequisites

Several of the extra components listed in the previous section require third-party plugins to be installed prior to installation. You can install these prerequisites when you install m2eclipse, just add a new remote update site to Eclipse for each of the prerequisite components.

To install these prerequisites, select Help, Install New Software... which will load the "Software Updates and Add-ons" dialog. In this dialog, choose the Available Software panel and click on Add Site... which will load the simple "Add Site" dialog. Enter the URL of the update site you wish to add and click OK. In the "Software Updates and Add-ons" dialog, the available plugins from an update site will appear as soon as the site is added. You can then select the modules you want to install and click the Install... button. Eclipse will then resolve all the dependencies for the selected plugins, and ask you to agree to the plugin license. After Eclipse installs new plugins, you should restart the IDE.

2.3.3.1. Installing Subclipse

When you install Subclipse, you will need to make a decision about Subversion compatibility. If you are using Subversion 1.5.x client features, you will need to install Subclipse version 1.4. If you are using Subversion 1.6.x client features, you will need to install Subclipse version 1.6.

To install Subclipse, use one of the Eclipse plugin update sites listed below.

For other versions of Subclipse, and for more information about the Subclipse plugin, please see the Subclipse project's web site at http://subclipse.tigris.org/.

2.3.3.2. Installing Mylyn

To install JIRA or Trac integration with Mylyn, add the Mylyn extras Eclipse update URL, you'll want to do this if your organization uses Atlassian's JIRA for issue tracking. To install Mylyn use the following update sites:

For more information about the Mylyn project, see the Mylyn project's web site at http://www.eclipse.org/mylyn/.

2.3.3.3. Installing the Web Tools Platform (WTP)

To install the Web Tools Platform (WTP). Install the "Eclipse IDE for Java EE Developers" from http://www.eclipse.org/downloads/, or download a WTP release from http://download.eclipse.org/webtools/downloads/.

For more information about the Web Tools Platform, see the Web Tools Platform project's web site at http://www.eclipse.org/webtools/.