Difference between revisions of "BlueBerry"

From mitk.org
Jump to navigation Jump to search
(username removed)
 
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
−
= openCherry =
+
(formerly known as ''openCherry'')
 +
 
  
 
== A modular, cross-platform, C++ application framework ==
 
== A modular, cross-platform, C++ application framework ==
 +
This is the Wiki for BlueBerry. For general information please see the [http://www.blueberry-project.org BlueBerry homepage].
 +
 +
 +
=== Getting Started ===
 +
If you want to develop with BlueBerry, please see the [http://blueberry.berlios.de/serendipity/index.php?/pages/download.html 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 [http://docs.mitk.org/nightly/BlueBerryIntro.html 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 your plug-in DLL]]
 +
* [[How_to_fix_strange_compiler_errors|How to fix strange compiler errors]]
 +
* [[How_to_fix_strange_runtime_errors|How to fix strange runtime errors]]
 +
* [[How to enable debugging output]]
 +
 +
Tutorials
 +
 +
* [[Tutorial_Writing_Unit_Tests_for_Bundles|Writing Unit Tests for Bundles]]
 +
 +
Articles
 +
 +
* [[Article_Save_and_Restore_your_View_State|Save and Restore your View State]]
 +
* [[Article_Using_the_Selection_Service|Using the Selection Service]]
 +
* [[Article_Using_Perspectives_in_the_Workbench|Using Perspectives in the Workbench]]
 +
 +
=== FAQ ===
 +
For pure BlueBerry questions, see this [http://blueberry.berlios.de/serendipity/index.php?/plugin/faqs FAQ].
 +
 +
For questions about the interplay of MITK, Qt, and BlueBerry, see the [[MITKBlueBerryFAQ]].

Latest revision as of 12:21, 4 December 2017

(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.

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

Tutorials

Articles

FAQ

For pure BlueBerry questions, see this FAQ.

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

Retrieved from "http://mitk.org/w/index.php?title=BlueBerry&oldid=3269"