Instalace vcpkg
- Klasický režim
vcpkg install [options] <package>...
- Režim manifestu
vcpkg install [options]
Sestavte a nainstalujte balíčky portů.
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.
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.
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.
Všechny příkazy vcpkg podporují sadu běžných možností.
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ří.
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-build
a --clean-packages-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.
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.
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í.
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.
- 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.
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.
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"
.
- 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.
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.
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é.
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.
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.
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.
- 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.
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.
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.config
pro 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ů.
Potlačí generování textu použití vytištěného na konci instalace.
Zpětná vazba k produktu vcpkg
vcpkg je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: