Compartilhar via


vcpkg_configure_cmake

Aviso

Essa função foi descontinuada em favor de vcpkg_cmake_configure.

Configure o CMake para builds 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 arquivo de porta como a variável SOURCE_PATH.

PREFER_NINJA

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

DISABLE_PARALLEL_CONFIGURE

Desabilita 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 desativa CMAKE_DISABLE_SOURCE_CHANGES.

NO_CHARSET_FLAG

Desabilita a passagem utf-8 como o conjunto de caracteres padrão para 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 da versão. Estes são adicionais ao OPTIONS.

OPTIONS_DEBUG

Opções adicionais passadas para o CMake durante a configuração de depuração. Estes são adicionais ao OPTIONS.

MAYBE_UNUSED_VARIABLES

Todas as variáveis do CMake que são passadas explicitamente, 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 gravar a saída da chamada configure.

Observações

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

Origem

scripts/cmake/vcpkg_configure_cmake.cmake