Opzioni di comando comuni

La maggior parte dei comandi vcpkg accetta un gruppo di opzioni comuni che controllano gli aspetti trasversali dello strumento. Non tutte le opzioni influiscono su ogni comando. Ad esempio, un comando che non scarica alcun file non sarà interessato modificando la directory dei download.

Opzioni

--x-asset-sources=<config>

Specificare la configurazione della cache per La memorizzazione nella cache degli asset.

--binarysource=<config>

Aggiungere un'origine per la memorizzazione nella cache binaria.

Questa opzione può essere specificata più volte; per informazioni sull'interazione tra più origini binarie, vedere la documentazione sulla memorizzazione nella cache binaria.

--x-buildtrees-root=<path>

Specifica il percorso temporaneo per archiviare file di compilazione intermedi, ad esempio oggetti o codice sorgente decompresso.

Il valore predefinito è buildtrees/ nella cartella radice vcpkg.

--classic

Forza la modalità classica anche se viene rilevato un file manifesto.

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

Abilita CMake all'interno dei sistemi di compilazione upstream' CMakeLists.txt, ad esempio all'interno vcpkg_cmake_configuredi --debugger .

Il <debugger-pipe> valore viene passato come --debugger-pipe nella riga di comando di CMake.

Se è presente un elenco di porte separate da punto e virgola, il debugger viene usato solo per le porte nell'elenco. In caso contrario, viene usato per tutte le porte.

La variabile VCPKG_CMAKE_CONFIGURE_OPTIONS triplet viene usata per passare le opzioni alla chiamata di configurazione interna di CMake. Di conseguenza, non funzionerà per le triplette personalizzate sovrascrivendo VCPKG_CMAKE_CONFIGURE_OPTIONS. Passare manualmente le opzioni di debug o aggiungere le opzioni a VCPKG_CMAKE_CONFIGURE_OPTIONS .

A differenza di --x-cmake-debug non verrà visualizzato alcun output che indica che la compilazione è in attesa della connessione di un debugger. L'output si blocca semplicemente in Configuring <triplet>.

Anche se tutte le porte devono chiamare CMake all'interno del file di porta per ottenere flag di compilazione dalla toolchain CMake. Questo comando è utile principalmente per le porte che usano effettivamente CMake come sistema di compilazione.

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

Abilita CMake durante l'esecuzione --debugger di script CMake richiamati direttamente come file triplet (ad esempio: x64-windows.cmake) o portfile.cmake file.

Il <debugger-pipe> valore viene passato come --debugger-pipe nella riga di comando di CMake.

Se è presente un elenco di porte separate da punto e virgola, il debugger viene usato solo per le porte nell'elenco. In caso contrario, viene usato per tutte le porte.

Nota: il debugger può essere collegato se Waiting for debugger client to connect... è possibile osservare nell'output di vcpkg e l'esecuzione viene interrotta fino a quando non viene connesso un debugger.

--downloads-root=<path>

Specificare dove devono essere conservati gli strumenti scaricati e gli archivi del codice sorgente.

Il valore predefinito è la VCPKG_DOWNLOADS variabile di ambiente. Se non è impostato, il valore predefinito è downloads/ nella cartella radice vcpkg.

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

Questa variabile può essere impostata su un elenco di flag di funzionalità per acconsentire esplicitamente al comportamento sperimentale.

--host-triplet=<triplet>

Specificare il triplo host.

Il valore predefinito è la VCPKG_DEFAULT_HOST_TRIPLET variabile di ambiente. Se è anche unset, il valore viene dedotto in base all'architettura host e al sistema operativo.

--x-install-root=<path>

Specifica il percorso di layout dei pacchetti installati.

In modalità classica, il valore predefinito è installed/ nella cartella radice vcpkg.

In modalità manifesto, per impostazione predefinita si trova vcpkg_installed/ nella cartella del manifesto.

--x-manifest-root=<path>

Specifica la directory contenente vcpkg.json.

Per impostazione predefinita, la ricerca verso l'alto dalla directory di lavoro corrente per l'oggetto più vcpkg.jsonvicino.

--overlay-ports=<path>

Specifica una directory una porta di sovrimpressione o sottodirectory che sono stesse porte sovrapposte. Se <path> è una directory contenente o CONTROL vcpkg.json, viene considerata come una directory della porta di sovrapposizione e le sottodirectory non verranno considerate come porte di sovrapposizione aggiuntive.

Questa opzione può essere specificata più volte; le porte verranno risolte nella prima corrispondenza.

--overlay-triplets=<path>

Specifica una directory contenente triplette sovrapposte.

Questa opzione può essere specificata più volte per aggiungere più directory; i triplets verranno risolti nella prima corrispondenza in base al nome.

--x-packages-root=<path>

Specifica il percorso temporaneo dei file di pacchetto intermedi prima dell'installazione finale.

Il valore predefinito è packages/ nella cartella radice vcpkg.

--triplet=<triplet>

Specificare il triplo dell'architettura di destinazione.

Il valore predefinito è la VCPKG_DEFAULT_TRIPLET variabile di ambiente. Se non è impostato, dedotto in base all'architettura host e al sistema operativo.

Nei sistemi operativi Windows, l'architettura viene sempre dedotta come x86 per motivi legacy.

--vcpkg-root=<path>

Specifica la cartella radice vcpkg.

Il valore predefinito è la directory contenente il programma vcpkg. La directory deve essere un'istanza vcpkg valida, ad esempio un git clone di https://github.com/microsoft/vcpkg. Questa opzione può essere usata per eseguire una copia personalizzata dello strumento direttamente dalla cartella di compilazione.

File di risposta (@<file>)

La riga di comando vcpkg accetta file di testo contenenti parametri della riga di comando separati da nuova riga.

Lo strumento fungerà come se gli elementi del file fossero inseriti nella riga di comando al posto del @ riferimento. I file di risposta non possono contenere file di risposta aggiuntivi.