Share via

Exportation vcpkg

  • Article

Synopsis

vcpkg export [options] {<package>... | --x-all-installed}

Description

Exporte des packages générés à partir du répertoire installé dans un Kit de développement logiciel (SDK) de développeur autonome.

export produit un SDK autonome et distribuable (Kit de développement logiciel) qui peut être utilisé sur un autre ordinateur sans acquérir séparément vcpkg. Il contient :

  1. Fichiers binaires prédéfinis pour les packages sélectionnés
  2. Leurs dépendances transitives
  3. Fichiers d’intégration, tels qu’une chaîne d’outils CMake ou des propriétés/cibles MSBuild

Remarque

Le comportement de cette commande est différent en mode classique et en mode manifeste

La export commande n’installe pas de packages ni de dépendances transitives. Il exporte uniquement les packages déjà installés.

Pour plus d’informations, consultez le mode manifeste ou le mode classique.

Mode classique

En mode classique, vcpkg export accepte les arguments de spécification de package triplet qualifiés (par exemple : zlib:x64-windows)

Vous spécifiez des packages à exporter en ajoutant <port name>:<triplet> des arguments à la ligne de commande.

Par exemple, pour exporter le sqlite package pour x64-windows et pour utiliser x64-linux:

vcpkg export sqlite:x64-windows sqlite:x64-linux --zip

Cette commande exporte les packages spécifiés au format zip. Les deux sqlite:x64-windows doivent sqlite:x64-linux être installés avant l’exécution vcpkg export.

Mode manifeste

En mode manifeste, la commande exporte tous les packages actuellement installés. Le répertoire d’installation inclut tous les packages déclarés dans le manifeste (vcpkg.json) ainsi que leurs dépendances transitives. Exécutez vcpkg install avant d’utiliser cette commande pour vous assurer que tous les packages requis sont installés.

Dans ce mode, vous ne pouvez pas spécifier de packages individuels à exporter. La commande fonctionne sur l’ensemble de l’état installé en tant qu’entité unique, en respectant les dépendances et versions spécifiées dans le fichier manifeste.

Une autre différence est l’exigence de l’option --output-dir . Cette option spécifie le répertoire dans lequel les packages exportés seront stockés.

Par exemple, à partir du répertoire du manifeste

vcpkg export --zip --output-dir=.\exports

Exporte tous les packages actuellement installés dans le .\exports répertoire dans un fichier zip. L’option --zip spécifie que les packages exportés doivent être compressés dans un fichier zip.

Intégration standard

La plupart des formats d’exportation contiennent un ensemble standard de fichiers d’intégration :

  • Chaîne d’outils CMake à l’adresse/scripts/buildsystems/vcpkg.cmake
  • Propriétés/cibles MSBuild à et /scripts/buildsystems/msbuild/vcpkg.props/scripts/buildsystems/msbuild/vcpkg.targets
  • Arborescence d’installation à l’adresse/

Certains formats d’exportation diffèrent de cet ensemble standard ; pour plus d’informations, consultez l’aide sur le format individuel ci-dessous.

Formats

Formats du Kit de développement logiciel (SDK) officiellement pris en charge :

Formats du Kit de développement logiciel (SDK expérimental) (peuvent changer ou être supprimés à tout moment) :

Répertoire brut

vcpkg export --raw [options] <package>...

Créez une disposition de répertoire non compressée à l’adresse <output-dir>/<output>/.

Contient les fichiers d’intégration standard.

Compresser

vcpkg export --zip [options] <package>...

Créez une disposition de répertoire compressé zip à l’adresse <output-dir>/<output>.zip.

Contient les fichiers d’intégration standard.

7Zip

vcpkg export --7zip [options] <package>...

Créez une disposition de répertoire 7zip à l’adresse <output-dir>/<output>.7z.

Contient les fichiers d’intégration standard.

NuGet

vcpkg export --nuget [options] <package>...

Créez un package NuGet à l’adresse <output-dir>/<nuget-id>.<nuget-version>.nupkg.

