# Building and Using QCoro ## Building QCoro QCoro uses CMake build system. You can pass following options to the `cmake` command when building QCoro to customize the build: * `-DQCORO_BUILD_EXAMPLES` - whether to build examples or not (`ON` by default). * `-DQCORO_BUILD_TESTING` - whether to build tests or not (defaults to `${BUILD_TESTING}`), can be used to disable building QCoro tests when building QCoro as part of a bigger project which has `BUILD_TESTING` enabled. * `-DQCORO_ENABLE_ASAN` - whether to build QCoro with AddressSanitizer (`OFF` by default). * `-DBUILD_SHARED_LIBS` - whether to build QCoro as a shared library (`OFF` by default). * `-DUSE_QT_VERSION` - set to `5` or `6` to force a particular version of Qt. When not set the highest available version is used. * `-DQCORO_WITH_QTDBUS` - whether to compile support for QtDBus (`ON` by default). * `-DQCORO_WITH_QTNETWORK` - whether to compile support for QtNetwork (`ON` by default). * `-DQCORO_WITH_QTWEBSOCKETS` - whether to compile support for QtWebSockets (`ON` by default). * `-DQCORO_DISABLE_DEPRECATED_TASK_H` - will not build and install the deprecated task.h header (`OFF` by default). ``` mkdir build cd build cmake .. make # This will install QCoro into /usr/local/ prefix, change it by passing -DCMAKE_INSTALL_PREFIX=/usr # to the cmake command above. sudo make install ``` ## CMake Depending on whether you want to use Qt5 or Qt6 build of QCoro, you should use `QCoro5` or QCoro6` in your CMake code, respectively. The example below is assuming Qt6: ```cmake # Use QCoro5 if you are building for Qt5! find_package(QCoro6 REQUIRED COMPONENTS Core Network DBus) # Set necessary compiler flags to enable coroutine support qcoro_enable_coroutines() ... target_link_libraries(your-target QCoro::Core QCoro::Network QCoro::DBus) ``` Note the missing Qt version number in the `QCoro` target namespace: QCoro provides both versioned (`QCoro5` and `QCoro6`) namespaces as well as version-less namespace, which is especially useful for transitioning codebase from Qt5 to Qt6. ## QMake Using QCoro with QMake projects (`.pro`) is simple: just add the required QCoro modules to the `QT` variable: ``` QT += QCoroCore QCoroNetwork QCoroDBus # Enable C++20 CONFIG += c+=20 # Enable coroutine support in the compiler QMAKE_CXXFLAGS += -fcoroutines ``` You don't need to worry about Qt5 vs Qt6, qmake will pick up the correct build of QCoro depending on whether you are using QMake for Qt5 or Qt6. Currently it's necessary to manually enable C++20 and coroutine support (unless that's already default in your system/compiler settings).