The Eclipse IDE (Integrated Development Environment) provides a platform for developing Java applications. Eclipse Helios is recommended. Instructions on retrieving the Magnolia CMS source code with Eclipse can be found here. Note that it is possible to use other Java IDEs such as IntelliJ IDEA.

• Installing Eclipse
• Plug-ins
• Troubleshooting
• JRE or JDK not found
• Resources

Installing Eclipse

To install Eclipse:

1. Go to Eclipse IDE for Java EE Developers Helios and download a 32-bit version. 64-bit software has installation issues.
2. Extract the ZIP file on your computer. This procedure assumes the file is extracted to C:\Program Files\Eclipse.
3. Double-click the Eclipse application executable. Tip: Create a shortcut to the application.
   
   
4. Select a workspace directory to store your projects.
   
   
5. Click OK.

Plug-ins

You need the Egit plugin to get Magnolia CMS source code in Eclipse. See the instructions on our wiki.

If you are using an older version of eclipse, you may require the following:

• Maven integration plugin is used to execute a Maven build.
• WTP integration plugin is used to detect Maven.

Troubleshooting

JRE or JDK not found

If either of the following errors occur, you need to modify eclipse.ini in the Eclipse directory.

"A Java Runtime Environment (JRE) or Java Development Kit (JDK) must be available in order to run Eclipse. No Java virtual machine was found after searching the following locations."

"The Maven Integration requires that Eclipse be running in a JDK, because a number of Maven core plugins are using JARs from the JDK."

To modify eclipse.ini:

1. Open eclipse.ini in a text editor.
   
   
2. Add the following line where JDKlocation is the location of javaw.exe in the JDK:
   -vm JDKlocation
   
   
3. Save the file.

Resources

• Getting Started with Eclipse
• Eclipse Helios Documentation