- Build GEP using Maven. See How to Build Geronimo Eclipse Plugin from Source for details. The projects are now ready to be imported into your Eclipse workspace.
- Launch a clean installation of Eclipse Ganymede (Seethis page for details).
- Follow these steps blow to complete the configuration of Eclipse for GEP development:
Setting up the ClassPath variable
- Select Window->Preferences as ahown in the figure.
- Select Java->Build Path->Classpath Variables. Select New.
- Enter the location of your m2repo. My m2repo is located at C:/m2repo. Select Ok.
- Once done you can see M2_REPO added to your list of ClassPath variables.
Setting up the target platform
A extract from Eclipse help about Target Platform "Target Platform refers to the platform against which you are developing and testing your plug-ins. The target platform encompasses the location of the target, the list of plug-ins constituting the target, the target environment and launching arguments."
Following steps need to be performed while configuring the target platform for GEP development.
- Select Window->Preferences.
- On the next screen select Plug-in Development->Target Platform. Browse to <Local_M2_Repo>/eclipse/eclipse. Select Apply.
- Select Ok. This will set up the target platform for our GEP development.
Importing source code in your Eclipse Workspace
Next step is to import the source code for plug-ins to your workspace. This is the code with which you will be playing all the time.
- Right Click under Project Explorer and Select Import->Import...
- On the next window select General->Existing Projects into Workspace. Select Next.
- On the import projects window Browse to <GEP_Source_Home>/trunk. Select Finish.
In case there are some errors try fixing those (consider it as your first step towards working with GEP! ) or else use the Geronimo mailing lists. See How to open a bug for Geronimo Eclipse Plugin for details.
Run and Debug Configurations
Before you can start running and debusing your code, set up your debug and run configurations.
- Select Run->Run Configurations.
- On the Run Configurations window Select Eclipse Application and Select New button on the top left.
- Name the new configuration as GEP_DEVELOPMENT. Also, change the workspace location name from runtime-New_location to runtime-GEP_Development. Select Apply.
- Next select the Arguments tab for your GEP_Development run configuration and set the VM arguments as follows
- Next select the tracing tab and select the top most 4 jars. See figure below. Select Apply and Run.
- This will launch a new Eclipse window which is nothing but Eclipse + <Your_Plugin_Code>. You can modify the code and each time you can launch your Eclipse Configuration to test the modifications in code.
- TO Debug the code change to Debug Perspective in eclipse and Select Run->Debug Configurations. Select Debug.