Dela via

Installera vcpkg

  • Artikel

Sammanfattning

  • klassiskt läge
vcpkg install [options] <package>...
  • manifestläge
vcpkg install [options]

Beskrivning

Skapa och installera portpaket.

Klassiskt läge

I klassiskt lägelägger det här verbet till portpaket till den befintliga uppsättningen i den installerade katalogen (standardvärdet är installed/ under vcpkg-roten). Detta kan kräva att befintliga paket tas bort och återskapas, vilket kan misslyckas.

Paketsyntax

portname[feature1,feature2]:triplet

Paketreferenser utan trilling kvalificeras automatiskt av standardmåltrilling. Paketreferenser som inte uttryckligen visar core anses innebära alla standardfunktioner.

Manifestläge

I manifestlägeanger det här kommandot den installerade katalogen till det tillstånd som anges av vcpkg.json manifestfil, lägger till, tar bort eller återskapar paket efter behov.

Alternativ

Alla vcpkg-kommandon stöder en uppsättning vanliga alternativ.

--allow-unsupported

Fortsätt med en varning i stället för att stanna på en port som inte stöds.

Som standard vägrar vcpkg att köra en installationsplan som innehåller en portinstallation för en trilling utanför dess "supports"-sats. "supports"-satsen i ett paket beskriver den fullständiga uppsättningen plattformar som ett paket förväntas kunna byggas på. Den här flaggan instruerar vcpkg att varna för att bygget förväntas misslyckas i stället för att stoppas.

--clean-after-build

Rensa buildtrees, paket och nedladdningar när du har skapat varje paket.

Det här alternativet har samma effekt som att skicka --clean-buildtrees-after-build, --clean-downloads-after-buildoch --clean-packages-after-build.

--clean-buildtrees-after-build

Rensa alla underkataloger från den tillfälliga undermappen buildtrees när du har skapat varje paket.

Alla filer på den översta nivån i undermappen buildtrees (t.ex. buildtrees/zlib/config-x64-windows-out.log) behålls. Alla underkataloger tas bort.

--clean-downloads-after-build

Rensa alla oextraherade tillgångar från mappen downloads/ när du har skapat varje paket.

Alla filer på den översta nivån i mappen downloads/ tas bort. Extraherade verktyg behålls.

--clean-packages-after-build

Rensa paketens temporära undermapp när du har skapat varje paket.

Paketundermappen för det byggda paketet (till exempel packages/zlib_x64-windows) tas bort efter installationen.

--dry-run

Skriv ut installationsplanen, men ta inte bort eller installera inga paket.

Installationsplanen visar en lista över alla paket och funktioner som ska installeras, samt alla andra paket som behöver tas bort och återskapas.

--editable

  • klassiskt läge endast

Utför redigerbara versioner för alla direkt refererade paket på kommandoraden.

När vcpkg skapar portar rensas och extraheras källkoden igen varje gång för att säkerställa att indata är korrekta. Detta är nödvändigt för att manifestläget ska kunna uppdatera det som är installerat och för binär cachelagring för att säkerställa att cachelagrat innehåll är korrekt.

Om du skickar flaggan --editable inaktiveras det här beteendet, vilket bevarar redigeringar till de extraherade källorna i mappen buildtrees/. Detta hjälper dig att snabbt utveckla korrigeringar genom att undvika behovet av att skriva en fil om varje ändring.

Källor som extraheras under en redigerbar version har inte ett .clean/ suffix på katalognamnet och rensas inte av efterföljande icke-redigerbara versioner.

--enforce-port-checks

Det gick inte att installera om en port har identifierat problem eller försöker använda en inaktuell funktion.

Som standard kör vcpkg flera kontroller på byggda paket och avger varningar om några problem identifieras. Den här flaggan uppgraderar varningarna till ett fel.

--x-feature=<feature>

Not

Det här avsnittet beskriver en experimentell funktion av vcpkg som kan ändras eller tas bort när som helst.

  • endast

Ange ytterligare en funktion från vcpkg.json att installera beroenden för.

Som standard installeras endast "dependencies" och beroenden för "default-features".

--head

  • klassiskt läge endast

Begär att alla paket som uttryckligen refereras till på kommandoraden hämtar de senaste tillgängliga källorna när du skapar.

Den här flaggan är endast avsedd för tillfällig testning och är inte avsedd för produktion eller långvarig användning. Detta inaktiverar binär cachelagring för alla explicit refererade paket och deras beroenden eftersom vcpkg inte kan spåra alla indata korrekt.

--keep-going

Fortsätt installationsplanen efter det första felet.

Som standard stoppas vcpkg vid det första paketgenereringsfelet. Den här flaggan instruerar vcpkg att fortsätta skapa och installera andra delar av installationsplanen som inte är beroende av det misslyckade paketet.

--x-no-default-features

Not

Det här avsnittet beskriver en experimentell funktion av vcpkg som kan ändras eller tas bort när som helst.

  • endast

Installera inte standardfunktionerna från manifestet på den översta nivån.

När du använder install i manifestläge installeras som standard alla beroenden av de funktioner som anges i "default-features". Den här flaggan inaktiverar det beteendet så att endast funktioner som uttryckligen aktiveras av --x-feature installeras.

--no-downloads

När du skapar ett paket förhindrar du att portar laddar ned nya tillgångar under bygget.

Som standard hämtar portar källkod och verktyg på begäran från Internet (med förbehåll för cachelagring av tillgångar). Den här parametern blockerar nedladdningar och begränsar portar till endast de tillgångar som tidigare har laddats ned och cachelagrats på datorn.

--only-downloads

Försök att ladda ned alla tillgångar som krävs för en installationsplan utan att utföra några byggen.

När det här alternativet har godkänts kör vcpkg varje version i planen tills den gör sitt första icke-nedladdningsbara externa processanrop. De flesta portar utför alla nedladdningar före det första externa processanropet (vanligtvis till deras byggsystem), så den här proceduren laddar ned alla nödvändiga tillgångar. Portar som inte följer den här proceduren kommer inte att ha sina tillgångar i förväg nedladdade.

--only-binarycaching

Vägra att utföra några byggen. Återställ endast paket från binära cacheminnen.

Den här flaggan blockerar vcpkg från att utföra versioner på begäran och misslyckas om ett paket inte kan hittas i några binära cacheminnen.

--recurse

  • klassiskt läge endast

Godkänn en installationsplan som kräver att paket återskapas.

För att kunna ändra uppsättningen funktioner i ett installerat paket måste vcpkg ta bort och återskapa paketet. Eftersom detta kan misslyckas och lämnar installationsträdet med färre paket än användaren började med, måste användaren godkänna planer som återskapar paket genom att skicka den här flaggan.

--x-write-nuget-packages-config

Not

Det här avsnittet beskriver en experimentell funktion av vcpkg som kan ändras eller tas bort när som helst.

Skriver ut en NuGet-packages.config-formaterad fil för användning med binär cachelagring.

Det här alternativet kan användas tillsammans med --dry-run för att hämta listan över NuGet-paket som krävs från binär cachelagring utan att skapa eller installera några paket. Detta gör att NuGet-kommandoraden kan anropas separat för avancerade scenarier, till exempel genom att använda alternativa protokoll för att hämta .nupkg-filerna.

--no-print-usage

Utelämna generering av användningstext som skrivs ut i slutet av installationen.