The following instructions will enable you to get Geronimo into the Eclipse workspace as an eclipse project. For purposes of this discussion the development OS is Windows. Please adjust these instructions for your environment.

Creating Eclipse Projects

You could import all the geronimo projects or subprojects in the workspace. But a more efficient way is to import only the modules that you want to work on.

Working with multiple modules

You are advised to import all the modules the first time you work with Geronimo builds in Eclipse.

Generate the Eclipse projects for geronimo sub-projects by invoking the following command from Geronimo top directory:

mvn -o eclipse:eclipse

Note:

The very first time you must omit the "-o" parameter so that it will download the maven-eclipse-plugin.

mvn eclipse:eclipse

It is possible to import only a few modules in the workspace by running the above command from each of the modules directory. In this case the changes made in one module will not be visible to other modules without rebuilding the modified module with mvn.

Useful Information

It is possible edit .classpath files so that the changes made in one module are visible to all other modules in the workspace instantly. This is meant only for advanced users.

Working with a single module

If you are planning to modify a single geronimo module, you can import only that module in the workspace by running the following commands:

Building Geronimo source code in Eclipse

You can build each Geronimo module by right clicking on the project, and selecting mvn options.

Info:

If you plan on contributing code or patches to the project, you have to configure eclipse to not use tabs. Select Window > Preferences > Java > Code Style > Formatter > Java Conventions [built-in], and click on Edit. Under Indentation select Tab policy as "space only". Enter a new name for this profile and click OK.

You might want to configure the Geronimo development environment by importing the Geronimo formatter and code template files.