Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 60 Next »

The Groovy Eclipse Plugin allows you to edit, compile and run groovy scripts and classes.

(warning) Note that the plugin is work in progress. You can check the current status of the plugin here: issues and bugs

Eclipse version compatability

(error) Eclipse 3.0 : not working; there are dependencies to the 3.1 API.
(tick) Eclipse 3.1 : working
(tick) Eclipse 3.2 : working

Update Site

The update site containing the most recent release is here: http://dist.codehaus.org/groovy/distributions/update/

Download and build from Subversion

TODO: The details here need updating now that the Groovy repository has moved from CVS to Subversion. The plugin source can be found in

  /trunk/groovy/ide/groovy-eclipse/GroovyEclipse

and advice on access to the SVN repository can be found at: http://xircles.codehaus.org/projects/groovy/repo

Check out groovy/ide/groovy-eclipse/GroovyEclipse from CVS (see here CVS for CVS info) into a separate Eclipse project. Just use simple check-outs, CVS already contains all the information Eclipse needs to create the project properly (i.e. .project and .classpath and other files). Detailed description of how to accomplish the above in Eclipse.

  1. Select the Window Menu -> Other -> CVS Repository Exploring.
  2. In the context menu of the CVS Repositories pane, select New Repository Location
  3. Enter CVS information obtained from CVS;
  4. Open these folders HEAD/groovy/ide/groovy-eclipse/
  5. Select the GroovyEclipse module
  6. Right-click to get its context menu and select Check out (not Check out as)
  7. Now you should have a project called GroovyEclipse in your package explorer view; it should have compiled with 0 errors and 45 warnings (this may not stay this many for very long).

(warning) Note that you should be careful to not checkout outdated (deleted) files from the repository; this will likely result in compiler errors. This has been reported to happen when using CVSgrab.

To browse the CVS repository take a trip down this link: http://cvs.groovy.codehaus.org/viewrep/groovy/groovy/ide/groovy-eclipse.

Testing the plugin

It might be useful to test the plugin before you export it and use it in your main eclipse installation. To accomplish this

  1. Simply select or double click the file called plugin.xml from the GroovyEclipse project. This should bring up an editor for the plugin description; the first page should be called Overview.
  2. In this page, select the link Launch an Eclipse application. This should start a new Eclipse instance in which you have no projects.
    • You may optionally select Launch an Eclipse application in Debug mode. If you do, you will be able to edit the plugin code, and have your changes take effect immediately (hot code replacement). This is very useful if you are developing things and want to test your changes without stopping and restarting the runtime workbench. Note that there are certain limitations to this; it does not work with changing the plugin.xml file.
  3. Create a new Java project and configure the project (perhaps adding a package first).
  4. Create a new Groovy class named GTest. Do this on the context (right mouse button) menu of the package in which you want your groovy class; like so: New -> Other -> Groovy -> Groovy Class.
  5. You will be asked if you wish to "Add runtime groovy support and auto build to project?". Say yes.
  6. Fill in the groovy code of your desire, for example something like this:
    GTest.groovy

Running the example above

  1. In the Project Explorer, select GTest.groovy, then right mouse-click and Run -> Run
  2. In the Run pop-up, select Groovy in the list of configurations, then click New, and click the Search button to search for the Main class.
    The GTest class should appear in the list of Groovy classes to run. Select it and click OK.
  3. Click Apply, then Run... check your console view, it should read Rod, Phil...

(tick) THAT'S IT!

Exporting the plugin

To export the plugin for use with your main eclipse installation follow these simple instructions:

  1. Select the plugin.xml file.
  2. Select the link Export Wizard
  3. In Export destination -> Archive file: enter a filename, e.g. org.codehaus.groovy.eclipse_1.0.0.zip
  4. (Optionally, you may wish to check the 'Package plug-ins as individual jar archives' option under Export options. This is a new export format used by Eclipse 3.1, however the old format also works fine with Eclipse 3.1.)
  5. Click Finish, and you are done.

Installing the plugin

The zip file you just created is now just like any other plugin zip file, that can be unzipped under the eclipse root directory. To install the plugin:

  1. Shutdown Eclipse
  2. Open the zip file and extract its content to the eclipse root directory. You should check that either a folder or jar has been created under eclipse/plugin:
    • Either a directory org.codehaus.groovy.eclipse_1.0.0
    • or a jar file org.codehaus.groovy.eclipse_1.0.0.jar if you checked the 'Package plug-ins as individual jar archives' option when exporting the plugin.
  3. Restart Eclipse to install the Groovy plugin
  • No labels