vcpkg install

Sinossi

• modalità classica

vcpkg install [options] <package>...

• modalità manifesto

vcpkg install [options]

Descrizione

Compilare e installare pacchetti di porta.

Modalità classica

In modalità classica, questo verbo aggiunge i pacchetti di porta al set esistente nella directory installata (per impostazione predefinita viene installed/ nella radice vcpkg). Ciò può richiedere la rimozione e la ricompilazione di pacchetti esistenti, che possono non riuscire.

Sintassi del pacchetto

portname[feature1,feature2]:triplet

I riferimenti ai pacchetti senza tripletta vengono qualificati automaticamente dal triplo di destinazione predefinito. I riferimenti ai pacchetti che non elencano in modo esplicito core vengono considerati come tutte le funzionalità predefinite.

Modalità manifesto

In modalità manifesto, questo comando imposta la directory installata sullo stato specificato dal file manifesto vcpkg.json, aggiungendo, rimuovendo o ricompilando i pacchetti in base alle esigenze.

Opzioni

Tutti i comandi vcpkg supportano un set di opzioni comuni .

--allow-unsupported

Anziché arrestarsi su una porta non supportata, continuare con un avviso.

Per impostazione predefinita, vcpkg rifiuta di eseguire un piano di installazione contenente un'installazione della porta per un triplet all'esterno della clausola "supports". La clausola "supports" di un pacchetto descrive il set completo di piattaforme in cui dovrebbe essere compilato un pacchetto. Questo flag indica a vcpkg di avvisare che la compilazione dovrebbe non riuscire invece di arrestarsi.

--clean-after-build

Pulire gli alberi di compilazione, i pacchetti e i download dopo la compilazione di ogni pacchetto.

Questa opzione ha lo stesso effetto del passaggio di --clean-buildtrees-after-build, --clean-downloads-after-builde --clean-packages-after-build.

--clean-buildtrees-after-build

Pulire tutte le sottodirectory dalla sottocartella temporanea buildtrees dopo la compilazione di ogni pacchetto.

Tutti i file di primo livello nella sottocartella buildtrees (ad esempio, buildtrees/zlib/config-x64-windows-out.log) verranno mantenuti. Tutte le sottodirectory verranno eliminate.

--clean-downloads-after-build

Pulire tutti gli asset non sottratti dalla cartella downloads/ dopo la compilazione di ogni pacchetto.

Tutti i file di primo livello nella cartella downloads/ verranno eliminati. Gli strumenti estratti verranno mantenuti.

--clean-packages-after-build

Pulire la sottocartella temporanea dei pacchetti dopo la compilazione di ogni pacchetto.

La sottocartella dei pacchetti per il pacchetto compilato (ad esempio, packages/zlib_x64-windows) verrà eliminata dopo l'installazione.

--dry-run

Stampare il piano di installazione, ma non rimuovere o installare alcun pacchetto.

Il piano di installazione elenca tutti i pacchetti e le funzionalità che verranno installati, nonché tutti gli altri pacchetti che devono essere rimossi e ricompilati.

--editable

• modalità classica solo

Eseguire compilazioni modificabili per tutti i pacchetti a cui si fa riferimento direttamente nella riga di comando.

Quando vcpkg compila le porte, elimina ed estrae nuovamente il codice sorgente ogni volta per garantire che gli input siano accurati. Questa operazione è necessaria per la modalità Manifesto per aggiornare accuratamente ciò che è installato e per la memorizzazione nella cache binaria per garantire che il contenuto memorizzato nella cache sia corretto.

Il passaggio del flag di --editable disabilita questo comportamento, mantenendo le modifiche alle origini estratte nella cartella buildtrees/. Ciò consente di sviluppare rapidamente patch evitando la necessità di scrivere un file in ogni modifica.

Le origini estratte durante una compilazione modificabile non hanno un suffisso .clean/ sul nome della directory e non verranno cancellate dalle compilazioni successive non modificabili.

--enforce-port-checks

L'installazione non riesce se una porta ha rilevato problemi o tenta di usare una funzionalità deprecata.

