Typically, when you set up a Java project in Eclipse, the Eclipse IDE adds a default Java Build Nature, and the project is configured for default automatic building. Eclipse though is capable of incorporating multiple build natures. Please see the Eclipse Article on Natures for more information about build natures as a technology. This article is focused on utilizing this capability in Pentaho projects to make the development process easier.

Prerequisites

The screen shot attached to this article is from Eclipse 3.2.2. This capability has been in Eclipse since Eclipse 3.0. Versions of Eclipse other than 3.2.2 may have different ways to define a new build nature. It is also assumed that a project has been downloaded from subversion into Eclipse.

Instructions

  1. Right-click on the project in Eclipse and choose Properties on the context menu.
  2. In the left panel, select Builders.
  3. In the right-panel, select New...
  4. Select Ant Build and click the OK button
  5. Fill out the tabbed dialog with information as follows:

Launch Configuration Properties - Main Tab

Launch Configuration Properties - Refresh Tab

Launch Configuration Properties - Targets Tab

Results

If this was successful, you should see a new folder in your project called .externalToolBuilders with one file in it. The file will be named according to what you chose above as the name of the builder. To test that things work for you, you can clean an individual project, and you should also see the Ant script execute the target specified.

Troubleshooting

  1. In Eclipse 3.2.2, I notice that the "Build" operation for manually building doesn't predictably execute the Ant task. Clean always works.

Related Items