Announcement: You can find the guides for Commerce 7.5 and later on the new Elastic Path Documentation site. The Developer Center continues to support Commerce 6.13.0 through 7.4.1.Visit new site

2. Configuring Eclipse RCP 4.5.1 Mars

2. Configuring Eclipse RCP 4.5.1 Mars

Creating your Elastic Path Eclipse Workspace

When you start Eclipse, you will always be prompted to select a workspace. We recommend you create a new workspace (For example, C:\ElasticPath\workspace) to hold all your Elastic Path projects and Eclipse settings when starting development for the first time.

Installing Eclipse Plugins

You must install all the plugins in the order shown below.

Order Plugin Version Update Site

1

BIRT (Business Intelligence, Reporting and Charting)

Latest

http://download.eclipse.org/releases/kepler/

2

Elastic Path Supported Eclipse Plugins

Latest

http://repo.elasticpath.com/eclipse/6.15.0/update-site/

To install a plugin:

  1. Start Eclipse.
  2. In Eclipse, choose Help -> Install New Software.
  3. In the Work with box, enter the plugin's Update Site URL.
  4. Select the plugin's check box and all the plugin dependencies and click Next.
  5. Click Next.
  6. Accept the license agreement, if required, and click Finish.

For more information on the plugins, see Eclipse Plugin Notes.

Setting up your Eclipse Environment

  1. Download the following files (Right-click and select Save Link As...)
  2. In Eclipse, choose Window -> Preferences -> Java -> Code Style -> Code Templates and import ElasticPathCodeTemplates.xml.
  3. Choose Window -> Preferences -> Java -> Code Style -> Formatter and import ElasticPathFormatter.xml.
  4. Choose Window -> Preferences -> Java -> Installed JREs.
  5. Select your JRE and click Edit.
  6. Set the Default VM Arguments to:
    -Xms256m -Xmx1024m -Dsun.lang.ClassLoader.allowArraySyntax=true -XX:CompileCommand=exclude,org/apache/velocity/runtime/directive/Foreach,render
    
  7. Click Finish.
  8. Choose Window -> Preferences -> Maven and make sure Hide folders of physically nested modules (experimental) is selected.
  9. Click OK to complete the changes.
Note:

To improve performance, you can disable any unnecessary validation performed by Eclipse. The only Eclipse validator Elastic Path requires is the Class Dependency Validator.

To disable any unnecessary validation:

  1. In Eclipse, choose Window -> Preferences -> Validation
  2. Click Disable All
  3. In the Validator list, select both checkboxes beside Classpath Dependency Validator and click Apply.

    EclipseValidation.PNG