vcpkg_install_msbuild

Článek
01/10/2024

Upozorňující

Tato funkce byla zastaralá ve prospěch vcpkg_msbuild_install.

Sestavte a nainstalujte projekt založený na nástroji msbuild. Nahrazuje nástroj vcpkg_build_msbuild().

Využití

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]
)

Parametry

SOURCE_PATH

Cesta ke kořenovému adresáři zdrojového stromu.

Vzhledem k tomu, že nástroj MSBuild používá sestavení ve zdroji, zdrojový strom se zkopíruje do dočasného umístění sestavení. Tento parametr je základem pro tuto kopii a tvoří základ pro všechny možnosti XYZ_SUBPATH.

USE_VCPKG_INTEGRATION

Použijte normální integrate install integraci pro sestavení projektu.

Ve výchozím nastavení projekty vytvořené pomocí tohoto příkazu nebudou automaticky propojit knihovny nebo mít nastavené cesty hlaviček.

PROJECT_SUBPATH

Dílčí cesta k souboru řešení (.sln) nebo projektu (.vcxproj) vzhledem k SOURCE_PATH.

LICENSE_SUBPATH

Dílčí cesta k souboru licence vzhledem k SOURCE_PATH.

INCLUDES_SUBPATH

Subpath to the includes directory relative to SOURCE_PATH.

Tento parametr by měl být adresář a neměl by končit koncovým lomítkem.

ALLOW_ROOT_INCLUDES

Označuje, že by měly být povoleny soubory na nejvyšší úrovni (např. include/zlib.h).

REMOVE_ROOT_INCLUDES

Označuje, že je třeba odebrat soubory zahrnutí nejvyšší úrovně (např. include/Makefile.am).

SKIP_CLEAN

Označuje, že zprostředkující soubory by neměly být odebrány.

Porty používající tuto možnost by se měly později volat vcpkg_clean_msbuild() , aby se ručně vyčistily.

RELEASE_CONFIGURATION

Konfigurace (/p:Configuration parametr msbuild) použitá pro sestavení vydané verze.

DEBUG_CONFIGURATION

Konfigurace (/p:Configuration parametr msbuild) použitá pro sestavení ladění.

TARGET_PLATFORM_VERSION

WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion parametr msbuild).

CÍL

Cíl nástroje MSBuild pro sestavení (/t:<TARGET>).

PLATFORMA

Platforma (/p:Platform parametr msbuild) použitá pro sestavení.

Ve výchozím nastavení se použije mapování VCPKG_TARGET_ARCHITECTURE hodnot na výchozí hodnoty, které Sada Visual Studio používá při vytváření .vcxproj:

x86 stane se Win32
x64 stane se x64
arm stane se ARM
arm64 stane se arm64

Pokud předáte .sln místo .vcxproj, může být nutné ji nastavit tak, aby ${VCPKG_TARGET_ARCHITECTURE} odpovídala řetězcům platformy používaným řešeními.

PLATFORM_TOOLSET

Sada nástrojů platformy (/p:PlatformToolset parametr msbuild) použitá pro sestavení.

OPTIONS

Další možnosti předané nástroji msbuild pro všechna sestavení

OPTIONS_RELEASE

Další možnosti předané nástroji msbuild pro sestavení vydané verze. Jsou to navíc OPTIONS.

OPTIONS_DEBUG

Další možnosti předané nástroji msbuild pro sestavení ladění. Jsou to navíc OPTIONS.

Source

scripts/cmake/vcpkg_install_msbuild.cmake

Sdílet prostřednictvím