...
If you want to setup an Eclipse development environment with the JFreeReport Pentaho Reporting Classic Engine source code (the latest code on the version 0.8.x track), the following instructions will get you started.
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 and CVS tools for Eclipse). If you have not, follow the steps to setup your development environment.
Connect to the
...
SVN Repository
...
The next step is to connect to the CVS SVN Repository for the JFreeReport Pentaho Reporting project. This repository is on Source Forge and the JFreeReport project contains CVS connection information for the repository.
| Panel |
|---|
NOTE: This repository will soon change to a subversion repository hosted by Pentaho. Stay tuned for changes... |
...
is:
svn://source.pentaho.org/pentaho-reporting
- In Eclipse, open the SVN Repositories Window (Window Menu - > Show View - > Other - > CVS -> CVS ReposirotiesSVN > SVN Repository)
- Right click in the CVS Repositories SVN Repository window - > New - > Reposiroty Repository Location...
- Fill in the following fields:
| Panel |
|---|
NOTE: This connection is created with the anonymous user. It will not allow any check-in of modified code. If you have developer access to the repository, this step is a little different. |
- Click Finish
Field Name
Value
...
Host
...
jfreereport.cvs.sourceforge.net
...
Repository Path
...
/cvsroot/jfreereport
...
User
...
anonymous
...
Connection Type
...
pserver
...
Use Default Port
...
selected
...
Validate connection on finish
...
checked
URL
svn://source.pentaho.org/pentaho-reporting
- The connection should be established and the connection should be displayed in the CVS SVN Repository window
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...
...
- if nothing shows up when clicking on Branches, right click on Branches and select Refresh Branches
...
.
- In the SVN Repository windows, navigate to engines > classic > core > trunk
- Right-click and select Checkout...
- Click on the Finish button...
- From the New Project window, select Java Project...
- In the New Java Project window, enter the Project Name (something like pentaho-reporting-classic-core) and click on the Next button...
- In the Default output folder, append a /bin to the default folder and click Finish...
- 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
- 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
- Set the Default output folder to pentaho-reporting-classic-core/bin (and un-check the Allow output folders for source folders option if it is selected)
Configuring the classpath and dependent libraries
| Note | ||
|---|---|---|
| ||
Due to a bug in SVN, which causes binary checkins to corrupt the repository, the Reporting Projects do not always contain the latest versions of the internal libraries. The JARs checked in always represent the last release, not the latest development version. If you develop for the trunk-version of the reporting engine, make sure that you check out all dependent projects from the Subversion Repository and use these sources for your development. All modern IDEs are capable to define dependencies between subprojects of the same workspace, and therefore, if you set up your IDE correctly, pre-built JARs are not needed. |
- On the Libraries tab, click the Add JARs... button
- Navigate tothe jfreereport --> to the pentaho-reporting-classic-core ? lib directory
- Highlight all the jar files in that directory
- Click on the OK button
- 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):
| Include Page | ||||
|---|---|---|---|---|
|