Difference between revisions of "BlueBerry"
Jump to navigation
Jump to search
SaschaZelzer (talk | contribs) |
|||
| (11 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | |||
| − | |||
(formerly known as ''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]. | This is the Wiki for BlueBerry. For general information please see the [http://www.blueberry-project.org BlueBerry homepage]. | ||
| + | |||
=== Getting Started === | === 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 | + | 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: | 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 | + | * 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 | + | * 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. | * 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. | In the future, we will provide more tutorials and BlueBerry specific guides. | ||
| − | === Migrating from the | + | === 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 | + | 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, | + | 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. | 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. | ||
| Line 30: | Line 30: | ||
'''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. | '''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 and Tutorials === | ||
| Line 36: | Line 37: | ||
* [[How_to_fix_your_plug-in_DLL|How to fix your plug-in DLL]] | * [[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_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 | Tutorials | ||
* [[Tutorial_Writing_Unit_Tests_for_Bundles|Writing Unit Tests for Bundles]] | * [[Tutorial_Writing_Unit_Tests_for_Bundles|Writing Unit Tests for Bundles]] | ||
| − | |||
Articles | Articles | ||
| Line 51: | Line 53: | ||
For pure BlueBerry questions, see this [http://blueberry.berlios.de/serendipity/index.php?/plugin/faqs FAQ]. | For pure BlueBerry questions, see this [http://blueberry.berlios.de/serendipity/index.php?/plugin/faqs FAQ]. | ||
| − | For questions about the interplay of MITK, | + | For questions about the interplay of MITK, Qt, and BlueBerry, see the [[MITKBlueBerryFAQ]]. |
Latest revision as of 11: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.
- 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
Articles
FAQ
For pure BlueBerry questions, see this FAQ.
For questions about the interplay of MITK, Qt, and BlueBerry, see the MITKBlueBerryFAQ.