Contient les fichiers d’intégration Standard ainsi que l’intégration MSBuild supplémentaire pour prendre en charge l’inclusion dans un projet MSBuild C++ (.vcxproj) via le Gestionnaire de package NuGet. Notez que vous ne pouvez pas combiner plusieurs packages NuGet générés avec export un seul des packages. Pour ajouter des bibliothèques supplémentaires, vous devez créer une exportation avec l’ensemble complet de dépendances.

Mettre en forme des options spécifiques :

IFW

Remarque

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

vcpkg export --ifw [options] <package>...

Exporter vers un programme d’installation basé sur IFW.

Mettre en forme des options spécifiques :

Chocolatey

Remarque

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

vcpkg export --x-chocolatey [options] <package>...

Exportez un package chocolaté.

Mettre en forme des options spécifiques :

Préfabriqué

Remarque

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

vcpkg export --prefab [options] <package>...

Exporter au format Prefab.

Mettre en forme des options spécifiques :

Options

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

<package>

Il s’agit de la liste des packages intégrés de niveau supérieur qui seront inclus dans le Kit de développement logiciel (SDK). Toutes les dépendances de ces packages seront également incluses pour s’assurer que le KIT de développement logiciel (SDK) obtenu est autonome.

Syntaxe du package

<port name>:<triplet>

Les références de package sans triplet sont automatiquement qualifiées par le triplet cible par défaut. Remarque : <port name>:<triplet> les arguments ne sont pas autorisés lors de l’utilisation vcpkg export en mode manifeste.

--x-all-installed

Remarque

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

Exportez tous les packages installés. Cette option est implicite lors de l’utilisation vcpkg export en mode manifeste.

--dry-run

N’effectuez pas l’exportation, imprimez uniquement le plan d’exportation.

--ifw-configuration-file-path=

Spécifiez le chemin d’accès du fichier temporaire pour la configuration du programme d’installation.

--ifw-installer-file-path=

Spécifiez le chemin d’accès du fichier pour le programme d’installation exporté.

--ifw-packages-directory-path=

Spécifiez le chemin d’accès du répertoire temporaire pour les packages repacked.

--ifw-repository-directory-path=

Spécifiez le chemin d’accès au répertoire du référentiel exporté.

--ifw-repository-url=

Spécifiez l’URL de dépôt distant pour le programme d’installation en ligne.

--x-maintainer=

Spécifiez le responsable de maintenance pour le package Chocolatey exporté.

--nuget-description=

Spécifie la description de sortie pour les fichiers NuGet .nupkg.

La valeur par défaut est « Exportation NuGet Vcpkg ».

--nuget-id=

Spécifie l’ID de sortie pour les fichiers NuGet .nupkg.

Cette option remplace l’option --output spécifiquement pour l’exportateur NuGet. Consultez --output les valeurs par défaut.

--nuget-version=

Spécifie la version de sortie pour les fichiers NuGet .nupkg.

La valeur par défaut est 1.0.0.

--output=

Spécifie le nom de base de sortie.

Chaque type de sdk utilise ce nom de base pour déterminer ses fichiers de sortie spécifiques. Pour plus d’informations, consultez la documentation spécifique au KIT SDK ci-dessus.

La valeur par défaut est vcpkg-export-<date>-<time>. L’utilisation par script de export doit toujours passer cet indicateur pour garantir une sortie déterministe.

--output-dir=

Indique le répertoire de sortie.

Tous les fichiers sdk de niveau supérieur seront générés dans ce répertoire. Cette option est requise en mode manifeste. En mode classique, il s’agit de valeurs facultatives et par défaut dans le répertoire racine vcpkg.

--prefab-artifact-id=

L’ID d’artefact est le nom du projet en fonction des spécifications Maven.

--prefab-group-id=

GroupId identifie de façon unique votre projet en fonction des spécifications Maven.

--prefab-maven

Activez Maven.

--prefab-min-sdk=

Version minimale prise en charge du Kit de développement logiciel (SDK) Android.

--prefab-target-sdk=

Version du Kit de développement logiciel (SDK) prise en charge par Android.

--prefab-version=

La version est la version du projet en fonction des spécifications Maven.

--x-version-suffix=

Spécifiez le suffixe de version à ajouter pour le package Chocolatey exporté.