export vcpkg

Přehled

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

Description

Exportuje sestavené balíčky z nainstalovaného adresáře do samostatné sady SDK pro vývojáře.

export vytváří samostatnou distribuovatelnou sadu SDK (Software Development Kit), kterou lze použít na jiném počítači bez samostatného získání nástroje vcpkg. Obsahuje:

1. Předem připravené binární soubory pro vybrané balíčky
2. Jejich přechodné závislosti
3. Integrační soubory, například sada nástrojů CMake nebo props/targets nástroje MSBuild

Poznámka:

Chování tohoto příkazu se v klasickém režimu a režimu manifestu liší.

Příkaz export neinstaluje žádné balíčky ani tranzitivní závislosti. Exportuje pouze balíčky, které jsou již nainstalovány.

Další podrobnosti najdete v režimu manifestu nebo klasickém režimu .

Klasický režim

V klasickém režimu vcpkg export přijímá argumenty specifikace trojitého balíčku (například: zlib:x64-windows)

Balíčky, které se mají exportovat, zadáte přidáním <port name>:<triplet> argumentů do příkazového řádku.

Pokud chcete například exportovat sqlite balíček pro x64-windows a x64-linuxpoužít:

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

Tento příkaz exportuje zadané balíčky ve formátu ZIP. Obě sqlite:x64-windows a sqlite:x64-linux musí být nainstalovány před spuštěním vcpkg export.

Režim manifestu

V režimu manifestu příkaz exportuje všechny aktuálně nainstalované balíčky. Instalační adresář obsahuje všechny balíčky deklarované v manifestu (vcpkg.json) i jejich tranzitivní závislosti. Před použitím tohoto příkazu se ujistěte vcpkg install , že jsou nainstalované všechny požadované balíčky.

V tomto režimu nemůžete zadat jednotlivé balíčky, které se mají exportovat. Příkaz funguje v celém nainstalovaném stavu jako jedna entita, přičemž respektuje závislosti a verze zadané v souboru manifestu.

Dalším rozdílem je požadavek na --output-dir možnost. Tato možnost určuje adresář, do kterého budou exportované balíčky uloženy.

Například z adresáře manifestu

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

Exportuje všechny aktuálně nainstalované balíčky do .\exports adresáře v souboru ZIP. Možnost --zip určuje, že exportované balíčky by měly být komprimovány do souboru ZIP.

Standardní integrace

Většina formátů exportu obsahuje standardní sadu integračních souborů:

• A CMake toolchain at /scripts/buildsystems/vcpkg.cmake
• Props/cíle nástroje MSBuild v /scripts/buildsystems/msbuild/vcpkg.props a /scripts/buildsystems/msbuild/vcpkg.targets
• Instalační strom na adrese/

Některé formáty exportu se liší od této standardní sady; Další podrobnosti najdete v nápovědě k jednotlivým formátům níže.

Formats

Oficiálně podporované formáty sady SDK:

• Nezpracovaný adresář
• Zip
• 7zip
• NuGet

Nezpracovaný adresář

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

Vytvořte nekomprimované rozložení adresáře na adrese <output-dir>/<output>/.

Obsahuje standardní integrační soubory.

ZIP

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

Vytvořte komprimované rozložení adresáře zip na adrese <output-dir>/<output>.zip.

Obsahuje standardní integrační soubory.

7Zip

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

Vytvořte rozložení adresáře 7zip na adrese <output-dir>/<output>.7z.

Obsahuje standardní integrační soubory.

NuGet

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

Vytvořte balíček NuGet na adrese <output-dir>/<nuget-id>.<nuget-version>.nupkg.

Obsahuje standardní integrační soubory a další integraci NÁSTROJE MSBuild pro podporu zahrnutí do projektu MSBuild C++ (.vcxproj) prostřednictvím Správce balíčků NuGet. Všimněte si, že nemůžete kombinovat více balíčků NuGet vytvořených společně export – použije se pouze jeden z balíčků. Pokud chcete přidat další knihovny, musíte vytvořit nový export s úplnou sadou závislostí.

Možnosti specifické pro formátování:

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

IFW

Export IFW byl odebrán.

Chocolatey

Export čokolády byl odebrán.

Prefabrikovaný

Předfab export byl odebrán.

Možnosti

Všechny příkazy vcpkg podporují sadu běžných možností.

<package>

Toto je seznam sestavených balíčků nejvyšší úrovně, které budou součástí sady SDK. Všechny závislosti těchto balíčků budou také zahrnuty, aby se zajistilo, že výsledná sada SDK je samostatná.

Syntaxe balíčku

<port name>:<triplet>

Odkazy na balíčky bez tripletu jsou automaticky kvalifikované ve výchozím cílovém trojitém nastavení. Poznámka: <port name>:<triplet> Argumenty nejsou povoleny při použití vcpkg export v režimu manifestu.

--x-all-installed

Poznámka:

Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.

Exportujte všechny nainstalované balíčky. Tato možnost se předpokládá při použití vcpkg export v režimu manifestu.

--dereference-symlinks

Zkopíruje v exportovaných výsledcích symlinky jako běžné soubory a adresáře.

--dry-run

Neprovádějte export, vytiskněte pouze plán exportu.

--nuget-description=

Určuje popis výstupu pro soubory NuGet .nupkg.

Výchozí hodnota je export NuGet Vcpkg.

--nuget-id=

Určuje id výstupu pro soubory NuGet .nupkg.

Tato možnost přepíše --output možnost speciálně pro vývozce NuGet. Podívejte se --output na výchozí hodnoty.

--nuget-version=

Určuje výstupní verzi pro soubory NuGet .nupkg.

Výchozí hodnota je 1.0.0.

--output=

Určuje název výstupního základu.

Každý typ sady SDK používá tento základní název k určení konkrétních výstupních souborů. Podrobnosti najdete v dokumentaci specifické pro sadu SDK výše.

Výchozí hodnota je vcpkg-export-<date>-<time>. Skriptované použití export by mělo vždy předat tento příznak, aby se zajistil deterministický výstup.

--output-dir=

Určuje výstupní adresář.

V tomto adresáři se vytvoří všechny soubory sady SDK nejvyšší úrovně. Tato možnost se vyžaduje v režimu manifestu. V klasickém režimu je to volitelné a výchozí nastavení kořenového adresáře vcpkg.