04. Configuring IntelliJ IDEA With Versioning System

04. Configuring IntelliJ IDEA With Versioning System

Overview

If you want to setup an IntelliJ IDEA workspace with the Pentaho Reporting Classic Engine source code, the following instructions will get you started.

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

Install IntelliJ IDEA

This walk-through was created with IntelliJ IDEA 7.0.1, but should work in a similar fashion for other versions.

Create a New Project 

  • In IDEA, select New Project... from the File menu

  • On the New Project dialog, make sure the Create project from scratch option is selected and click Next >



  • Enter the name of the project (pentaho-reporting as an example)

  • Enter the location of the project (c:\code\pentaho-reporting as an example)

  • Uncheck the Create Module check box

  • Click on the Finish button


    After the project is created, the Project Settings dialog will appear. Perform the following tasks:

  • Add one JDKs to the list (if there are none)

  • In the General settings, select the Project JDK and the Project language level

  • Leave the Modules section blank (for now)

    Check Out the Source Code from the Subversion Repository

  • From the Version Control menu, select Checkout from Version Control and then Subversion

  • Click on the Add Repository Location icon

  • Enter the repository location:svn://source.pentaho.org/pentaho-reporting and click OK

  • Select the to the svn://source.pentaho.org/pentaho-reporting/engines/classic/core/trunk directory and click on the Checkout button

  • When prompted, create and select the destination directory (and all the directories down to it): ${project.home}/engines/classic/core

  • Accept the default checkout options

  • After the checkout has completed, select NO when asked if IDEA should create a new project for the source that was just checked out

Repeat the above steps for the following projects:

  • /engines/classic/core/trunk (done in the walk-though above)

  • /engines/classic/extensions/trunk

  • /engines/classic/demo/trunk

  • /libraries/jcommon-serializer

  • /libraries/libfonts/trunk

  • /libraries/libformula/trunk

  • /libraries/libloader/trunk

  • /libraries/librepository/trunk

  • /libraries/libxml/trunk

  • /libraries/pixie/trunk

Setup Modules

Once all the source code has been checked out of subversion, it is time to create and setup the modules.

  • Click on the Settings toolbar icon to bring up the Settings dialog

  • Select the Project Settings dialog and select Modules...

  • Select the Add New Modules button (plus icon)

  • On the Add Module dialog, select the Create module from scratch radio button

  • In the Content root text field, select the directory where the core source was checked out and placed. This should automatically select the Module file location and the Name of the module. Once selected, click the Next button.

  • Verify the selected source files and then select Next

  • There is no need to select any of the desired technologies, so just click on the Finish button.

Repeat the above steps to add the following modules:

  • core (from the steps above)

  • extensions

  • demo

  • jcommon-serializer

  • libfonts

  • libformula

  • libloader

  • librepository

  • libxml

  • pixie