Sdílet prostřednictvím

export vcpkg

  • Článek

Synopse

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

Popis

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.

Formáty

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

Experimentální formáty sady SDK (můžou se kdykoli změnit nebo odebrat):

Nezpracovaný adresář

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

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

Obsahuje standardní integrační soubory.

PSČ

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 C++ nástroje MSBuild (.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í:

IFW

Poznámka:

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

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

Exportujte do instalačního programu založeného na ifw.

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

Čokoláda

Poznámka:

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

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

Export balíčku Chocolatey.

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

Montované

Poznámka:

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

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

Export do formátu Prefab

Možnosti specifické pro formátová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.

--dry-run

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

--ifw-configuration-file-path=

Zadejte dočasnou cestu k souboru pro konfiguraci instalačního programu.

--ifw-installer-file-path=

Zadejte cestu k souboru exportovaného instalačního programu.

--ifw-packages-directory-path=

Zadejte dočasnou cestu k adresáři pro znovu zabalené balíčky.

--ifw-repository-directory-path=

Zadejte cestu k adresáři pro exportované úložiště.

--ifw-repository-url=

Zadejte adresu URL vzdáleného úložiště pro online instalační program.

--x-maintainer=

Zadejte správce exportovaného balíčku Chocolatey.

--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 1.0.0je .

--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 vcpkg-export-<date>-<time>je . 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.

--prefab-artifact-id=

ID artefaktu je název projektu podle specifikací Mavenu.

--prefab-group-id=

GroupId jednoznačně identifikuje váš projekt podle specifikací Mavenu.

--prefab-maven

Povolte Maven.

--prefab-min-sdk=

Minimální podporovaná verze sady SDK pro Android

--prefab-target-sdk=

Cílová verze sady SDK pro Android

--prefab-version=

Verze je verze projektu podle specifikací Mavenu.

--x-version-suffix=

Zadejte příponu verze, která se má přidat pro exportovaný balíček Chocolatey.