Instalace vcpkg

Přehled

• klasického režimu

vcpkg install [options] <package>...

• režimu manifestu

vcpkg install [options]

Popis

Sestavte a nainstalujte balíčky portů.

Klasický režim

V klasickém režimutento 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 trojité hodnoty jsou automaticky kvalifikované výchozím cílovým trojitým. Odkazy na balíčky, které explicitně nevypisují core, se považují za předpokladu, že všechny výchozí funkce.

Režim manifestu

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

Volby

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 klauzuli "supports". 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 složky downloads/.

Odstraní se všechny soubory nejvyšší úrovně ve složce downloads/. 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.

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

--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ého režimu

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 složce buildtrees/. 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.

• režim manifestu pouze

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

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

--head

• pouze klasického režimu

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í. To zakáže 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.

• režim manifestu pouze

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". Tento příznak toto chování zakáže, takže se nainstalují jenom funkce explicitně povolené --x-feature.

--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. Obnovit pouze balíčky z binární mezipaměti.

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ého režimu

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-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 NuGet packages.configformátovaný pro použití s binární ukládání do mezipaměti.

Tuto možnost lze použít ve spojení s --dry-run k získání seznamu balíčků NuGet vyž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 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.