Běžné možnosti příkazů
Většina příkazů vcpkg přijímá skupinu běžných možností, které řídí průřezové aspekty nástroje. Ne všechny možnosti ovlivňují každý příkaz. Například příkaz, který nestahuje žádné soubory, nebude mít vliv na změnu adresáře pro stahování.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Zadejte konfiguraci mezipaměti pro ukládání prostředků do mezipaměti.
Přidejte zdroj pro binární ukládání do mezipaměti.
Tuto možnost lze zadat vícekrát; Informace o interakci s více binárními zdroji najdete v dokumentaci k binární mezipaměti.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Určuje dočasnou cestu pro ukládání dočasných souborů sestavení, jako jsou objekty nebo rozbalený zdrojový kód.
Výchozí hodnota je buildtrees/
v kořenové složce vcpkg.
Vynutí klasický režim, i když se zjistí soubor manifestu.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Umožňuje CMake --debugger
v upstreamových buildových systémech CMakeLists.txt
, například v rámci vcpkg_cmake_configure
.
Hodnota <debugger-pipe>
se předává jako --debugger-pipe
na příkazovém řádku CMake.
Pokud je seznam portů oddělený středníkem, ladicí program se používá jenom pro porty v daném seznamu. V opačném případě se použije pro všechny porty.
Trojitá proměnná VCPKG_CMAKE_CONFIGURE_OPTIONS
slouží k předání možností internímu volání konfigurace CMake.
Proto nebude fungovat pro vlastní trojité přepsání VCPKG_CMAKE_CONFIGURE_OPTIONS
.
Buď ručně předejte možnosti ladění, nebo místo toho připojte možnosti VCPKG_CMAKE_CONFIGURE_OPTIONS
.
Na rozdíl od --x-cmake-debug
výstupu se nezobrazí žádný výstup, který značí, že sestavení čeká na připojení ladicího programu. Výstup se jednoduše zastaví na Configuring <triplet>
.
I když všechny porty by měly volat CMake uvnitř souboru portu, aby získaly příznaky kompilace ze sady nástrojů CMake. Tento příkaz je užitečný hlavně pro porty, které jako svůj systém sestavení používají CMake.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Povolí CMake --debugger
při spouštění přímo vyvolaných skriptů CMake, jako jsou trojité soubory (například: x64-windows.cmake
) nebo portfile.cmake
soubory.
Hodnota <debugger-pipe>
se předává jako --debugger-pipe
na příkazovém řádku CMake.
Pokud je seznam portů oddělený středníkem, ladicí program se používá jenom pro porty v daném seznamu. V opačném případě se použije pro všechny porty.
Poznámka: Ladicí program lze připojit, pokud Waiting for debugger client to connect...
lze pozorovat ve výstupu vcpkg a provádění se zastaví, dokud není připojen ladicí program.
Určete, kde se mají uchovávat stažené nástroje a archivy zdrojového kódu.
Výchozí hodnota je proměnná VCPKG_DOWNLOADS
prostředí. Pokud je tato možnost nenasazená, ve výchozím nastavení se nachází downloads/
v kořenové složce vcpkg.
Tuto proměnnou je možné nastavit na seznam příznaků funkcí pro vyjádření souhlasu s experimentálním chováním.
Zadejte triplet hostitele.
Výchozí hodnota je proměnná VCPKG_DEFAULT_HOST_TRIPLET
prostředí. Pokud je tato hodnota také nenasazená, je tato hodnota vyvolána na základě architektury hostitele a operačního systému.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Určuje cestu k rozložení nainstalovaných balíčků.
V klasickém režimu se ve výchozím nastavení nastaví pod installed/
kořenovou složku vcpkg.
V režimu manifestu se ve výchozím nastavení nastaví pod vcpkg_installed/
složku manifestu.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Určuje adresář obsahující vcpkg.json
.
Výchozí hodnota vyhledávání směrem nahoru z aktuálního pracovního adresáře pro nejbližší vcpkg.json
.
Určuje adresář buď překryvný port, nebo podadresáře, které jsou samy překryvné porty. Pokud <path>
je adresář obsahující CONTROL
adresář nebo vcpkg.json
, je považován za překryvný adresář portů a podadresáře se nebudou považovat za další překryvné porty.
Tuto možnost lze zadat vícekrát; porty se přeloží na první shodu.
Určuje adresář obsahující překryvné triplety.
Tuto možnost lze zadat vícekrát, pokud chcete přidat více adresářů; triplety se přeloží na první shodu podle názvu.
Poznámka
Tato část popisuje experimentální funkci vcpkg, která se může kdykoli změnit nebo odebrat.
Určuje dočasnou cestu k dílčím souborům balíčku před dokončením instalace.
Výchozí hodnota je packages/
v kořenové složce vcpkg.
Zadejte triplet cílové architektury.
Výchozí hodnota je proměnná VCPKG_DEFAULT_TRIPLET
prostředí. Pokud je tato sada nenasazená, vyvolaná na základě architektury hostitele a operačního systému.
V operačních systémech Windows se architektura vždy z důvodu starší verze odvodí jako x86.
Poznámka
Všechny vydané verze provedené v září 2023 se místo x86-windows ve Výchozím nastavení nastaví na trojitého hostitele ve Windows.
Určuje kořenovou složku vcpkg.
Ve výchozím nastavení je adresář obsahující program vcpkg. Adresář musí být platnou instancí vcpkg, například git clone
z https://github.com/microsoft/vcpkg
. Tuto možnost lze použít ke spuštění vlastní kopie nástroje přímo ze složky sestavení.
Příkazový řádek vcpkg přijímá textové soubory obsahující parametry příkazového řádku odděleného novým řádkem.
Nástroj bude fungovat tak, jako kdyby se položky v souboru zdvojily do příkazového @
řádku místo odkazu. Soubory odpovědí nemohou obsahovat další soubory odpovědí.
Zpětná vazba k produktu vcpkg
vcpkg je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: