Udostępnij za pośrednictwem

vcpkg_install_msbuild

  • Artykuł

Ostrzeżenie

Ta funkcja została przestarzała na rzecz vcpkg_msbuild_install.

Kompilowanie i instalowanie projektu opartego na programie msbuild. Zastąpi ono narzędzie vcpkg_build_msbuild().

Sposób użycia

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

Ścieżka do katalogu głównego drzewa źródłowego.

Ponieważ program MSBuild używa kompilacji w źródle, drzewo źródłowe zostanie skopiowane do lokalizacji tymczasowej kompilacji. Ten parametr jest bazą dla tej kopii i tworzy bazę dla wszystkich opcji XYZ_SUBPATH.

USE_VCPKG_INTEGRATION

Zastosuj normalną integrate install integrację do kompilowania projektu.

Domyślnie projekty utworzone za pomocą tego polecenia nie będą automatycznie łączyć bibliotek ani ustawiać ścieżek nagłówków.

PROJECT_SUBPATH

Ścieżka podrzędna do pliku rozwiązania () lub projektu (.sln.vcxproj) względem SOURCE_PATH.

LICENSE_SUBPATH

Ścieżka podrzędna do pliku licencji względem SOURCE_PATH.

INCLUDES_SUBPATH

Ścieżka podrzędna do katalogu dołączania SOURCE_PATHwzględem .

Ten parametr powinien być katalogiem i nie powinien kończyć się ukośnikiem końcowym.

ALLOW_ROOT_INCLUDES

Wskazuje, że pliki dołączane najwyższego poziomu (np. include/zlib.h) powinny być dozwolone.

REMOVE_ROOT_INCLUDES

Wskazuje, że pliki dołączania najwyższego poziomu (np. include/Makefile.am) powinny zostać usunięte.

SKIP_CLEAN

Wskazuje, że nie należy usuwać plików pośrednich.

Porty korzystające z tej opcji powinny później wywołać vcpkg_clean_msbuild() metodę w celu ręcznego oczyszczenia.

RELEASE_CONFIGURATION

Konfiguracja (/p:Configuration parametr msbuild) używany do kompilacji wydania.

DEBUG_CONFIGURATION

Konfiguracja (/p:Configuration parametr msbuild) używany do kompilacji debugowania.

TARGET_PLATFORM_VERSION

WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion parametr msbuild).

CEL

Docelowy program MSBuild do kompilacji (/t:<TARGET>).

PLATFORMY

Platforma (/p:Platform parametr msbuild) używany do kompilacji.

To ustawienie domyślne powoduje mapowanie VCPKG_TARGET_ARCHITECTURE wartości na wartości domyślne używane przez program Visual Studio podczas tworzenia elementu .vcxproj:

  • x86 Staje się Win32
  • x64 Staje się x64
  • arm Staje się ARM
  • arm64 Staje się arm64

W przypadku przekazywania elementu .sln.vcxprojzamiast elementu , może być konieczne przywrócenie wartości w celu dopasowania ciągów ${VCPKG_TARGET_ARCHITECTURE} platformy używanych przez rozwiązania.

PLATFORM_TOOLSET

Zestaw narzędzi platformy (/p:PlatformToolset parametr msbuild) używany do kompilacji.

OPTIONS

Dodatkowe opcje przekazane do programu msbuild dla wszystkich kompilacji.

OPTIONS_RELEASE

Dodatkowe opcje przekazane do programu msbuild dla kompilacji wydania. Są one dodatkiem do programu OPTIONS.

OPTIONS_DEBUG

Dodatkowe opcje przekazane do programu msbuild dla kompilacji debugowania. Są one dodatkiem do programu OPTIONS.

Źródło

scripts/cmake/vcpkg_install_msbuild.cmake