Options de commande courantes

La plupart des commandes vcpkg acceptent un groupe d’options courantes qui contrôlent les aspects croisés de l’outil. Toutes les options n’affectent pas toutes les commandes. Par exemple, une commande qui ne télécharge aucun fichier n’est affectée par la modification du répertoire des téléchargements.

Options

--x-asset-sources=<config>

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Spécifiez la configuration du cache pour la mise en cache des ressources.

--binarysource=<config>

Ajoutez une source pour la mise en cache binaire.

Cette option peut être spécifiée plusieurs fois ; consultez la documentation de mise en cache binaire pour savoir comment plusieurs sources binaires interagissent.

--x-buildtrees-root=<path>

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Spécifie le chemin d’accès temporaire pour stocker des fichiers de build intermédiaires, tels que des objets ou du code source décompressé.

La valeur par défaut est buildtrees/ sous le dossier racine vcpkg.

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Active les systèmes CMakeLists.txtde génération CMake --debugger dans amont, comme dans vcpkg_cmake_configure.

La <debugger-pipe> valeur est transmise comme --debugger-pipe sur la ligne de commande CMake.

S’il existe une liste de ports séparés par des points-virgules, le débogueur est utilisé uniquement pour les ports de cette liste. Sinon, il est utilisé pour tous les ports.

La variable VCPKG_CMAKE_CONFIGURE_OPTIONS triplet est utilisée pour passer les options à l’appel de configuration CMake interne. Par conséquent, il ne fonctionnera pas pour les triplets personnalisés remplacer VCPKG_CMAKE_CONFIGURE_OPTIONS. Passez manuellement les options de débogage ou ajoutez vos options à VCPKG_CMAKE_CONFIGURE_OPTIONS la place.

Contrairement --x-cmake-debug à l’absence de sortie indiquant que la build attend qu’un débogueur se connecte. La sortie se bloque simplement à Configuring <triplet>.

Bien que tous les ports appellent CMake à l’intérieur du fichier de port pour obtenir des indicateurs de compilation à partir de la chaîne d’outils CMake. Cette commande est principalement utile pour les ports utilisant CMake comme système de génération.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Active CMake lors de l’exécution --debugger de scripts CMake appelés directement, tels que des fichiers triplet (par exemple : x64-windows.cmake) ou portfile.cmake des fichiers.

La <debugger-pipe> valeur est transmise comme --debugger-pipe sur la ligne de commande CMake.

S’il existe une liste de ports séparés par des points-virgules, le débogueur est utilisé uniquement pour les ports de cette liste. Sinon, il est utilisé pour tous les ports.

Remarque : Le débogueur peut être attaché s’il Waiting for debugger client to connect... peut être observé dans la sortie de vcpkg et l’exécution est arrêtée jusqu’à ce qu’un débogueur soit connecté.

--downloads-root=<path>

Spécifiez où les outils téléchargés et les archives de code source doivent être conservés.

Valeur par défaut de la variable d’environnement VCPKG_DOWNLOADS . S’il n’est pas défini, la downloads/ valeur par défaut est sous le dossier racine vcpkg.

--feature-flags=<flag1>,...

Cette variable peut être définie sur une liste d’indicateurs de fonctionnalité pour accepter le comportement expérimental.

--host-triplet=<triplet>

Spécifiez le triplet de l’hôte.

Valeur par défaut de la variable d’environnement VCPKG_DEFAULT_HOST_TRIPLET . Si cela n’est pas défini, la valeur est déduite en fonction de l’architecture hôte et du système d’exploitation.

--x-install-root=<path>

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Spécifie le chemin d’accès à la configuration des packages installés.

En mode Classique, la valeur par défaut est installed/ sous le dossier racine vcpkg.

En mode manifeste, la vcpkg_installed/ valeur par défaut est sous le dossier manifeste.

--x-manifest-root=<path>

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Spécifie le répertoire contenant vcpkg.json.

Par défaut, la recherche vers le haut à partir du répertoire de travail actuel pour le plus vcpkg.jsonproche .

--overlay-ports=<path>

Spécifie un répertoire contenant des ports de superposition.

Cette option peut être spécifiée plusieurs fois ; les ports sont résolus en première correspondance.

--overlay-triplets=<path>

Spécifie un répertoire contenant des triplets de superposition.

Cette option peut être spécifiée plusieurs fois pour ajouter plusieurs répertoires ; les triplets sont résolus en première correspondance par nom.

--x-packages-root=<path>

Remarque

Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.

Spécifie le chemin temporaire d’étape des fichiers de package intermédiaires avant l’installation finale.

La valeur par défaut est packages/ sous le dossier racine vcpkg.

--triplet=<triplet>

Spécifiez le triplet de l’architecture cible.

Valeur par défaut de la variable d’environnement VCPKG_DEFAULT_TRIPLET . Si cela n’est pas défini, déduit en fonction de l’architecture hôte et du système d’exploitation.

Sur les systèmes d’exploitation Windows, l’architecture est toujours déduite comme x86 pour des raisons héritées.

Remarque

Toutes les versions effectuées dans et après septembre 2023 seront par défaut le triplet de l’hôte sur Windows au lieu de x86-windows.

--vcpkg-root=<path>

Spécifie le dossier racine vcpkg.

La valeur par défaut est le répertoire contenant le programme vcpkg. Le répertoire doit être une instance vcpkg valide, telle qu’une git clone instance de https://github.com/microsoft/vcpkg. Cette option peut être utilisée pour exécuter une copie personnalisée de l’outil directement à partir du dossier de build.

Fichiers de réponse (@<file>)

La ligne de commande vcpkg accepte les fichiers texte contenant des paramètres de ligne de commande séparés par des lignes de ligne de commande.

L’outil agit comme si les éléments du fichier ont été splicés dans la ligne de commande à la place de la @ référence. Les fichiers de réponse ne peuvent pas contenir de fichiers de réponse supplémentaires.