vcpkg_configure_cmake
警告
此函数已弃用,改用 vcpkg_cmake_configure
。
为项目的调试和发布构建配置 CMake。
使用情况
vcpkg_configure_cmake(
SOURCE_PATH <${SOURCE_PATH}>
[PREFER_NINJA]
[DISABLE_PARALLEL_CONFIGURE]
[NO_CHARSET_FLAG]
[GENERATOR <"NMake Makefiles">]
[OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
[OPTIONS_RELEASE <-DOPTIMIZE=1>...]
[OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
[MAYBE_UNUSED_VARIABLES <OPTION_NAME>...]
)
参数
SOURCE_PATH
指定包含 CMakeLists.txt
的目录。
按照约定,这通常在端口文件中设置为变量 SOURCE_PATH
。
PREFER_NINJA
指示在可用时,vcpkg 应使用 Ninja 执行构建。 除非已知端口在 Ninja 下无法正常工作,否则应指定此项。
DISABLE_PARALLEL_CONFIGURE
禁用并行运行 CMake 配置步骤。 这对于在配置过程中回写到其源目录的库来说是必需的。
这还将禁用 CMAKE_DISABLE_SOURCE_CHANGES。
NO_CHARSET_FLAG
禁用将 utf-8
作为默认字符集传递给 CMAKE_C_FLAGS
和 CMAKE_CXX_FLAGS
。
这对于设置自己源代码字符集的库来说是必需的。
GENERATOR
指定要使用的精确生成器。
如果某些项目特定的构建系统已包装在不会执行实际构建的 cmake 脚本中,此项非常有用。
如果用于此目的,应将其设置为 "NMake Makefiles"
。
OPTIONS
配置期间传递给 CMake 的其他选项。
OPTIONS_RELEASE
发布配置期间传递给 CMake 的其他选项。 这些是对 OPTIONS
的补充。
OPTIONS_DEBUG
调试配置期间传递给 CMake 的其他选项。 这些是对 OPTIONS
的补充。
MAYBE_UNUSED_VARIABLES
显式传入但可能无法在所有平台上使用的任何 CMake 变量。 例如:
vcpkg_cmake_configure(
...
OPTIONS
-DBUILD_EXAMPLE=OFF
...
MAYBE_UNUSED_VARIABLES
BUILD_EXAMPLE
)
LOGNAME
要向其写入配置调用输出的日志的名称。
备注
此命令向 CMake 提供了许多常用参数。 要查看完整列表,请检查源。