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_FLAGSCMAKE_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 提供了许多常用参数。 要查看完整列表,请检查源。

Source

scripts/cmake/vcpkg_configure_cmake.cmake