These are the instructions for installing KD Reports using the CMake buildsystem. CMake version 3.3 or higher is required. The qmake (via autogen.py) buildsystem is removed starting with KDReports version 2.0. KD Reports requires Qt with PrintSupport and XML support enabled. Qt Version support: * KD Reports 1.8 or below requires Qt4.6 up to Qt5.15 * KD Reports 1.9 requires Qt5.6 up to Qt5.15 * KD Reports 2.0 or above requires Qt5.9 up to Qt6.x Please see the comments at the top of CMakeLists.txt for the available configuration options you can pass to cmake. The installation directory defaults to c:\KDAB\KDReports- on Windows and /usr/local/KDAB/KDReports- on non-Windows. You can change this location by passing the option -DCMAKE_INSTALL_PREFIX=/install/path to cmake. 1) From the top directory of your KD Reports installation create a build directory: mkdir build and change directory into that build directory: cd build 2) Now run 'cmake' depending on the kind of build one of the following: cmake -DCMAKE_BUILD_TYPE=Debug .. cmake -DCMAKE_BUILD_TYPE=Release .. cmake -DKDReports_STATIC=True -DCMAKE_BUILD_TYPE=Debug .. cmake -DKDReports_STATIC=True -DCMAKE_BUILD_TYPE=Release .. To define the install-location use for example: cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=C:/kdreports .. cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/opt/kdreports .. 3) Unix set your LD_LIBRARY_PATH to point to your KD Reports installation lib directory. If you do not have LD_LIBRARY_PATH set already, then in your terminal run: % LD_LIBRARY_PATH=/path/to/kdreports/lib:$LD_LIBRARY_PATH % export LD_LIBRARY_PATH The above must be added into your .bashrc or similar to remain. It may also of course be run from a shell just before building software using KD Reports, but in this case your settings will only be available for this shell. 4) MacOS Proceed as described above, but using DYLD_LIBRARY_PATH instead of LD_LIBRARY_PATH 5) Windows For running executables, add the path to the KD Reports dll (kdreports\bin) into your PATH. eg. set PATH=\path\to\kdreports\bin;%PATH% For development, add the path to the KD Reports lib (kdreports\lib) into your LIB environment. eg. set LIB=\path\to\kdreports\lib;%LIB% 6) Build everything by typing: From your top-level KD Reports directory run: % make # Unix, Mac % nmake # Windows 7) (optionally:) Install KD Reports: From your top-level KD Reports directory run: % make install # Unix, Mac % nmake install # Windows This will copy the necessary files into the sub-directories of your installation path: For Unix/Linux, Mac this is /usr/local/KDAB/KDReports-VERSION/ For Windows this is: C:\KDAB\KDReports-VERSION\ 8) Have a look at the examples applications. They will get you started with KD Reports. == Testing == To build the testing harness, pass -DKDReports_TESTS=true to CMake, like so: % cmake -DKDReports_TESTS=true Then run 'make test' to run the unit tests. == Using == From your CMake project, add find_package(KDReports CONFIG REQUIRED) and link to the imported target KDReports::kdreports. That's all you need to do (the imported target also brings in the include directories) You may also need to point the CMAKE_PREFIX_PATH environment variable depending on where you installed KDReports.