vcpkg installeren

Samenvatting

• klassieke modus

vcpkg install [options] <package>...

• manifestmodus

vcpkg install [options]

Beschrijving

Bouw en installeer poortpakketten.

Klassieke modus

In klassieke modusvoegt dit werkwoord poortpakketten toe aan de bestaande set in de geïnstalleerde map (standaard ingesteld op installed/ onder de vcpkg-hoofdmap). Hiervoor kunnen bestaande pakketten worden verwijderd en opnieuw worden opgebouwd. Dit kan mislukken.

Pakketsyntaxis

portname[feature1,feature2]:triplet

Pakketverwijzingen zonder een triplet worden automatisch gekwalificeerd door de standaard doel drievoudige. Pakketverwijzingen die niet expliciet worden vermeld core worden beschouwd als alle standaardfuncties.

Manifestmodus

In manifestmoduswordt met deze opdracht de geïnstalleerde map ingesteld op de status die is opgegeven door het vcpkg.json manifestbestand, het toevoegen, verwijderen of herbouwen van pakketten indien nodig.

Opties

Alle vcpkg-opdrachten ondersteunen een set algemene opties.

--allow-unsupported

In plaats van op een niet-ondersteunde poort te stoppen, gaat u verder met een waarschuwing.

Vcpkg weigert standaard een installatieplan uit te voeren met een poortinstallatie voor een triplet buiten de "supports" component. De "supports" component van een pakket beschrijft de volledige set platforms waarop een pakket kan worden gebouwd. Met deze vlag wordt vcpkg geïnstrueerd om te waarschuwen dat de build naar verwachting mislukt in plaats van te stoppen.

--clean-after-build

Schone buildtrees, pakketten en downloads na het bouwen van elk pakket.

Deze optie heeft hetzelfde effect als het doorgeven van --clean-buildtrees-after-build, --clean-downloads-after-builden --clean-packages-after-build.

--clean-buildtrees-after-build

Schoon alle submappen van de tijdelijke submap buildtrees op na het bouwen van elk pakket.

Alle bestanden op het hoogste niveau in de submap buildtrees (bijvoorbeeld buildtrees/zlib/config-x64-windows-out.log) worden bewaard. Alle submappen worden verwijderd.

--clean-downloads-after-build

Schoon alle niet-opgehaalde assets uit de map downloads/ op nadat u elk pakket hebt gemaakt.

Alle bestanden op het hoogste niveau in de map downloads/ worden verwijderd. Geëxtraheerde hulpprogramma's worden bewaard.

--clean-packages-after-build

Schoon de tijdelijke submap van de pakketten op nadat u elk pakket hebt gebouwd.

De submap pakketten voor het ingebouwde pakket (bijvoorbeeld packages/zlib_x64-windows) wordt na de installatie verwijderd.

--dry-run

Druk het installatieplan af, maar verwijder of installeer geen pakketten.

Het installatieplan bevat alle pakketten en functies die worden geïnstalleerd, evenals eventuele andere pakketten die moeten worden verwijderd en opnieuw moeten worden opgebouwd.

--editable

• klassieke modus

Bewerkbare builds uitvoeren voor alle rechtstreeks verwezen pakketten op de opdrachtregel.

Wanneer vcpkg poorten bouwt, wordt de broncode telkens verwijderd en opnieuw geëxtraheerd om ervoor te zorgen dat de invoer nauwkeurig is. Dit is nodig voor de manifestmodus om nauwkeurig bij te werken wat is geïnstalleerd en voor binaire caching om ervoor te zorgen dat inhoud in de cache juist is.

Als u de vlag --editable doorgeeft, wordt dit gedrag uitgeschakeld, waarbij bewerkingen worden bewaard in de geëxtraheerde bronnen in de map buildtrees/. Dit helpt bij het snel ontwikkelen van patches door te voorkomen dat u bij elke wijziging een bestand hoeft te schrijven.

Bronnen die tijdens een bewerkbare build zijn geëxtraheerd, hebben geen .clean/ achtervoegsel op de mapnaam en worden niet gewist door volgende niet-bewerkbare builds.

--enforce-port-checks

Mislukte installatie als een poort problemen heeft gedetecteerd of probeert een afgeschafte functie te gebruiken.

