Číst v angličtině

Sdílet prostřednictvím


Instalace vcpkg

Synopse

  • Klasický režim
vcpkg install [options] <package>...
  • Režim manifestu
vcpkg install [options]

Popis

Sestavte a nainstalujte balíčky portů.

Klasický režim

V klasickém režimu tento příkaz přidá balíčky portů do existující sady v nainstalovaném adresáři (výchozí hodnota je installed/ pod kořenem vcpkg). To může vyžadovat odebrání a opětovné sestavení existujících balíčků, což může selhat.

Syntaxe balíčku

portname[feature1,feature2]:triplet

Odkazy na balíčky bez tripletu jsou automaticky kvalifikované ve výchozím cílovém trojitém nastavení. Odkazy na balíčky, které explicitně nevypisují core , se považují za implicitní všechny výchozí funkce.

Režim manifestu

V režimu manifestu tento příkaz nastaví nainstalovaný adresář do stavu určeného souborem manifestuvcpkg.json, přidáním, odebráním nebo opětovným sestavením balíčků podle potřeby.

Možnosti

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

--allow-unsupported

Místo zastavení na nepodporovaném portu pokračujte upozorněním.

Ve výchozím nastavení vcpkg odmítá spustit plán instalace obsahující instalaci portu pro triplet mimo jeho "supports" klauzuli. Klauzule "supports" balíčku popisuje úplnou sadu platforem, na kterých se očekává, že balíček bude sestavitelný. Tento příznak dává vcpkg pokyn, aby varoval, že sestavení se neočekává, že se místo zastavení nezdaří.

--clean-after-build

Po sestavení každého balíčku vyčistěte buildtrees, balíčky a stahování.

Tato možnost má stejný účinek jako předávání --clean-buildtrees-after-build, --clean-downloads-after-builda --clean-packages-after-build.

--clean-buildtrees-after-build

Vyčistěte všechny podadresáře z dočasné podsložky buildtrees po sestavení každého balíčku.

Všechny soubory nejvyšší úrovně v podsložce buildtrees (např. buildtrees/zlib/config-x64-windows-out.log) budou zachovány. Odstraní se všechny podadresáře.

--clean-downloads-after-build

Po sestavení každého balíčku vyčistíte všechny nevyčerpaté prostředky ze downloads/ složky.

Odstraní se všechny soubory nejvyšší úrovně ve downloads/ složce. Extrahované nástroje budou zachovány.

--clean-packages-after-build

Vyčistěte dočasné podsložky balíčků po sestavení každého balíčku.

Podsložka balíčků pro sestavený balíček (například packages/zlib_x64-windows) se po instalaci odstraní.

--dry-run

Vytiskněte plán instalace, ale neodstraňujte ani neinstalujte žádné balíčky.

Plán instalace obsahuje všechny balíčky a funkce, které se nainstalují, a také všechny další balíčky, které je potřeba odebrat a znovu vytvořit.

--editable

  • Pouze klasický režim

Proveďte upravitelné sestavení pro všechny přímo odkazované balíčky na příkazovém řádku.

Když vcpkg sestaví porty, vyprázdní a znovu extrahuje zdrojový kód pokaždé, aby se zajistilo, že vstupy jsou přesné. To je nezbytné pro režim manifestu k přesné aktualizaci toho, co je nainstalováno, a pro binární ukládání do mezipaměti, aby se zajistilo, že obsah uložený v mezipaměti je správný.

Předání příznaku --editable zakáže toto chování a zachová úpravy do extrahovaných zdrojů ve buildtrees/ složce. To pomáhá rychle vyvíjet opravy tím, že se vyhnete nutnosti napsat soubor na každou změnu.

Zdroje extrahované během upravitelného sestavení nemají příponu .clean/ názvu adresáře a nebudou vymazány následnými needitovatelnými sestaveními.

--enforce-port-checks

Instalace se nezdaří, pokud port zjistil problémy nebo se pokusí použít zastaralou funkci.

