Configuring Eclipse

Importing your JHipster application in Eclipse will require a few manual steps. You will need to do some configuration:

on the Maven side (for Maven users)
on the JavaScript side (so Eclipse can ignore a couple of folders for static files)

1. Import your project as a Maven project

Select File -> Import
Choose “Existing Maven Projects”
Select your project
Click on “Finish”

Import

Select

At the end of the import phase, you can expect to see the below dialog. “Maven plugin connectors” are an extension for m2eclipse. That one should be installed and Eclipse will need to restart after completion.

If you have installed it already, you will be good to go and do not need to do anything.

Select

Note: if you already have an existing JHipster project and have not installed the corresponding connector, you should see the below error:

Plugin execution not covered by lifecycle configuration: org.bsc.maven:maven-processor-plugin:2.2.4:process (execution: process, phase: generate-sources)

Just select Quick Fix/Ctrl+1 (Cmd+1 on Mac) on the error marker and select “Discover new m2e connectors”

2. Excluding generated static folders

At this stage you should not have any Java error but should still see some JavaScript errors. This is because you have some JavaScript files that Eclipse cannot parse properly. Those files are used at execution time only and do not need to be visible in your workspace. They should be excluded.

Exclude the ‘node_modules’ folder

Right-click on Project -> Properties -> Resource -> Resource Filters
Select: Exclude all, Applies to folders, Name matches node_modules
Press “Ok”

Right-click

Exclude

Exclude ‘app’ from src/main/webapp

Right click on Project -> Properties -> Javascript -> Include path
Click on the “source” tab and select your_project/src/main/webapp
Select “Excluded: (None) -> Edit -> Add multiple
Select app and click “Ok”
The following folders should have been automatically excluded (if not, exclude them manually):
- bower_components
- node_modules/

Right-click

Exclude

Multiple select

Maven IDE profile

If you are using Maven, you need to activate the IDE profile in Eclipse. This is used for applying IDE-specific tweaks, which currently only includes applying the MapStruct annotation processor.

Right click on Project -> Properties -> Maven
In “Active Maven Profiles”, type dev,IDE

With this configuration, you will be using both the JHipster dev and IDE profiles.