vcpkg_install_msbuild

Artigo
01/10/2024

Aviso

Esta função foi preterida em favor do vcpkg_msbuild_install.

Crie e instale um projeto baseado em msbuild. Substitui o vcpkg_build_msbuild().

Uso

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

Parâmetros

SOURCE_PATH

O caminho para a raiz da árvore de código-fonte.

Como o MSBuild usa compilações no código-fonte, a árvore de código fonte será copiada em um local temporário para a compilação. Esse parâmetro é a base para essa cópia e forma a base para todas as opções XYZ_SUBPATH.

USE_VCPKG_INTEGRATION

Aplicar a integração normal integrate install para a construção do projeto.

Por padrão, os projetos criados com esse comando não vincularão bibliotecas automaticamente ou terão caminhos de cabeçalho definidos.

PROJECT_SUBPATH

O subcaminho para o arquivo de solução () ou projeto (.sln.vcxproj) relativo a SOURCE_PATH.

LICENSE_SUBPATH

O subcaminho para o arquivo de licença relativo a SOURCE_PATH.

INCLUDES_SUBPATH

O subcaminho para o diretório includes relativo a SOURCE_PATH.

Esse parâmetro deve ser um diretório e não deve terminar em uma barra à direita.

ALLOW_ROOT_INCLUDES

Indica que arquivos de inclusão de nível superior (por exemplo include/zlib.h, ) devem ser permitidos.

REMOVE_ROOT_INCLUDES

Indica que os arquivos de inclusão de nível superior (por exemplo include/Makefile.am, ) devem ser removidos.

SKIP_CLEAN

Indica que os arquivos intermediários não devem ser removidos.

As portas que usam essa opção devem ser chamadas vcpkg_clean_msbuild() posteriormente para limpar manualmente.

RELEASE_CONFIGURATION

A configuração (/p:Configuration parâmetro msbuild) usada para compilações de versão.

DEBUG_CONFIGURATION

A configuração (/p:Configuration parâmetro msbuild) usada para compilações de Depuração.

TARGET_PLATFORM_VERSION

O WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion msbuild parâmetro).

TARGET

O destino do MSBuild a ser compilado (/t:<TARGET>).

PLATAFORMA

A plataforma (/p:Platform parâmetro msbuild) usada para a compilação.

Isso usa como padrão um mapeamento VCPKG_TARGET_ARCHITECTURE de valor para os valores padrão que o Visual Studio usa ao criar um .vcxproj:

x86 torna-se Win32
x64 torna-se x64
arm torna-se ARM
arm64 torna-se arm64

Ao passar um em vez de um .sln.vcxproj, talvez seja necessário redefinir para ${VCPKG_TARGET_ARCHITECTURE} corresponder às cadeias de caracteres de plataforma usadas pelas soluções.

PLATFORM_TOOLSET

O conjunto de ferramentas da plataforma (/p:PlatformToolset parâmetro msbuild) usado para a compilação.

OPTIONS

Opções adicionais passadas para msbuild para todas as compilações.

OPTIONS_RELEASE

Opções adicionais passadas para msbuild para compilações de versão. Estes são além de OPTIONS.

OPTIONS_DEBUG

Opções adicionais passadas para msbuild para compilações de depuração. Estes são além de OPTIONS.

Origem

scripts/cmake/vcpkg_install_msbuild.cmake

Compartilhar via