Installation de vcpkg

Synopsis

• Mode classique

vcpkg install [options] <package>...

• Mode manifeste

vcpkg install [options]

Description

Générez et installez des packages de port.

Mode classique

En mode Classique, ce verbe ajoute des packages de port au jeu existant dans le répertoire installé (par défaut installed/ sous la racine vcpkg). Cela peut nécessiter la suppression et la reconstruction de packages existants, ce qui peut échouer.

Syntaxe du package

portname[feature1,feature2]:triplet

Les références de package sans triplet sont automatiquement qualifiées par le triplet cible par défaut. Les références de package qui ne sont pas explicitement listée core sont considérées comme impliquant toutes les fonctionnalités par défaut.

Mode manifeste

En mode manifeste, cette commande définit le répertoire installé sur l’état spécifié par le vcpkg.json fichier manifeste, en ajoutant, en supprimant ou en régénéré des packages selon les besoins.

Options

Toutes les commandes vcpkg prennent en charge un ensemble d’options courantes.

--allow-unsupported

Au lieu d’arrêter sur un port non pris en charge, poursuivez avec un avertissement.

Par défaut, vcpkg refuse d’exécuter un plan d’installation contenant une installation de port pour un triplet en dehors de sa "supports" clause. La "supports" clause d’un package décrit l’ensemble complet de plateformes sur lesquelles un package doit être généré. Cet indicateur indique à vcpkg d’avertir que la build est censée échouer au lieu de s’arrêter.

--clean-after-build

Nettoyez les arborescences de build, les packages et les téléchargements après avoir généré chaque package.

Cette option a le même effet que le passage --clean-buildtrees-after-build, --clean-downloads-after-buildet --clean-packages-after-build.

--clean-buildtrees-after-build

Nettoyez tous les sous-répertoires du sous-dossier temporaire buildtrees après avoir généré chaque package.

Tous les fichiers de niveau supérieur dans le sous-dossier buildtrees (par exemple buildtrees/zlib/config-x64-windows-out.log) sont conservés. Tous les sous-répertoires seront supprimés.

--clean-downloads-after-build

Nettoyez toutes les ressources nontracées du downloads/ dossier après avoir généré chaque package.

Tous les fichiers de niveau supérieur du downloads/ dossier seront supprimés. Les outils extraits seront conservés.

--clean-packages-after-build

Nettoyez le sous-dossier temporaire des packages après avoir généré chaque package.

Le sous-dossier des packages pour le package généré (par exemple, packages/zlib_x64-windows) est supprimé après l’installation.

--dry-run

Imprimez le plan d’installation, mais ne supprimez ni n’installez aucun package.

Le plan d’installation répertorie tous les packages et fonctionnalités qui seront installés, ainsi que les autres packages qui doivent être supprimés et reconstruits.

--editable

• Mode classique uniquement

Effectuez des builds modifiables pour tous les packages directement référencés sur la ligne de commande.

Lorsque vcpkg génère des ports, il purge et extrait à nouveau le code source chaque fois pour garantir que les entrées sont exactement. Cela est nécessaire pour que le mode manifeste met à jour avec précision ce qui est installé et pour la mise en cache binaire afin de garantir que le contenu mis en cache est correct.

Le passage de l’indicateur --editable désactive ce comportement, en préservant les modifications des sources extraites dans le buildtrees/ dossier. Cela permet de développer rapidement des correctifs en évitant la nécessité d’écrire un fichier sur chaque modification.

Les sources extraites pendant une build modifiable n’ont pas de .clean/ suffixe sur le nom du répertoire et ne seront pas effacées par les builds non modifiables suivantes.

--enforce-port-checks

Échec de l’installation si un port a détecté des problèmes ou tente d’utiliser une fonctionnalité déconseillée.

Par défaut, vcpkg exécute plusieurs case activée sur des packages générés et émet des avertissements si des problèmes sont détectés. Cet indicateur met à niveau ces avertissements vers une erreur.

--x-feature=<feature>

Remarque

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

• Mode manifeste uniquement

Spécifiez une fonctionnalité supplémentaire à partir de l’installation vcpkg.json des dépendances pour.

Par défaut, seules "dependencies" les dépendances sont "default-features" installées.

--head

• Mode classique uniquement

Demandez à tous les packages explicitement référencés sur la ligne de commande d’extraire les sources les plus récentes disponibles lors de la génération.

Cet indicateur est destiné uniquement aux tests temporaires et n’est pas destiné à une utilisation à long terme ou en production. Cela désactive la mise en cache binaire pour tous les packages référencés explicitement et leurs dépendants, car vcpkg ne peut pas suivre avec précision toutes les entrées.

--keep-going

Poursuivez le plan d’installation après le premier échec.

Par défaut, vcpkg s’arrête lors de la première défaillance de build du package. Cet indicateur indique à vcpkg de continuer à générer et à installer d’autres parties du plan d’installation qui ne dépendent pas du package ayant échoué.

--x-no-default-features

Remarque

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

• Mode manifeste uniquement

N’installez pas les fonctionnalités par défaut à partir du manifeste de niveau supérieur.

Lors de l’utilisation install en mode Manifeste, toutes les dépendances des fonctionnalités répertoriées par "default-features" défaut sont installées. Cet indicateur désactive ce comportement de sorte que seules les fonctionnalités explicitement activées par --x-feature seront installées.

--no-downloads

Lors de la génération d’un package, empêchez les ports de télécharger de nouvelles ressources pendant la build.

Par défaut, les ports acquiert le code source et les outils à la demande à partir d’Internet (soumis à la mise en cache des ressources). Ce paramètre bloque les téléchargements et limite les ports aux ressources précédemment téléchargées et mises en cache sur l’ordinateur.

--only-downloads

Essayez de télécharger toutes les ressources requises pour un plan d’installation sans exécuter de builds.

Une fois cette option passée, vcpkg exécute chaque build dans le plan jusqu’à ce qu’elle effectue son premier appel de processus externe sans téléchargement. La plupart des ports effectuent tous les téléchargements avant le premier appel de processus externe (généralement vers leur système de génération), de sorte que cette procédure télécharge toutes les ressources requises. Les ports qui ne suivent pas cette procédure n’ont pas leurs ressources préchargées.

--only-binarycaching

Refusez d’effectuer des builds. Restaurez uniquement les packages à partir de caches binaires.

Cet indicateur empêche vcpkg d’effectuer des builds à la demande et échoue si un package est introuvable dans les caches binaires.

--recurse

• Mode classique uniquement

Approuvez un plan d’installation qui nécessite la reconstruction de packages.

Pour modifier l’ensemble des fonctionnalités d’un package installé, vcpkg doit supprimer et reconstruire ce package. Étant donné que cela risque d’échouer et de quitter l’arborescence d’installation avec moins de packages que l’utilisateur a démarré, l’utilisateur doit approuver les plans qui régénérez les packages en transmettant cet indicateur.

--x-use-aria2

Remarque

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

Utilisez aria2 pour effectuer des tâches de téléchargement.

--x-write-nuget-packages-config

Remarque

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

Écrit un fichier nuGet au format nuget packages.configà utiliser avec la mise en cache binaire.

Cette option peut être utilisée conjointement avec --dry-run pour obtenir la liste des packages NuGet requis à partir de la mise en cache binaire sans générer ou installer de packages. Cela permet à la ligne de commande NuGet d’être appelée séparément pour les scénarios avancés, comme l’utilisation de protocoles alternatifs pour acquérir les .nupkg fichiers.

--no-print-usage

Supprimez la génération de texte d’utilisation imprimé à la fin de l’installation.