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 (official Conan 2 version should be available soon)
  • flex (library and tool)
  • bison (tool)
  • cmocka (for testing)
• 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. For a debug build, follow these steps:

export BUILD_TYPE="Debug"
export BUILD_PRESET="conan-debug"

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

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON --preset ${BUILD_PRESET}
cmake --build --preset ${BUILD_PRESET}

ctest --verbose --preset ${BUILD_PRESET}

Release build is similar:

export BUILD_TYPE="Release"
export BUILD_PRESET="conan-release"

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

cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON --preset ${BUILD_PRESET}
cmake --build --preset ${BUILD_PRESET}

ctest --verbose --preset ${BUILD_PRESET}

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