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 參數)。
這會預設為建立 時 .vcxproj
Visual 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
。