boxes/README-cmake-conan.md

CMake and Conan based build environment

Prerequisites

Building boxes requires two tools to be installed:

• Conan, a package manager for C/C++, is used to resolve required library and tool dependencies
  • libunistring
  • pcre2
  • ncurses
  • flex (library and tool)
  • bison (tool)
• CMake is used for building.
  Make sure that a C compiler and the tools for the underlying build environment (e.g., GNU Make or Ninja) are installed.

If Conan is used for the first time, start with the creation of a default profile:

conan profile detect

Building boxes

It is recommended to use the generated presets for building:

export BUILD_TYPE="Debug"

conan install . --output-folder=./build/${BUILD_TYPE} \
    --settings build_type=${BUILD_TYPE} \
    --build missing

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON --preset conan-debug
cmake --build --preset conan-debug

ctest --verbose --preset conan-debug

Of course the "classic" way works, too:

export BUILD_TYPE="Debug"

conan install . --output-folder=./build/${BUILD_TYPE} \
    --settings build_type=${BUILD_TYPE} \
    --build missing

cmake -S ./ -B ./build/${BUILD_TYPE} \
    -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
    -DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
    -DCMAKE_TOOLCHAIN_FILE=conan_toolchain.cmake

cmake --build ./build/${BUILD_TYPE} \
    --config ${BUILD_TYPE}

ctest --test-dir ./build/${BUILD_TYPE} --verbose