The latest version of this document lives in the vcpkg repo.
Build a cmake project.
vcpkg_cmake_build( [TARGET <target>] [LOGFILE_BASE <base>] [DISABLE_PARALLEL] [ADD_BIN_TO_PATH] )
vcpkg_cmake_build builds an already-configured cmake project.
You can use the alias [
if your CMake build system supports the
and this is something we recommend doing whenever possible.
Otherwise, you can use
TARGET to set the target to build.
This function defaults to not passing a target to cmake.
LOGFILE_BASE is used to set the base of the logfile names;
by default, this is
build, and thus the logfiles end up being something like
build-x86-windows-dbg.log; if you use
this is set to
install, so you'll get log names like
For build systems that are buggy when run in parallel,
DISABLE_PARALLEL will run the build with only one job.
ADD_BIN_TO_PATH adds the appropriate (either release or debug)
bin/ directories to the path during the build,
such that executables run during the build will be able to access those DLLs.