vcpkg_install_msbuild

發行項
01/10/2024

警告

此函式已被取代為 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

共用方式為