Compartilhar via


vcpkg_configure_cmake

Aviso

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

Configure o CMake para compilações de depuração e versão de um projeto.

Uso

vcpkg_configure_cmake(
    SOURCE_PATH <${SOURCE_PATH}>
    [PREFER_NINJA]
    [DISABLE_PARALLEL_CONFIGURE]
    [NO_CHARSET_FLAG]
    [GENERATOR <"NMake Makefiles">]
    [OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
    [OPTIONS_RELEASE <-DOPTIMIZE=1>...]
    [OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
    [MAYBE_UNUSED_VARIABLES <OPTION_NAME>...]
)

Parâmetros

SOURCE_PATH

Especifica o diretório que contém o CMakeLists.txtarquivo . Por convenção, isso geralmente é definido no portfile como a variável SOURCE_PATH.

PREFER_NINJA

Indica que, quando disponível, vcpkg deve usar Ninja para executar a compilação. Isso deve ser especificado, a menos que a porta seja conhecida por não funcionar em Ninja.

DISABLE_PARALLEL_CONFIGURE

Desativa a execução da etapa de configuração do CMake em paralelo. Isso é necessário para bibliotecas que gravam de volta em seu diretório de origem durante a configuração.

Isso também desabilita CMAKE_DISABLE_SOURCE_CHANGES.

NO_CHARSET_FLAG

Desabilita a passagem utf-8 como o caractere padrão definido como CMAKE_C_FLAGS e CMAKE_CXX_FLAGS.

Isso é necessário para bibliotecas que definem o conjunto de caracteres de seu próprio código-fonte.

GERADOR

Especifica o gerador preciso a ser usado.

Isso é útil se algum sistema de compilação específico do projeto tiver sido encapsulado em um script cmake que não executará uma compilação real. Se usado para essa finalidade, ele deve ser definido como "NMake Makefiles".

OPTIONS

Opções adicionais passadas para o CMake durante a configuração.

OPTIONS_RELEASE

Opções adicionais passadas para o CMake durante a configuração do Release. Estes são além de OPTIONS.

OPTIONS_DEBUG

Opções adicionais passadas para o CMake durante a configuração de Depuração. Estes são além de OPTIONS.

MAYBE_UNUSED_VARIABLES

Quaisquer variáveis CMake que são explicitamente passadas, mas que não podem ser usadas em todas as plataformas. Por exemplo:

vcpkg_cmake_configure(
    ...
    OPTIONS
        -DBUILD_EXAMPLE=OFF
    ...
    MAYBE_UNUSED_VARIABLES
        BUILD_EXAMPLE
)

NOME DO LOG

Nome do log para o qual gravar a saída da chamada de configuração.

Observações

Esse comando fornece muitos argumentos comuns ao CMake. Para ver a lista completa, examine a fonte.

Exemplos

Origem

scripts/cmake/vcpkg_configure_cmake.cmake