vcpkg_install_msbuild

警告

此函式已被取代為 vcpkg_msbuild_install。。

建置並安裝以 msbuild 為基礎的專案。 這取代了 vcpkg_build_msbuild()

使用方式

vcpkg_install_msbuild(
    SOURCE_PATH <${SOURCE_PATH}>
    PROJECT_SUBPATH <port.sln>
    [INCLUDES_SUBPATH <include>]
    [LICENSE_SUBPATH <LICENSE>]
    [RELEASE_CONFIGURATION <Release>]
    [DEBUG_CONFIGURATION <Debug>]
    [TARGET <Build>]
    [TARGET_PLATFORM_VERSION <10.0.15063.0>]
    [PLATFORM <Win32>]
    [PLATFORM_TOOLSET <v143>]
    [OPTIONS </p:ZLIB_INCLUDE_PATH=X>...]
    [OPTIONS_RELEASE </p:ZLIB_LIB=X>...]
    [OPTIONS_DEBUG </p:ZLIB_LIB=X>...]
    [USE_VCPKG_INTEGRATION]
    [ALLOW_ROOT_INCLUDES | REMOVE_ROOT_INCLUDES]
)

參數

SOURCE_PATH

來源樹狀結構根目錄的路徑。

因為 MSBuild 使用來源內組建,因此來源樹狀結構將會複製到組建的暫存位置。 這個參數是該複本的基底,並構成所有XYZ_SUBPATH選項的基底。

USE_VCPKG_INTEGRATION

套用建置專案的一般 integrate install 整合。

根據預設,使用此命令建置的專案不會自動連結連結庫或設定標頭路徑。

PROJECT_SUBPATH

專案 () 或項目 (.sln.vcxproj) 檔案的子路徑相對於 SOURCE_PATH

LICENSE_SUBPATH

與相對 SOURCE_PATH之授權檔案的子路徑。

INCLUDES_SUBPATH

的子路徑包含相對於 的 SOURCE_PATH目錄。

此參數應該是目錄,不應該以尾端斜線結尾。

ALLOW_ROOT_INCLUDES

表示應該允許最上層包含檔案(例如 include/zlib.h)。

REMOVE_ROOT_INCLUDES

表示應該移除最上層的 Include 檔案(例如 include/Makefile.am)。

SKIP_CLEAN

表示不應該移除中繼檔案。

使用此選項的埠應該稍後呼叫 vcpkg_clean_msbuild() 以手動清除。

RELEASE_CONFIGURATION

用於發行組建的組態 (/p:Configuration msbuild 參數)。

DEBUG_CONFIGURATION

用於偵錯組建的組態 (/p:Configuration msbuild 參數)。

TARGET_PLATFORM_VERSION

WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion msbuild 參數)。

TARGET

要建置的 MSBuild 目標 (/t:<TARGET>)。

平台

用於組建的平臺 (/p:Platform msbuild 參數)。

這會預設為建立 時 .vcxprojVisual Studio 所使用之預設值的值對應VCPKG_TARGET_ARCHITECTURE

  • x86 成為 Win32
  • x64 成為 x64
  • arm 成為 ARM
  • arm64 成為 arm64

傳遞 .sln 而非 .vcxproj時,可能需要設定回 , ${VCPKG_TARGET_ARCHITECTURE} 以符合解決方案所使用的平臺字串。

PLATFORM_TOOLSET

用於組建的平臺工具組 (/p:PlatformToolset msbuild 參數)。

OPTIONS

所有組建傳遞至 msbuild 的其他選項。

OPTIONS_RELEASE

傳遞至發行組建 msbuild 的其他選項。 這些是 除了 OPTIONS

OPTIONS_DEBUG

傳遞至 msbuild 以進行偵錯組建的其他選項。 這些是 除了 OPTIONS

來源

scripts/cmake/vcpkg_install_msbuild.cmake