vcpkg_configure_cmake

Articolo
10/30/2024

Avviso

Questa funzione è stata deprecata a favore di vcpkg_cmake_configure.

Configurare CMake per le compilazioni di debug e rilascio di un progetto.

Utilizzo

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

Parametri

SOURCE_PATH

Specifica la directory contenente l'oggetto CMakeLists.txt. Per convenzione, questo viene in genere impostato nel file di porta come variabile SOURCE_PATH.

PREFER_NINJA

Indica che, se disponibile, vcpkg deve usare Ninja per eseguire la compilazione. Questa operazione deve essere specificata a meno che la porta non funzioni in Ninja.

DISABLE_PARALLEL_CONFIGURE

Disabilita l'esecuzione del passaggio di configurazione di CMake in parallelo. Questa operazione è necessaria per le librerie che riscrivano nella directory di origine durante la configurazione.

Questa opzione disabilita anche CMAKE_DISABLE_SOURCE_CHANGES.

NO_CHARSET_FLAG

Disabilita il utf-8 passaggio come set di caratteri predefinito su CMAKE_C_FLAGS e CMAKE_CXX_FLAGS.

Questa operazione è necessaria per le librerie che impostano il set di caratteri del codice sorgente.

GENERATORE

Specifica il generatore preciso da utilizzare.

Ciò è utile se è stato eseguito il wrapping di un sistema di compilazione specifico del progetto in uno script cmake che non eseguirà una compilazione effettiva. Se usato a questo scopo, deve essere impostato su "NMake Makefiles".

OPTIONS

Opzioni aggiuntive passate a CMake durante la configurazione.

OPTIONS_RELEASE

Opzioni aggiuntive passate a CMake durante la configurazione della versione. Si aggiungono a OPTIONS.

OPTIONS_DEBUG

Opzioni aggiuntive passate a CMake durante la configurazione di debug. Si aggiungono a OPTIONS.

MAYBE_UNUSED_VARIABLES

Qualsiasi variabile CMake passata in modo esplicito, ma che non può essere usata in tutte le piattaforme. Ad esempio:

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

LOGNAME

Nome del log in cui scrivere l'output della chiamata di configurazione.

Note

Questo comando fornisce molti argomenti comuni a CMake. Per visualizzare l'elenco completo, esaminare l'origine.

Origine

scripts/cmake/vcpkg_configure_cmake.cmake

Condividi tramite