Vcpkg voert standaard verschillende controles uit op ingebouwde pakketten en verzendt waarschuwingen als er problemen worden gedetecteerd. Met deze vlag worden deze waarschuwingen bijgewerkt naar een fout.

--x-feature=<feature>

Notitie

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

• manifestmodus alleen

Geef een extra functie op uit de vcpkg.json om afhankelijkheden voor te installeren.

Standaard worden alleen "dependencies" en de afhankelijkheden van "default-features" geïnstalleerd.

--head

• klassieke modus

Vraag alle pakketten expliciet naar de opdrachtregel om de meest recente bronnen op te halen die beschikbaar zijn bij het bouwen.

Deze vlag is alleen bedoeld voor tijdelijke tests en is niet bedoeld voor productie of langdurig gebruik. Hierdoor wordt binaire cache uitgeschakeld voor alle expliciet genoemde pakketten en hun afhankelijke pakketten, omdat vcpkg niet alle invoer nauwkeurig kan bijhouden.

--keep-going

Ga door met het installatieplan na de eerste fout.

Standaard stopt vcpkg bij de eerste buildfout van het pakket. Met deze vlag wordt vcpkg geïnstrueerd om door te gaan met het bouwen en installeren van andere onderdelen van het installatieplan die niet afhankelijk zijn van het mislukte pakket.

--x-no-default-features

Notitie

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

• manifestmodus alleen

Installeer de standaardfuncties niet vanuit het manifest op het hoogste niveau.

Wanneer u install gebruikt in de manifestmodus, worden standaard alle afhankelijkheden van de functies die worden vermeld in "default-features" geïnstalleerd. Met deze vlag wordt dat gedrag uitgeschakeld, zodat alleen functies die expliciet door --x-feature worden ingeschakeld, worden geïnstalleerd.

--no-downloads

Wanneer u een pakket bouwt, voorkomt u dat poorten nieuwe assets downloaden tijdens de build.

Standaard verkrijgen poorten broncode en hulpprogramma's op aanvraag van internet (afhankelijk van assetcaching). Met deze parameter worden downloads geblokkeerd en worden poorten beperkt tot alleen de assets die eerder op de computer zijn gedownload en in de cache zijn opgeslagen.

--only-downloads

Probeer alle assets te downloaden die vereist zijn voor een installatieplan zonder builds uit te voeren.

Wanneer deze optie is doorgegeven, voert vcpkg elke build in het plan uit totdat de eerste niet-downloadende externe procesoproep wordt uitgevoerd. De meeste poorten voeren alle downloads uit vóór de eerste aanroep van het externe proces (meestal naar hun buildsysteem), dus met deze procedure worden alle vereiste assets gedownload. Poorten die niet aan deze procedure voldoen, hebben hun assets niet vooraf gedownload.

--only-binarycaching

Weigeren om builds uit te voeren. Herstel alleen pakketten uit binaire caches.

Deze vlag blokkeert vcpkg van het uitvoeren van builds op aanvraag en mislukt als een pakket niet kan worden gevonden in binaire caches.

--recurse

• klassieke modus

Een installatieplan goedkeuren waarvoor herbouwing van pakketten is vereist.

Als u de set functies van een geïnstalleerd pakket wilt wijzigen, moet vcpkg dat pakket verwijderen en herbouwen. Omdat dit het potentieel heeft dat de installatiestructuur mislukt en de installatiestructuur met minder pakketten verlaat dan de gebruiker is gestart, moet de gebruiker plannen goedkeuren waarmee pakketten opnieuw worden opgebouwd door deze vlag door te geven.

--x-write-nuget-packages-config

Notitie

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

Hiermee schrijft u een NuGet-packages.config-geformatteerd bestand voor gebruik met binaire caching.

Deze optie kan worden gebruikt in combinatie met --dry-run om de lijst met NuGet-pakketten te verkrijgen die vereist zijn voor binaire caching zonder pakketten te bouwen of te installeren. Hierdoor kan de NuGet-opdrachtregel afzonderlijk worden aangeroepen voor geavanceerde scenario's, zoals het gebruik van alternatieve protocollen om de .nupkg bestanden te verkrijgen.

--no-print-usage

Het genereren van gebruikstekst onderdrukken die aan het einde van de installatie wordt afgedrukt.