install#
Configure (if needed), build, and install the project.
clibra install --preset release
clibra install runs the install target for the resolved preset.
Like build, it configures automatically when the
build directory is absent and otherwise builds incrementally. The install
destination is the preset’s CMAKE_INSTALL_PREFIX.
Configure-time defines#
-D VAR=VALUE values are forwarded to the configure step, but only when
a configure actually runs. If the build directory already exists and
neither --reconfigure nor --fresh is given, passing -D values
is treated as a configuration error and the command aborts rather than
silently ignoring them.
LTO#
--lto enables link-time optimization by appending LIBRA_LTO=YES to
the configure step, and --no-lto disables it, without requiring a
dedicated LTO preset. These trigger a reconfigure only when the requested
LTO state differs from what the existing cache already has, so repeated
installs with the same flag do not needlessly reconfigure.
CMake equivalent#
Cold start (no build directory):
cmake --preset <name> [-D VAR=VALUE ...]
cmake --build --preset <name> --target install
Incremental:
cmake --build --preset <name> --target install
Flag reference#
clibra install#
Configure (if needed), build, and install the project
Usage: clibra install [OPTIONS]
Options:#
-D <VAR=VALUE>— Forward -DVAR=VALUE to the CMake configure step when active. If the build directory exists and neither –reconfigure nor –fresh is given, abort-r,--reconfigure— Force the configure step even if the build directory exists-f,--fresh— Reconfigure with a –fresh build directory by wiping the CMake cache--lto— Enable LTO via LIBRA