vcpkg_configure_cmake
Avertissement
Cette fonction a été déconseillée en faveur de vcpkg_cmake_configure.
Configurez CMake pour les builds Debug et Release d’un projet.
Utilisation
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>...]
)
Paramètres
SOURCE_PATH
Spécifie le répertoire contenant le CMakeLists.txt.
Par convention, il est généralement défini dans le portfile comme variable SOURCE_PATH.
PREFER_NINJA
Indique que, lorsqu’il est disponible, vcpkg doit utiliser Ninja pour effectuer la build. Cela doit être spécifié, sauf si le port est connu pour ne pas fonctionner sous Ninja.
DISABLE_PARALLEL_CONFIGURE
Désactive l’exécution de l’étape de configuration CMake en parallèle. Cela est nécessaire pour les bibliothèques qui écrivent dans leur répertoire source pendant la configuration.
Cela désactive également CMAKE_DISABLE_SOURCE_CHANGES.
NO_CHARSET_FLAG
Désactive le passage utf-8 en tant que jeu de caractères par défaut sur CMAKE_C_FLAGS et CMAKE_CXX_FLAGS.
Cela est nécessaire pour les bibliothèques qui définissent le jeu de caractères de leur propre code source.
GÉNÉRATEUR
Spécifie le générateur précis à utiliser.
Cela est utile si un système de build spécifique à un projet a été encapsulé dans un script cmake qui n’effectue pas de build réelle.
Si elle est utilisée à cet effet, elle doit être définie sur "NMake Makefiles".
OPTIONS
Options supplémentaires transmises à CMake pendant la configuration.
OPTIONS_RELEASE
Options supplémentaires passées à CMake pendant la configuration release. Ils sont en plus de OPTIONS.
OPTIONS_DEBUG
Options supplémentaires passées à CMake pendant la configuration de débogage. Ils sont en plus de OPTIONS.
MAYBE_UNUSED_VARIABLES
Toutes les variables CMake qui sont transmises explicitement, mais qui ne peuvent pas être utilisées sur toutes les plateformes. Par exemple :
vcpkg_cmake_configure(
...
OPTIONS
-DBUILD_EXAMPLE=OFF
...
MAYBE_UNUSED_VARIABLES
BUILD_EXAMPLE
)
LOGNAME
Nom du journal dans lequel écrire la sortie de l’appel de configuration.
Notes
Cette commande fournit de nombreux arguments courants à CMake. Pour afficher la liste complète, examinez la source.
