IDE setup

Eclipse package

Like Freeplane, Eclipse is based on an OSGI kernel. For this reason Eclipse provides very good support for developing OSGI applications:

• All Bundle properties can be managed via the project properties.
• One launch configuration for eclipse in the Freeplane sources, freeplane_devresources/eclipse/freeplane-osgi.launch, uses Eclipse' standard OSGI implementation.

Note: Unlike in the "real application" it's necessary to list all plugins to load in the launch configuration. In the regularly deployed application all plugins in the plugin subdirectory are loaded. (By the way also the user's Freeplane directory is scanned for plugins in a plugin directory if this exists.)

Therefore you need an eclipse version with Plug-in Development Environment (PDE), for example Eclipse for RCP and RAP Developers

Getting Started Working with Freeplane Within the Eclipse IDE

Setup

Make sure you have a copy of the Freeplane code - see the Bazaar How To for more information.

Firstly grab a copy of the newest version of Eclipse from the Eclipse homepage Eclipse Home.

Start up Eclipse - It should prompt you for a workspace (This is an area where your projects will be stored) have this where you set up your bzr branch.

Importing The Projects

Before we can start working with Freeplane we have to "import" it as a new project:

• Goto : File -> Import...
• Under "General" -> Existing Projects into Workspace
• Select root directory should point to the bzr branch. At this point a project list should appear ("note" if you are not developing for Apple Mac you can deselect the freeplane_mac project).
• Choose Finish. The projects should be added and the workspace will automatically "build".

Note: If at this point it complains about freeplane_ant this can also be removed as Eclipse does not ship with the correct ant version.

Launching the Project

Now that The project has been imported we need to set up the launcher:

• Goto : Run -> Run Configurations
• Locate the OSGi Framework tab
• Make a local copy of the freeplane-osgi file. Call this freeplane-osgi local
• Upon clicking "Run" Freeplane should appear.

You are now ready for development/debugging within Eclipse.

Settings

In project freeplane_devresources you find

• some launch configurations for starting the application
• eclipse code-templates, formatter and clean-up configuration files which must be used if you contribute your code to the project.

Version control integration

You can use eclipse bazaar plugin BzrEclipse. It requires the latest version of bazaar plug-in bzr-xmloutput which is not released yet but can be obtained directly from bazaar repository using command

bzr branch lp:bzr-xmloutput

Local code copy (branch) should be created using bzr or bzr-explorer as explained in Bazaar howto. After the freeplane projects are imported into eclipse workspace version control can be activated for them. Select the projects in the project explorer, right-click and perform team->Share project->Bazaar.

Useful Eclipse plugins

• For properties files, especially for language resources, the Properties Editor plugin is useful. Install the Properties Editor from the update site http://propedit.sourceforge.jp/index_en.html.