BlueBerry

(formerly known as openCherry)

A modular, cross-platform, C++ application framework

This is the Wiki for BlueBerry. For general information please see the BlueBerry homepage.

Getting Started

If you want to develop with BlueBerry, please see the download link. MITK users who want to use BlueBerry should read the information in http://docs.mitk.org/nightly/BuildInstructionsPage.html (the BlueBerry source code is distributed with MITK).

For an overview about the features and capabilities of BlueBerry, see the links below:

• A good place to get an overview of the C++ classes is the BlueBerry doxygen documentation.
• To learn more about OSGi, visit http://www.osgi.org
• You can learn more about the BlueBerry Workbench by reading the corresponding articles about the Eclipse Workbench and browsing the Workbench User Guide on http://help.eclipse.org. Many concepts are the same in BlueBerry, especially Views, Editors, Perspectives, Commands, the Selection Service, etc.

In the future, we will provide more tutorials and BlueBerry specific guides.

Migrating from the BlueBerry bundle system to the CTK Plugin Framework

The Common Toolkit (CTK) provides an OSGi-inspired plugin framework which is much more robust and advanced compared to the BlueBerry implementation. With merge commit 87e3684 (05.06.2011) BlueBerry and hence the MITK based applications CoreApp and ExtApp use the CTK Plugin Framework.

During the migration phase, BlueBerry will support both its legacy bundle mechanism and CTK-based plug-ins simultaneously. Contributions and services provided by bundles and plug-ins will be merged together and will be accessible through the same API.

However, you need to make some minor modifications to your code if you are using or providing BlueBerry bundles in your projects. Below you will find a list of wiki pages dealing with different scenarios.

• Fixing legacy BlueBerry bundles
• Fixing external projects
• Converting a BlueBerry bundle to a CTK plugin

Important: After updating your MITK sources, you MUST delete your MITK build tree. If you are using the MITK superbuild, it suffices to remove the MITK-build directory and issue a build at the superbuild level.

How-Tos and Tutorials

How-Tos

• How to fix your plug-in DLL
• How to fix strange compiler errors
• How to fix strange runtime errors
• How to enable debugging output

Tutorials

• Writing Unit Tests for Bundles

Articles

• Save and Restore your View State
• Using the Selection Service
• Using Perspectives in the Workbench

FAQ

For pure BlueBerry questions, see this FAQ.

For questions about the interplay of MITK, Qt, and BlueBerry, see the MITKBlueBerryFAQ.