Per impostazione predefinita, vcpkg eseguirà diversi controlli sui pacchetti compilati e genera avvisi se vengono rilevati problemi. Questo flag aggiorna tali avvisi a un errore.

--x-feature=<feature>

Nota

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

• modalità manifesto solo

Specificare una funzionalità di aggiuntiva dal vcpkg.json per cui installare le dipendenze.

Per impostazione predefinita, verranno installate solo "dependencies" e le dipendenze di "default-features".

--head

• modalità classica solo

Richiedere a tutti i pacchetti a cui viene fatto riferimento in modo esplicito nella riga di comando per recuperare le origini più recenti disponibili durante la compilazione.

Questo flag è destinato solo ai test temporanei e non è destinato alla produzione o all'uso a lungo termine. Ciò disabilita memorizzazione nella cache binaria per tutti i pacchetti a cui si fa riferimento in modo esplicito e i relativi dipendenti perché vcpkg non è in grado di tenere traccia accuratamente di tutti gli input.

--keep-going

Continuare il piano di installazione dopo il primo errore.

Per impostazione predefinita, vcpkg si arresterà al primo errore di compilazione del pacchetto. Questo flag indica a vcpkg di continuare a compilare e installare altre parti del piano di installazione che non dipendono dal pacchetto non riuscito.

--x-no-default-features

Nota

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

• modalità manifesto solo

Non installare le funzionalità predefinite dal manifesto di primo livello.

Quando si usa install in modalità manifesto, per impostazione predefinita verranno installate tutte le dipendenze delle funzionalità elencate in "default-features". Questo flag disabilita tale comportamento in modo che vengano installate solo le funzionalità abilitate in modo esplicito da --x-feature.

--no-downloads

Quando si compila un pacchetto, impedire alle porte di scaricare nuovi asset durante la compilazione.

Per impostazione predefinita, le porte acquisiranno il codice sorgente e gli strumenti su richiesta da Internet (soggetto a memorizzazione nella cache degli asset). Questo parametro blocca i download e limita le porte solo agli asset scaricati e memorizzati nella cache nel computer.

--only-downloads

Tentare di scaricare tutti gli asset necessari per un piano di installazione senza eseguire alcuna compilazione.

Quando viene passata questa opzione, vcpkg eseguirà ogni compilazione nel piano fino a quando non effettua la prima chiamata di processo esterno non scaricata. La maggior parte delle porte esegue tutti i download prima della prima chiamata al processo esterno (in genere al sistema di compilazione), quindi questa procedura scaricherà tutti gli asset necessari. Le porte che non seguono questa procedura non avranno gli asset pre-scaricati.

--only-binarycaching

Rifiuta di eseguire le compilazioni. Ripristinare solo i pacchetti da cache binarie .

Questo flag impedisce a vcpkg di eseguire compilazioni su richiesta e avrà esito negativo se non è possibile trovare un pacchetto in alcuna cache binaria.

--recurse

• modalità classica solo

Approvare un piano di installazione che richiede la ricompilazione dei pacchetti.

Per modificare il set di funzionalità di un pacchetto installato, vcpkg deve rimuovere e ricompilare il pacchetto. Poiché ciò può avere esito negativo e lasciare l'albero di installazione con un numero inferiore di pacchetti rispetto all'utente avviato, l'utente deve approvare i piani che ricompilano i pacchetti passando questo flag.

--x-write-nuget-packages-config

Nota

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

Scrive un file con formattazione NuGet packages.configda usare con memorizzazione nella cache binaria.

Questa opzione può essere usata in combinazione con --dry-run per ottenere l'elenco dei pacchetti NuGet necessari dalla memorizzazione nella cache binaria senza compilare o installare pacchetti. Ciò consente di richiamare separatamente la riga di comando NuGet per scenari avanzati, ad esempio l'uso di protocolli alternativi per acquisire i file di .nupkg.

--no-print-usage

Eliminare la generazione del testo di utilizzo stampato alla fine dell'installazione.