Delen via

vcpkg-export

Samenvatting

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

Description

Hiermee exporteert u ingebouwde pakketten uit de geïnstalleerde map naar een zelfstandige ontwikkelaars-SDK.

export produceert een zelfstandige, distribueerbare SDK (Software Development Kit) die op een andere computer kan worden gebruikt zonder afzonderlijk vcpkg te verkrijgen. Het bevat:

  1. De vooraf gemaakte binaire bestanden voor de geselecteerde pakketten
  2. Hun transitieve afhankelijkheden
  3. Integratiebestanden, zoals een CMake-toolchain of MSBuild props/targets

Opmerking

Het gedrag van deze opdracht verschilt in de klassieke modus en de manifestmodus

Met de export opdracht worden geen pakketten of transitieve afhankelijkheden geïnstalleerd. Er worden alleen pakketten geëxporteerd die al zijn geïnstalleerd.

Raadpleeg de manifestmodus of de klassieke modus voor meer informatie.

Klassieke modus

In de klassieke modus vcpkg export accepteert u drievoudig gekwalificeerde pakketspecificatieargumenten (bijvoorbeeld: zlib:x64-windows)

U geeft pakketten op die moeten worden geëxporteerd door argumenten toe te voegen <port name>:<triplet> aan de opdrachtregel.

Als u bijvoorbeeld het sqlite pakket wilt exporteren voor x64-windows en x64-linux, gebruikt u:

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

Met deze opdracht exporteert u de opgegeven pakketten in zip-indeling. Beide sqlite:x64-windows en sqlite:x64-linux moeten worden geïnstalleerd voordat deze wordt uitgevoerd vcpkg export.

Manifestmodus

In de manifestmodus exporteert de opdracht alle momenteel geïnstalleerde pakketten. De installatiemap bevat alle pakketten die zijn gedeclareerd in het manifest (vcpkg.json) en hun transitieve afhankelijkheden. Voer vcpkg install deze opdracht uit voordat u deze opdracht gebruikt om ervoor te zorgen dat alle vereiste pakketten zijn geïnstalleerd.

In deze modus kunt u geen afzonderlijke pakketten opgeven die moeten worden geëxporteerd. De opdracht werkt op de volledige geïnstalleerde status als één entiteit, waarbij de afhankelijkheden en versies die zijn opgegeven in het manifestbestand, worden gerespecteerd.

Een ander verschil is de vereiste van de --output-dir optie. Met deze optie geeft u de map op waarin de geëxporteerde pakketten worden opgeslagen.

Bijvoorbeeld vanuit de manifestmap

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

Hiermee exporteert u alle momenteel geïnstalleerde pakketten naar de .\exports map in een zip-bestand. De --zip optie geeft aan dat de geëxporteerde pakketten moeten worden gecomprimeerd in een zip-bestand.

Standaardintegratie

De meeste exportindelingen bevatten een standaardset integratiebestanden:

Sommige exportindelingen verschillen van deze standaardset; zie de help voor afzonderlijke indelingen hieronder voor meer informatie.

Formats

Officieel ondersteunde SDK-indelingen:

Onbewerkte map

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

Maak een niet-gecomprimeerde mapindeling op <output-dir>/<output>/.

Bevat de standaardintegratiebestanden.

Ritssluiting

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

Maak een gecomprimeerde zip-mapindeling op <output-dir>/<output>.zip.

Bevat de standaardintegratiebestanden.

7Zip

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

Maak een mapindeling met 7zip op <output-dir>/<output>.7z.

Bevat de standaardintegratiebestanden.

NuGet

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

Maak een NuGet-pakket op <output-dir>/<nuget-id>.<nuget-version>.nupkg.

Bevat de Standard Integration Files en aanvullende MSBuild-integratie ter ondersteuning van opname in een MSBuild C++-project (.vcxproj) via NuGet Package Manager. U kunt niet meerdere NuGet-pakketten combineren die samen export worden geproduceerd. Er wordt slechts één van de pakketten gebruikt. Als u extra bibliotheken wilt toevoegen, moet u een nieuwe export maken met de volledige set afhankelijkheden.

Specifieke opties opmaken:

ALSW

IFW-export is verwijderd.

Chocolatey

Chocolatey export is verwijderd.

Prefab

Prefab-export is verwijderd.

Options

Alle vcpkg-opdrachten ondersteunen een set algemene opties.

<package>

Dit is de lijst met op het hoogste niveau gebouwde pakketten die worden opgenomen in de SDK. Afhankelijkheden van deze pakketten worden ook opgenomen om ervoor te zorgen dat de resulterende SDK zelfstandig is.

Pakketsyntaxis

<port name>:<triplet>

Pakketverwijzingen zonder een triplet worden automatisch gekwalificeerd met de standaard doel-triplet. Opmerking: <port name>:<triplet> argumenten zijn niet toegestaan bij gebruik vcpkg export in de manifestmodus.

--x-all-installed

Opmerking

In deze sectie wordt een experimentele functie van vcpkg behandeld die op elk gewenst moment kan worden gewijzigd of verwijderd.

Alle geïnstalleerde pakketten exporteren. Deze optie wordt geïmpliceerd bij gebruik vcpkg export in de manifestmodus.

--dereference-symlinks

Kopieert symlinks als gewone bestanden en mappen in de geëxporteerde resultaten.

--dry-run

Voer de export niet uit, druk alleen het exportplan af.

--nuget-description=

Hiermee geeft u de uitvoerbeschrijving voor NuGet .nupkg-bestanden.

De standaardwaarde is 'Vcpkg NuGet-export'.

--nuget-id=

Hiermee geeft u de uitvoer-id voor NuGet.nupkg-bestanden.

Met deze optie wordt de optie voor de --output NuGet-exporteur overschreven. Zie --output voor standaardwaarden.

--nuget-version=

Hiermee geeft u de uitvoerversie voor NuGet .nupkg-bestanden.

Standaardwaarde is 1.0.0.

--output=

Hiermee geeft u de naam van de uitvoerbasis.

Elk SDK-type gebruikt deze basisnaam om de specifieke uitvoerbestanden te bepalen. Zie de SDK-specifieke documentatie hierboven voor meer informatie.

Standaardwaarde is vcpkg-export-<date>-<time>. Het gebruik van export scripts moet altijd deze vlag doorgeven om deterministische uitvoer te garanderen.

--output-dir=

Hiermee geeft u de uitvoermap.

Alle SDK-bestanden op het hoogste niveau worden in deze map geproduceerd. Deze optie is vereist in de manifestmodus. In de klassieke modus is dit optioneel en wordt standaard ingesteld op de vcpkg-hoofdmap.

  • Last updated on