Groovy-Eclipse is the set of Eclipse plugins that provide Eclipse support for Groovy projects.

Installation

The latest Groovy-Eclipse release is available from the following Eclipse update sites. To install, point your Eclipse update manager to the update site appropriate for your Eclipse version or drag and drop the marketplace icon into your Eclipse installation.

Eclipse level	Release update site
4.3 (Kepler)	`http://dist.springsource.org/snapshot/GRECLIPSE/e4.3/` Kepler-based builds are still snapshots. We are providing early access for those people who want to try it out.
4.2 and 3.8 (Juno)	`http://dist.springsource.org/release/GRECLIPSE/e4.2/`
3.7 (Indigo)	`http://dist.springsource.org/release/GRECLIPSE/e3.7/`
3.6 (Helios)	`http://dist.springsource.org/release/GRECLIPSE/e3.6/`
3.5 (Galileo)	`http://dist.springsource.org/release/GRECLIPSE/e3.5/`

Or, you can choose to install a development build, see below for more update sites. In general, our development builds are quite stable. A development build is not published unless all unit tests pass.

The install directory must be writable by the current user. Groovy-Eclipse cannot be installed into a shared install. This includes protected directories on windows like C:\Program Files. For more information Eclipse Bug 395516.

News

Groovy-Eclipse 2.7.2 Released!

This service refresh of Groovy-Eclipse provides significant improvements with the @CompileStatic annotation. Also, we have upgraded to Groovy 2.0.6. Other fixes and features are included as well. See all the details: Groovy-Eclipse 2.7.2 New and Noteworthy. (December 19, 2012)

Groovy-Eclipse 2.7.1 Released!

This service refresh of Groovy-Eclipse provides some bug fixes as well as notification of compiler level mismatches between the workspace and individual projects. See all the details: Groovy-Eclipse 2.7.1 New and Noteworthy. (September 23, 2012)

Groovy-Eclipse build server moved

The Groovy-Eclipse build server has moved. The new location is at https://build.springsource.org/browse/GRECLIPSE. The old location at http://bamboo.ci.codehaus.org/browse/GRECLIPSE will be available for historical reasons. (August 3, 2012)

Groovy-Eclipse 2.7.0 Released!

In this release, Groovy 2.0 support is officially released, Eclipse Juno support is officially released, and we introduce some new quickfixes and refactorings. See all the details: Groovy-Eclipse 2.7.0 New and Noteworthy. (July 3, 2012)

Features and Status

Groovy-Eclipse allows you to edit, compile, run, and debug Groovy scripts and classes from the Eclipse SDK.

Groovy-Eclipse is the top open source development tool at EclipseCon 2010.

Key Features

Syntax highlighting
Type inferencing
Compile and run Groovy classes and scripts in Eclipse
Outline view for Groovy files
Auto-completion
Refactoring
Source code formatting
Basic debug support
Groovy 2.0, 1.8 and 1.7 compilers
DSL support using DSL descriptors
Maven integraion

Read about the goals, approach, and implementation of Groovy-Eclipse v2 here.

New and Noteworthy

See what's new in the latest release at Groovy-Eclipse 2.7.2 New and Noteworthy.

For information about prior releases, see here:

Eclipse Version Compatibility

Groovy-Eclipse Plugin v2 supports Eclipse versions 4.2.x, 3.7.x, 3.6.x, 3.5.x, and 3.4.2. Groovy-Eclipse for Eclipse 3.6 and earlier are no longer supported, but the builds are still available.

Groovy compiler Compatibility

By default, Groovy-Eclipse comes with a 1.8 and 1.7 Groovy compiler. A Groovy 2.0 compiler can optionally be installed from the Groovy update site. See Compiler Switching within Groovy-Eclipse for more information.

Getting Other Builds

Milestone and development builds are also available. A milestone build is a relatively stable build, released at the completion of a project milestone. Development builds are are published more frequently, and contain more new features and fixes. Published development build have passed unit tests, but may be less stable than milestone builds.

Milestone Builds

We occasionally release milestone builds of upcoming releases. These are meant for users who want to have access to the most recent features and who are willing to give us feedback on them.

Groovy-Eclipse milestone and release candidate builds are available at:

Eclipse level	Milestone update site
4.2 / 3.8 (Juno)	`http://dist.springsource.org/milestone/GRECLIPSE/e4.2/`
3.7 (Indigo)	`http://dist.springsource.org/milestone/GRECLIPSE/e3.7/`
3.6 (Helios)	`http://dist.springsource.org/milestone/GRECLIPSE/e3.6/`
3.5 (Galileo)	`http://dist.springsource.org/milestone/GRECLIPSE/e3.5/`

Please note that these builds are temporary and are typically removed after the final release has been made public.

Development Builds

Use one of these update sites to install the latest and greatest Groovy-Eclipse. Development builds tend to be quite stable (they are not released unless all tests pass) and so if you are having any difficulty with your current install, then it is recommended to update to the latest dev build. To install, paste the appropriate update site below into your Eclipse update manager, select the artifacts to install and follow the instructions.

Eclipse level	Development update site
4.2 / 3.8 (Juno)	`http://dist.springsource.org/snapshot/GRECLIPSE/e4.2/`
3.7 (Indigo)	`http://dist.springsource.org/snapshot/GRECLIPSE/e3.7/`
3.6 (Helios)	`http://dist.codehaus.org/groovy/distributions/greclipse/snapshot/e3.6/`
3.5 (Galileo)	`http://dist.codehaus.org/groovy/distributions/greclipse/snapshot/e3.5/`

