XDispatch was tested on and currently run's on the following operating systems:
We expect it to run on various other flavors of Linux as well, however we had no chance to test it yet. The officially supported development environments and/or toolchains include:
When intending to develop with libXDispatch please ensure you are using one of the supported environments. Afterwards go to the downloads page and select the appropriate binary package. Included are the necessary headers and library files you have to link with. Normally linking with xdispatch or dispatch should be sufficient, see the appropriate documentation for details. When using the Qt interface, you have to link with qtdispatch as well. Please note that you have to link with the Qt additionally in case you want to use the QtDispatch library.
Another possible approach is to include the sources directly into your own source tree, e.g. by using svn:externals and referring to our stable branch. This is the recommended way when already using CMake. When doing so, all you need to do is to add the xdispatch directory by using the add_subdirectory() call, setting the proper global includes to our include/ directory and linking your own targets with the targets xdispatch and/or QtDispatch.
For examples and demonstrations of xdispatch and the Grand Central Dispatch approach, we recommend to have a look at Getting Started and refer to Apple's Online Documentation mentioned in the Introduction.
Building libXDispatch means you either intend to build your own copy or want to directly integrate the libXDispatch sources with your project (easily done when using CMake).
libXDispatch is coming as ready-to-use, i.e. we include all dependencies (except Qt) within our source tree. Of course you do not need to use our versions of the third party libraries, but use your own. To do so, you should have the following libraries and their development files installed and have them reachable by compiler and linker:
Please note that all those libraries are available as debian packages using apt or aptitude as well. Our build scripts will automatically detect any pre-installed versions.
Additionally to a supported toolchain / operating system you need CMake 2.8+ installed and reachable in your path. If you want to build QtDispatch, please ensure that you have a SDK for Qt 4.7.0+ installed and qmake is reachable in your path as well. If all this is satisfied, get your copy of the current sources (see Get a copy), enter the root directory (where you find the README.dox) and run (depending on you platform):
cmake
Afterwards you should find a solution file in your xdispatch folder. Build it and the binaries can be found within the 'bin' directory.
cmake -G "Unix Makefiles"
make all
When finished, all binaries can be found within the 'Bin' directory.
cmake -G "XCode"
You should find an xcodeproject in your xdispatch folder. Upon build completion, all binaries can be found in the 'bin' directory as well.
Alternatively you can simply include the sources from with a CMakeLists.txt configuration to be built along with your complete project:
add_subdirectory(xdispatch)
Other generators are available as well, please consult the CMake documentation at http://www.cmake.org for more detailed information.
Of course we welcome any news on sucessful builds on other operating systems / toolchains currently not declared as officially supported. Please contact us to report any success stories.