vcpkg install
- Modalità classica
vcpkg install [options] <package>...
- Modalità manifesto
vcpkg install [options]
Compilare e installare pacchetti di porta.
In modalità classica questo verbo aggiunge pacchetti di porta al set esistente nella directory installata (per impostazione predefinita installed/
nella radice vcpkg). Ciò può richiedere la rimozione e la ricompilazione di pacchetti esistenti, che possono non riuscire.
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 core
in modo esplicito vengono considerati tutte le funzionalità predefinite.
In modalità manifesto questo comando imposta la directory installata sullo stato specificato dal vcpkg.json
file manifesto, aggiungendo, rimuovendo o ricompilando i pacchetti in base alle esigenze.
Tutti i comandi vcpkg supportano un set di opzioni comuni.
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 "supports"
relativa clausola. La "supports"
clausola di un pacchetto descrive il set completo di piattaforme in cui deve essere compilato un pacchetto. Questo flag indica a vcpkg di avvisare che la compilazione dovrebbe non riuscire invece di arrestarsi.
Pulire gli alberi di compilazione, i pacchetti e i download dopo la compilazione di ogni pacchetto.
Questa opzione ha lo stesso effetto del passaggio --clean-buildtrees-after-build
di , --clean-downloads-after-build
e --clean-packages-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.
Pulire tutti gli asset non sottratti dalla cartella dopo la downloads/
compilazione di ogni pacchetto.
Tutti i file di primo livello nella downloads/
cartella verranno eliminati. Gli strumenti estratti verranno mantenuti.
Pulire la sottocartella temporanea dei pacchetti dopo la compilazione di ogni pacchetto.
La sottocartella pacchetti per il pacchetto compilato ,ad esempio , packages/zlib_x64-windows
verrà eliminata dopo l'installazione.
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.
- Solo modalità classica
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 --editable
flag disabilita questo comportamento, mantenendo le modifiche alle origini estratte nella buildtrees/
cartella. 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 .clean/
suffisso sul nome della directory e non verranno cancellate dalle compilazioni successive non modificabili.
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.
Nota
Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.
- Solo modalità manifesto
Specificare una funzionalità aggiuntiva da vcpkg.json
per per cui installare le dipendenze.
Per impostazione predefinita, verranno installate solo "dependencies"
le dipendenze di "default-features"
.
- Solo modalità classica
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. In questo modo viene disabilitata la memorizzazione nella cache binaria per tutti i pacchetti a cui si fa riferimento in modo esplicito e per i relativi dipendenti, perché vcpkg non è in grado di tenere traccia accuratamente di tutti gli input.
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.
Nota
Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.
- Solo modalità manifesto
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
.
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 alla memorizzazione nella cache degli asset). Questo parametro blocca i download e limita le porte solo agli asset scaricati e memorizzati nella cache nel computer.
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.
Rifiuta di eseguire le compilazioni. Ripristina 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.
- Solo modalità classica
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.
Nota
Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.
Usare aria2 per eseguire le attività di download.
Nota
Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.
Scrive un file in formato NuGet packages.config
da usare con la memorizzazione nella cache binaria.
Questa opzione può essere usata insieme --dry-run
a 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 .nupkg
file.
Eliminare la generazione del testo di utilizzo stampato alla fine dell'installazione.
Feedback su vcpkg
vcpkg è un progetto di open source. Selezionare un collegamento per fornire feedback: