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>

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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>

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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.

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

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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]

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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>

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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>

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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 contenente le porte di sovrimpressione.

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>

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

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.

Nota

Tutte le versioni effettuate in e dopo settembre 2023 saranno il triplo host in Windows invece di x86-windows.

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