vcpkg_msbuild_install

Kompilowanie i instalowanie projektu MSBuild.

Ta funkcja zastępuje vcpkg_install_msbuildelement .

vcpkg_msbuild_install wygeneruje plik props i plik docelowy zawierający flagi kompilacji łańcucha narzędzi CMake i dołączy go za pomocą polecenia /p:ForceImportAfterCpp(Props|Targets)

Sposób użycia

vcpkg_install_msbuild(
    SOURCE_PATH <${SOURCE_PATH}>
    PROJECT_SUBPATH <port.sln>
    [ADD_BIN_TO_PATH]
    [NO_INSTALL]
    [NO_TOOLCHAIN_PROPS]
    [CLEAN]
    [RELEASE_CONFIGURATION <Release>]
    [DEBUG_CONFIGURATION <Debug>]
    [TARGET <Build>]
    [PLATFORM <Win32>]
    [OPTIONS </p:ZLIB_INCLUDE_PATH=X>...]
    [OPTIONS_RELEASE </p:ZLIB_LIB=X>...]
    [OPTIONS_DEBUG </p:ZLIB_LIB=X>...]
    [DEPENDENT_PKGCONFIG <zlib>]
    [ADDITIONAL_LIBS <getopt.lib>]
    [ADDITIONAL_LIBS_DEBUG <zlibd.lib>]
    [ADDITIONAL_LIBS_RELEASE <zlib.lib>]
)

Aby użyć tej funkcji, musisz zależeć od portu vcpkg-msbuildpomocnika :

"dependencies": [
  { 
    "name": "vcpkg-msbuild",
    "host": true
  }
]

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 jest kopiowane do lokalizacji tymczasowej kompilacji. Ten parametr jest bazą dla tej kopii i tworzy bazę dla wszystkich opcji XYZ_SUBPATH.

PROJECT_SUBPATH

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

ADD_BIN_TO_PATH

Dodaje ścieżkę binarną zależną od konfiguracji do zmiennej PATH środowiskowej przed kompilacją. Jest to wymagane do uruchamiania narzędzi utworzonych przez sam projekt. Zmienna PATH środowiskowa nie jest zmutowana, jeśli VCPKG_CROSSCOMPILING jest true

NO_TOOLCHAIN_PROPS

Nie generuj właściwości łańcucha narzędzi za pomocą narzędzia cmake. Spowoduje to automatyczne wyłączenie integracji z programem vcpkg.

NO_INSTALL

Nie próbuj automatycznie instalować żadnych plików lib|. dll|. pdb|. pliki exe znalezione w dir kompilacji.

CZYSTE

Wskazuje, że pliki pośrednie powinny zostać usunięte po instalacji.

RELEASE_CONFIGURATION

Konfiguracja (/p:Configuration parametr msbuild) używany do kompilacji wydania. Wartości domyślne: Release

DEBUG_CONFIGURATION

Konfiguracja (/p:Configuration parametr msbuild) używany do kompilacji debugowania. Wartości domyślne: Debug

CEL

Docelowy program MSBuild do kompilacji (/t:<TARGET>). Wartości domyślne: Rebuild

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.

OPTIONS

Dodatkowe opcje przekazywania 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.

DEPENDENT_PKGCONFIG

Lista pkg-config zależności do dodania do kompilacji. Spowoduje to dodanie wszystkich wymaganych flag kompilacji (w tym/definicji/bibliotek) do właściwości kompilacji.

ADDITIONAL_LIBS

Dodatkowe biblioteki do dodania do projektu.

ADDITIONAL_LIBS_DEBUG

Dodatkowe biblioteki do dodania do programu msbuild dla kompilacji wydania. Są one dodatkiem do programu ADDITIONAL_LIBS.

ADDITIONAL_LIBS_RELEASE

Dodatkowe biblioteki do dodania do programu msbuild dla kompilacji debugowania. Są one dodatkiem do programu ADDITIONAL_LIBS.

Źródło

ports/vcpkg-msbuild/vcpkg_msbuild_install.cmake