Although these builds may not be as stable as milestone or release builds, they pass our suite of unit and integration tests. These builds are typically usable, and if there is a problem it is often fixed quickly.

Archived Development Builds

If you want to use a local update site instead or you cannot access the update site because of a firewall then you can download an archive of the update site:

Eclipse level	Development update site zip
4.2 / 3.8 (Juno)	`http://dist.springsource.org/snapshot/GRECLIPSE/e4.2/index.html`
3.7 (Indigo)	`http://dist.springsource.org/snapshot/GRECLIPSE/e3.7/index.html`
3.6 (Helios)	`http://ci.repository.codehaus.org/greclipse/snapshot/e36/old`
3.5 (Galileo)	`http://ci.repository.codehaus.org/greclipse/snapshot/e35/old`

There is also an ancient zip of Groovy-Eclipse V2.0.0 for Eclipse 3.5 available to download.

These zip files are the compressed version of the update site. They are not plugins that you can just drop into your eclipse installation. Here's how to install an archive:

Download the zip file
Do not unzip or move into your dropins directory
Start eclipse
Help -> Install new software -> Add...
Select the location of the zip you just downloaded
Install as you would from the regular update site

Getting Started with Groovy-Eclipse v2

This section has brief instructions for getting started with Groovy-Eclipse v2. The instructions assume familiarity with Eclipse. Users new to Eclipse, may wish to follow the links to tutorials, which illustrate and provide novice level instructions for installing and using the plugin.

How to Install

Start with a compatible version of Eclipse (available from http://eclipse.org/downloads. Since Groovy-Eclipse relies on Eclipse's Java tooling (the JDT), almost any flavor of Eclipse that includes the JDT will be compatible. This includes the Java IDE, Classic, RCP, JavaEE, etc. Flavors such as Eclipse for PHP developers are not compatible because it does not include the JDT> If you are interested in Grails tooling, then you must install the SpringSource Tool Suite.

Once you have a compatible Eclipse installed, then follow these directions to install Groovy-Eclipse:

Go to: Help -> Software Updates.
Change to the Available Software tab.
Click on Add Site.
Paste the update site URL appropriate for your version of Eclipse and click OK.
You should see a "Groovy Update Site" entry in the list of update sites. Expand and select the Groovy-Eclipse Plugin feature. Optionally, you can choose to include the sources..
Click Install and follow the prompts.
Restart when asked
Rejoice! You installed the Groovy-Eclipse Plugin v2.

For step-by-step installation instructions, see the Install Groovy-Eclipse Plugin tutorial.

How to Create a Groovy Project

To create a basic Groovy project in Eclipse perform the following steps:

Open the Java perspective
Click on the new Groovy Project icon:
The new project wizard for Groovy uses most of the same options as the new project wizard for Java.
Fill in the appropriate details and create the project.

You should have a src folder and several libraries. A bin folder is also created, but is hidden.

You can create a Groovy classes or test cases using wizards similar to the Eclipse's Java class and JUnit test case wizards. Use the options on the File > New menu or press CTRL-N.

For step-by-step instructions, see the Create Your First Groovy Project tutorial.

Information and Resources

Use the resources listed below to learn about Groovy-Eclipse Plugin v2 and keep track of project status and milestones.

FAQs

See the Eclipse Plugin FAQ.

Tutorials

The first two of a series of tutorials on using Groovy-Eclipse Plugins v2 are available.

Install Groovy-Eclipse Plugin
Create Your First Groovy Project
Installation and use of Grails tooling (STS is required. Free download here.)

Mailing Lists

Join Groovy-Eclipse mailing lists to find answers, ask questions, and contribute to discussions about v2 of the plugin.

For usage-related topics, join http://xircles.codehaus.org/lists/eclipse-plugin-user@groovy.codehaus.org.
For dev-related topics, join http://xircles.codehaus.org/lists/eclipse-plugin-dev@groovy.codehaus.org.
Report Bugs - Bugs can be viewed and filed at http://jira.codehaus.org/browse/GRECLIPSE.

Developer Resources

For a detailed and reasonably up to date information on how to check out Groovy-Eclipse from Subversion, see Getting Started With Groovy-Eclipse Source Code.

The summary:

The CI Server for Groovy-Eclipse is located at the Bamboo server. (Note that this is a new location as of August 3, 2012.)
The Groovy-Eclipse Plugin v2 git repository is located at https://github.com/groovy/groovy-eclipse. If you are new to github and git, you can familiarize yourself by reading some good tutorials at github.
The Groovy-Eclipse Plugin v2 SVN repository is now deprecated. For historical reasons, you can still access it at at http://svn.codehaus.org/groovy/eclipse/trunk/. If you are new to Subversion, see Subversion home page.
The plugin source itself is partially written in Groovy. And for that reason, you must have Groovy-Eclipse installed before you can compile Groovy-Eclipse.
If you are interested in working Groovy source code or plan to do a local build, please contact the eclipse plugin dev mailing list and we can help you out.
See a list of bugs suitable for community members to work on. All the issues labelled help requested are a good place to start.

Open Issues

You can browse or enter new issues on the GRECLIPSE project on the jira server.