...

NOTE: While the Eclipse IDE is nice and somewhat easy for development on the Pentaho Reporting Classic Engine, it is by no means required to develop on or against the engine.

Install Eclipse with

...

SVN Tools

Make sure you have Eclipse setup and installed and you have installed Subclipse (Subversion tools for Eclipse). If you have not, follow the steps to setup your development environment.

...

svn://source.pentaho.org/pentaho-reporting 

is on Source Forge and the JFreeReport project contains CVS connection informationfor the repository.

...

• Open the CVS In Eclipse, open the SVN Repositories Window (Window Menu ? > Show View ? > Other ? > SVN ? > SVN Repository)
  Image Added
  
  
• Right click in the SVN Repository window ? > New ? > Repository Location...
  Image Added
  
  
• Fill in the following fields:

  Field Name	Value
  URL	svn://source.pentaho.org/pentaho-reporting

  Image Removed
 

• Image Added
  
• The connection should be established and displayed in the CVS SVN Repository window
  Image Added
  

Check Out the

...

Latest Code

Once the connection is established, it is time to check out the latest source code from the 0.8.x branch. The name of the branch is jfreereport release-0_8_7-branch and (while slightly confusing) it contains the latest code for the 0.8.x (a.k.a classic) codeline. This is currently at 0.8.9...

• Open the connection (click on the + next to the connection name) and you will see items titled HEAD, Branches, and Versions
• Navigate down to Branches ? release-0_8_7-branch ? jfreereport release-0_8_7-branch
  • if nothing shows up when clicking on Branches, right click on Branches and select Refresh Branches Image Removed

• Right-click on this item and select Check Out As...
• Make sure Check out as a project configured using the New Project Wizard is selected (along with Checkout subfolders) and click Next Image Removed

• Make sure the release-0_8_7-branch is selected and click Finish Image Removed

• On the New Project dialog, select Java Project and click Next
  Image Removed
  
• Specify the Project name of jfreereport and select any other required options (defaults are probably good) Image Removed

• At this point, the project will be created and the files checked out.

...

.

• In the SVN Repository windows, navigate to engines > classic > core > trunk
• Right-click and select Checkout...
  Image Added
  
• Click on the Finish button...
• From the New Project window, select Java Project...
  Image Added
  
• In the New Java Project window, enter the Project Name (something like pentaho-reporting-classic-core) and click on the Next button...
  Image Added
  
• In the Default output folder, append a /bin to the default folder and click Finish...
  Image Added
  
• Ignore the warning message about resources that exist in the project...
• At this point, the latest version of the project is checked out and the source code is sitting on your computer

Configure the Project for Eclipse

Configuring project paths

Once the project is checked out, there are some Eclipse specific tasks that need to be done since this isn't an Eclipse project by default.

• On Back in the Java perspective, on the Navigator or Package ExpolrerExplorer view, right-click on the jfreereport pentaho-reporting-classic-core project and select Properties
• Select the Java Build Path item
  Image Added
  
• On the Source tab:
  • Highlight the jfreereport pentaho-reporting-classic-core item and click the Remove button.
  • Click the Add Folder button, check the jfreereport ? pentaho-reporting-classic-core/source folder and click OK
    Image Added
    
  • Set the Default output folder to jfreereportpentaho-reporting-classic-core/bin (and uncheck un-check the Allow output folders for source folders option if it is selected) Image Removed

Configuring the classpath and dependent libraries

• On the Libraries tab, click the Add JARs... button
  • Navigate to the jfreereport pentaho-reporting-classic-core ? lib directory
  • Highlight all the jar files in that directory
  • Click on the OK button Image Removed
    Image Added
    
• Click on the OK button of the Properties dialog
  

At this point, the JFreeReport pentaho-reporting-classic-core project should compile and be ready for development.
You can repeat the same steps to work on the pentaho-reporting-classic-extensions project or any of the associated libraries (located under trunk/libraries):