Exportation de vcpkg

Synopsis

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

Descriptif

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

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 :

• Répertoire brut
• Zip
• 7zip
• NuGet

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.

Code postal

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 :

• --nuget-id
• --nuget-version
• --nuget-description

IFW

L’exportation IFW a été supprimée.

Chocolaté

L’exportation chocolatée a été supprimée.

Préfabriqué

L’exportation de préfabriqué a été supprimée.

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

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

--dereference-symlinks

Copie les liens symboliques en tant que fichiers et répertoires réguliers dans les résultats exportés.

--dry-run

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

--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=

Spécifie 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.