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í.

Možnosti

--x-asset-sources=<config>

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í do mezipaměti assetu.

--binarysource=<config>

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ím Ukládání do mezipaměti.

--x-buildtrees-root=<path>

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.

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

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.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

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.

--downloads-root=<path>

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.

--feature-flags=<flag1>,...

Tuto proměnnou je možné nastavit na seznam příznaků funkcí pro vyjádření souhlasu s experimentálním chováním.

--host-triplet=<triplet>

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.

--x-install-root=<path>

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.

--x-manifest-root=<path>

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.

--overlay-ports=<path>

Určuje adresář obsahující překryvné porty.

Tuto možnost lze zadat vícekrát; porty se přeloží na první shodu.

--overlay-triplets=<path>

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.

--x-packages-root=<path>

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.

--triplet=<triplet>

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.

--vcpkg-root=<path>

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í.

Soubory odpovědí (@<file>)

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í.