Since November 2023
These scripts were intended to simplify development of conan based projects. Conan-install and cmake-generate steps were having many overlapring options (the same values were needed for conan and cmake tools). These scripts served as a tool to rceive params once and then apply them as necessary to both tools (running tests or install is just a sugar).
A collection of scripts for building C++ projects with CMake and Conan package manager.
In order for default paths to work a directory with scripts build-scripts is considered to be on the same level as root CMakeLists.txt.
Core script is linux_common.sh. Help speaks for itself:
$ ./linux_common.sh -h
The general script's help msg
Usage: ./build-scripts/linux_common.sh [-c|--compiler <arg>] [-M|--compiler-major <arg>] [-m|--compiler-minor <arg>] [--compiler-cppstd <arg>] [--(no-)compiler-names-add-version] [--compiler-libcxx <arg>] [-t|--build-type <arg>] [-d|--build-dir <arg>] [-s|--source-dir <arg>] [--(no-)conan-enable] [--conan-options <arg>] [--conan-deploy-path <arg>] [--cmake-path <arg>] [--ctest-path <arg>] [--cmake-options <arg>] [-n|--(no-)cmake-ninja] [--(no-)run-ctest] [--(no-)run-install] [-j|--make-jobs <arg>] [--banner-text <arg>] [--(no-)trace-commands] [--(no-)dry-run] [-h|--help]
-c, --compiler: Compiler to use: clang, gcc (default: 'gcc')
-M, --compiler-major: Compiler major version (no default)
-m, --compiler-minor: Compiler minor version (no default)
--compiler-cppstd: Compiler C++ standard: 11, 14, 17, 20, 23 (no default)
--compiler-names-add-version, --no-compiler-names-add-version: Adding version when declaring CC, CPP variables for CMake (on by default)
--compiler-libcxx: The version of libcxx to use in a build: libstdc++11,libstdc++,libc++ (no default)
-t, --build-type: Build type: Release, Debug, RelWithDebInfo, MinSizeRel (default: 'Release')
-d, --build-dir: Directory to build in (CMAKE_BINARY_DIR in terms of CMake) (no default)
-s, --source-dir: Source root directory (if not specified considered a parent directory of a build directory) (no default)
--conan-enable, --no-conan-enable: Enable conan for a project (runs 'conan install' command with necessary flags for a given source directory) (off by default)
--conan-options: Extra Conan options (e.g. "-r my-remote-server") (no default)
--conan-deploy-path: Run conan deploy install to a given path (no default)
--cmake-path: Path to CMake (default: 'cmake')
--ctest-path: Path to CTest (default: 'ctest')
--cmake-options: Extra CMake options (e.g. "-DCMAKE_INSTALL_PREFIX=install_path -DMy_PRJ_FLAG_X=On <...>") (no default)
-n, --cmake-ninja, --no-cmake-ninja: Use Ninja as cmake generator option (off by default)
--run-ctest, --no-run-ctest: Run unit tests with CTest (off by default)
--run-install, --no-run-install: Run install with CMake (off by default)
-j, --make-jobs: Number of jobs when running make (default: '1')
--banner-text: Print banner with specified text (no default)
--trace-commands, --no-trace-commands: Print executed commands (off by default)
--dry-run, --no-dry-run: Run without executing commands (off by default)
-h, --help: Prints help
Scripts named gccNN.sh/clangN.sh are shortcuts for common cases of build environment.
Script prepares and executes shell commands to perform a build with given parameters.
Example of commands executed for gcc9:
export CC=gcc-9
export CPP=g++-9
export AR=gcc-ar-9
export CXX=g++-9
rm -rf /home/ngrodzitski/github/ngrodzitski/my_prj/_build_gcc9
mkdir /home/ngrodzitski/github/ngrodzitski/my_prj/_build_gcc9
cd /home/ngrodzitski/github/ngrodzitski/my_prj/_build_gcc9
conan install -s compiler=gcc -s compiler.version=9 -s build_type=Release \
--build missing /home/ngrodzitski/github/ngrodzitski/my_prj
cmake -DCMAKE_BUILD_TYPE=Release /home/ngrodzitski/github/ngrodzitski/my_prj
cmake --build . -j 8BSD 3-Clause License.