Ve výchozím nastavení spustí vcpkg několik kontrol na sestavených balíčcích a vygeneruje upozornění, pokud se zjistí nějaké problémy. Tento příznak upgraduje tato upozornění na chybu.

--x-feature=<feature>

Poznámka

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

  • Pouze režim manifestu

Zadejte další funkci z instalace vcpkg.json závislostí pro.

Ve výchozím nastavení se nainstalují jenom "dependencies" závislosti a budou nainstalovány "default-features" .

--head

  • Pouze klasický režim

Požádejte všechny balíčky explicitně odkazované na příkazový řádek a načtěte nejnovější zdroje dostupné při sestavování.

Tento příznak je určen pouze pro dočasné testování a není určený pro produkční nebo dlouhodobé použití. Tím zakážete binární ukládání do mezipaměti pro všechny explicitně odkazované balíčky a jejich závislé objekty, protože vcpkg nemůže přesně sledovat všechny vstupy.

--keep-going

Pokračujte v plánu instalace po prvním selhání.

Ve výchozím nastavení se vcpkg zastaví při prvním selhání sestavení balíčku. Tento příznak dává vcpkg pokyn, aby pokračoval v sestavování a instalaci dalších částí plánu instalace, které nezávisí na neúspěšném balíčku.

--x-no-default-features

Poznámka

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

  • Pouze režim manifestu

Neinstalujte výchozí funkce z manifestu nejvyšší úrovně.

Při použití install v režimu manifestu se ve výchozím nastavení nainstalují všechny závislosti funkcí uvedených v "default-features" manifestu. Tento příznak toto chování zakáže, takže se nainstalují --x-feature jenom funkce explicitně povolené.

--no-downloads

Při vytváření balíčku zabráníte portům ve stahování nových prostředků během sestavení.

Ve výchozím nastavení porty z internetu získají zdrojový kód a nástroje na vyžádání (v závislosti na ukládání prostředků do mezipaměti). Tento parametr blokuje stahování a omezuje porty jenom na prostředky, které byly dříve staženy a uloženy v mezipaměti na počítači.

--only-downloads

Pokuste se stáhnout všechny prostředky potřebné pro plán instalace bez provedení jakýchkoli sestavení.

Po předání této možnosti bude vcpkg spouštět každé sestavení v plánu, dokud nestahuje první volání externího procesu. Většina portů provádí všechny stahování před prvním voláním externího procesu (obvykle do systému sestavení), takže tento postup stáhne všechny požadované prostředky. Porty, které tento postup nedodržují, nebudou mít předstažené prostředky.

--only-binarycaching

Odmítnout provádět jakékoli buildy. Obnovte pouze balíčky z binárních mezipamětí.

Tento příznak blokuje vcpkg z provádění sestavení na vyžádání a selže, pokud balíček nelze najít v žádné binární mezipaměti.

--recurse

  • Pouze klasický režim

Schválit plán instalace, který vyžaduje opětovné sestavení balíčků.

Aby bylo možné upravit sadu funkcí nainstalovaného balíčku, musí vcpkg tento balíček odebrat a znovu sestavit. Vzhledem k tomu, že to může mít potenciál selhání a ponechání stromu instalace s menším počtem balíčků než uživatel začal, musí uživatel schválit plány, které znovu sestaví, předáním tohoto příznaku.

--x-use-aria2

Poznámka

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

K provádění úloh stahování použijte aria2.

--x-write-nuget-packages-config

Poznámka

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

Zapíše soubor ve formátu NuGet packages.configpro použití s binárním ukládáním do mezipaměti.

Tuto možnost lze použít společně --dry-run s získáním seznamu balíčků NuGet požadovaných z binární mezipaměti bez sestavení nebo instalace balíčků. To umožňuje, aby se příkazový řádek NuGet volal samostatně pro pokročilé scénáře, jako je například použití alternativních protokolů k získání .nupkg souborů.

--no-print-usage

Potlačí generování textu použití vytištěného na konci instalace.