Qpid-Cpp-Win-Sdk | |
================ | |
Table of Contents | |
================= | |
1. Introduction | |
2. Prerequisites | |
3. Kit contents | |
4. Building unmanaged C++ examples | |
5. Building dotnet_examples | |
6. Notes | |
1. Introduction | |
=============== | |
Qpid-Cpp-Win-Sdk is a software development kit for users who wish | |
to write code using the Qpid-Cpp program libraries in a Windows | |
environment. | |
This kit is distributed as four zip files: | |
qpid-cpp-x86-VS2008-<version>.zip - projects and libraries for 32-bit | |
x86 and Win32 development using | |
Visual Studio 2008. | |
qpid-cpp-x64-VS2008-<version>.zip - projects and libraries for 64-bit | |
x64 development using | |
Visual Studio 2008. | |
qpid-cpp-x86-VS2010-<version>.zip - projects and libraries for 32-bit | |
x86 and Win32 development using | |
Visual Studio 2010. | |
qpid-cpp-x64-VS2010-<version>.zip - projects and libraries for 64-bit | |
x64 development using | |
Visual Studio 2010. | |
For additional software or information on the Qpid project go to: | |
http://cwiki.apache.org/qpid/ | |
2. Prerequisites | |
================ | |
A. Visual Studio 2008 or Visual Studio 2010. The kits were produced | |
using Visual Studio 2008 or Visual Studio 2010 and provide a matched | |
set of link libraries for each tool chain. | |
B. MSVC runtime libraries. Copies of the MSVC redistributable runtime | |
libraries and manifest are included in the \bin\release directories. | |
C. Boost version 1_47. The Boost libraries required by this SDK are | |
included in the \bin\debug and \bin\release directories. | |
D. CMake version 2.8.6 or later, available for free from http://cmake.org/ | |
CMake generates custom Visual Studio solutions and projects for | |
the unmanaged C++ examples. | |
3. Kit contents | |
=============== | |
The kit directories hold the content described here. | |
\bin | |
The precompiled binary (.dll and .exe) files and | |
the associated debug program database (.pdb) files. | |
Boost library files. | |
MSVC runtime library files are in \bin\release. | |
\include | |
A directory tree of .h files. | |
\lib | |
The linker .lib files that correspond to files in /bin. | |
\docs | |
Apache Qpid C++ API Reference | |
\examples | |
Source files which demonstrate using this SDK in unmanaged C++. | |
\dotnet_examples | |
A Visual Studio solution file and associated project files | |
to demonstrate using this SDK in C#. | |
\management | |
A python scripting code set for generating QMF data structures. | |
For more information on Qpid QMF go to: | |
https://cwiki.apache.org/qpid/qpid-management-framework.html | |
The architectural relationships of the components in this SDK are | |
illustrated here. | |
+----------------------------+ | |
| \dotnet_examples | | |
| Managed C# | | |
+------+---------------+-----+ | |
| | | |
V | | |
+---------------------------+ | | |
| Managed Callback | | | |
| org.apache.qpid.messaging.| | | |
| sessionreceiver.dll | | | |
+----------------------+----+ | | |
| | | |
managed V V | |
(.NET) +-------------------------------+ | |
:::::::::::::::::::::::| Qpid Interop Binding |:::::::::::: | |
unmanaged | org.apache.qpid.messaging.dll | | |
(Native Win32/64) +---------------+---------------+ | |
| | |
| | |
+----------------+ | | |
| \examples | | | |
| Unmanaged C++ | | | |
+--------+-------+ | | |
| | | |
V V | |
+----------------------------------+ | |
| Qpid C++ Messaging Libraries | | |
| bin\qpid*.dll bin\qmf*.dll | | |
+--------+--------------+----------+ | |
| | | |
V | | |
+-----------------+ | | |
| Boost Libraries | | | |
+--------+--------+ | | |
| | | |
V V | |
+---------------------------------+ | |
| MSVC Runtime Libraries | | |
+---------------------------------+ | |
4. Building unmanaged C++ examples | |
=========================== | |
This version of Qpid-Cpp-Win-Sdk ships with no pre-built Visual Studio | |
solution or project files for the C++ examples. Instead this kit has | |
support for using CMake to generate the solution and project files. | |
A. Make sure that the CMake bin directory is defined in your path. | |
You may check this from a command prompt by typing: | |
> cmake --version | |
cmake version 2.8.6 | |
If CMake is installed correctly it will respond with a version number. | |
B. Change directory to \examples\examples-cmake. | |
C. Execute run-cmake.bat batch file. | |
Run-cmake.bat runs CMake and generates the Visual Studio solution and | |
project files using the version of Visual Studio that matches this | |
Qpid-Cpp-Win-Sdk kit. | |
D. Execute the generated examples.sln Visual Studio solution file. | |
5. Building dotnet_examples | |
=========================== | |
From the \dotnet_examples directory launch the winsdk_dotnet_examples.sln | |
solution file. In the platform pulldown list select "x86" or "x64" to | |
match the development kit you are using. Then build the solution in the | |
Debug or Release configuration. | |
6. Notes | |
======== | |
* Only the Release variant of Qpid code uses the redistributable | |
MSVC libraries in the /bin/release directory. Users who wish to link to | |
the Debug variant of Qpid code may do so under their own copy of | |
Visual Studio where the debug versions of MSVC90 or MSVC100 runtime | |
libraries are available. | |