vcpkg_cmake_build

构建带有自定义安装目标的 cmake 项目。

通常,CMake 使用目标 install 构建二进制文件并将二进制文件复制到 CMAKE_INSTALL_PREFIX 中。 在极少数情况下,项目可能应改用更具体的目标。

如果可能,端口应首选调用 vcpkg_cmake_install()

使用情况

vcpkg_cmake_build(
    [TARGET <target>]
    [LOGFILE_BASE <base>]
    [DISABLE_PARALLEL]
    [ADD_BIN_TO_PATH]
)

要使用此函数,必须依赖于帮助程序端口 vcpkg-cmake

"dependencies": [
  {
    "name": "vcpkg-cmake",
    "host": true
  }
]

参数

vcpkg_cmake_build() 支持 vcpkg_cmake_install() 的所有支持参数。 有关其参数的详细信息,请参阅 vcpkg_cmake_install()

TARGET

要构建的 CMake 目标。

如果未传递此参数,则不会向构建传递任何目标。

LOGFILE_BASE

日志的备用根目录名。

默认为 build-${TARGET_TRIPLET}。 该项不应包含任何路径分隔符。 将生成与模式 ${CURRENT_BUILDTREES_DIR}/${LOGFILE_BASE}-<suffix>.log 匹配的日志

示例

vcpkg_from_github(OUT_SOURCE_PATH source_path ...)
vcpkg_cmake_configure(
    SOURCE_PATH "${source_path}"
    OPTIONS
        -DBUILD_EXAMPLES=OFF
        -DBUILD_TESTS=OFF
)
vcpkg_cmake_build(TARGET my.install.target)

搜索 microsoft/vcpkg 以获取示例

注解

此命令将取代 vcpkg_build_cmake()

Source

ports/vcpkg-cmake/vcpkg_cmake_build.cmake