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/Makefile.amследует удалить).

SKIP_CLEAN

Указывает, что промежуточные файлы не должны быть удалены.

Порты, использующие этот параметр, должны позже вызываться vcpkg_clean_msbuild() вручную.

RELEASE_CONFIGURATION

Конфигурация (/p:Configuration параметр msbuild), используемая для сборок выпуска.

DEBUG_CONFIGURATION

Конфигурация (/p:Configuration параметр msbuild), используемая для сборок отладки.

TARGET_PLATFORM_VERSION

WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion параметр msbuild).

ЦЕЛЕВОЙ ОБЪЕКТ

Целевой объект MSBuild для сборки (/t:<TARGET>).

ПЛАТФОРМА

Платформа (/p:Platform параметр msbuild), используемый для сборки.

Это значение по умолчанию сопоставляется VCPKG_TARGET_ARCHITECTURE со значениями по умолчанию, используемыми Visual Studio при создании .vcxproj:

x86 заменяется на Win32.
x64 заменяется на x64.
arm заменяется на ARM.
arm64 заменяется на arm64.

При передаче вместо нее .sln.vcxprojможет потребоваться вернуться в ${VCPKG_TARGET_ARCHITECTURE} соответствие со строками платформы, используемыми решениями.

PLATFORM_TOOLSET

Набор инструментов платформы (/p:PlatformToolset параметр msbuild), используемый для сборки.

ПАРАМЕТРЫ

Дополнительные параметры, переданные в msbuild для всех сборок.

OPTIONS_RELEASE

Дополнительные параметры, передаваемые в msbuild для сборок выпуска. Это в дополнение к OPTIONS.

OPTIONS_DEBUG

Дополнительные параметры, передаваемые в msbuild для сборок отладки. Это в дополнение к OPTIONS.

Оригинал

scripts/cmake/vcpkg_install_msbuild.cmake

Поделиться через