Informazioni di riferimento sull'interfaccia della riga di comando di NuGet
L'interfaccia della riga di comando di nuget.exeNuGet fornisce l'estensione completa della funzionalità NuGet per installare, creare, pubblicare e gestire pacchetti senza apportare modifiche ai file di progetto.
Per usare qualsiasi comando, aprire una finestra di comando o una shell bash, quindi eseguire nuget seguito dal comando e dalle opzioni appropriate, ad esempio nuget help pack (per visualizzare la Guida nel comando pack).
Questa documentazione riflette la versione più recente dell'interfaccia della riga di comando di NuGet. Per informazioni esatte su qualsiasi versione specificata in uso, eseguire nuget help per il comando desiderato.
Per informazioni su come usare i comandi di base con l'interfaccia della riga di comando di nuget.exe, vedere Installare e usare pacchetti tramite l'interfaccia della riga di comando di nuget.exe.
Installazione di nuget.exe
Installare sempre la versione più recente dello strumento che supporta la configurazione.
- È possibile scaricare la versione consigliata più recente all'indirizzo
https://dist.nuget.org/win-x86-commandline/latest/nuget.exe. - Se lo strumento dell'interfaccia della
nuget.exeriga di comando è già installato, è possibile aggiornare lo strumento alla versione più recente con il comandonuget update -self. - Per la compatibilità con i sistemi di integrazione continua meno recenti, un URL precedente fornisce
https://nuget.org/nuget.exeattualmente la versione deprecata 2.8.6 dello strumento dell'interfaccia della riga di comando.
Visitare nuget.org/downloads e scaricare NuGet versione 3.3 o successiva.
- La versione 5.0 e successive richiede .NET Framework versione 4.7.2 o successiva.
- La versione 4.1.0 e successive è necessaria per pubblicare i pacchetti in
nuget.org. - La versione 2.8.6 non è compatibile con Mono.
Ogni download è direttamente il file
nuget.exe. Indicare al browser di salvare il file in una cartella di propria scelta. Il file di download non è un programma di installazione, quindi non viene visualizzato nulla se si esegue il file direttamente dal browser.Per usare lo strumento dell'interfaccia della riga di comando da qualsiasi posizione, aggiungere il percorso della cartella per il
nuget.exefile alla variabile di ambiente PATH.
Suggerimento
Per rendere disponibile l'interfaccia della riga di comando di NuGet all'interno della console di Gestione pacchetti in Visual Studio, vedere Uso dell'interfaccia della riga di comando di nuget.exe nella console.
Disponibilità
Per informazioni dettagliate, vedere Disponibilità delle funzionalità.
- Tutti i comandi sono disponibili in Windows.
- Tutti i comandi funzionano con nuget.exe in esecuzione in Mono tranne dove indicato per
pack,restoreeupdate. - I
packcomandi ,deleterestore,locals, epushsono disponibili anche in Mac e Linux tramite l'interfaccia della riga di comando dotnet.
Comandi e applicabilità
Comandi e applicabilità disponibili alla creazione di pacchetti, all'utilizzo di pacchetti e/o alla pubblicazione di un pacchetto in un host:
| Comandi comuni | Ruoli applicabili | Versione di NuGet | Descrizione |
|---|---|---|---|
| pack | Creazione | 2.7+ | Crea un pacchetto NuGet da un .nuspec file di progetto o . Quando si esegue in Mono, la creazione di un pacchetto da un file di progetto non è supportata. |
| push | Pubblicazione | Tutte le date | Pubblica un pacchetto in un'origine del pacchetto. |
| config | Tutte le date | Tutte le date | Ottiene o imposta i valori di configurazione di NuGet. |
| help or ? | Tutte le date | Tutte le date | Visualizza le informazioni della Guida o la Guida per un comando. |
| locals | Consumo | 3.3+ | Elenca i percorsi delle cartelle global-packages, http-cache e temp e cancella il contenuto di tali cartelle. |
| restore | Consumo | 2.7+ | Ripristina tutti i pacchetti a cui fa riferimento il formato di gestione dei pacchetti in uso. Durante l'esecuzione in Mono, il ripristino dei pacchetti con il formato PackageReference non è supportato. |
| setapikey | Pubblicazione, consumo | Tutte le date | Salva una chiave API per un'origine del pacchetto specifica quando tale origine del pacchetto richiede una chiave per l'accesso. |
| spec | Creazione | Tutte le date | Genera un .nuspec file, usando i token se si genera il file da un progetto di Visual Studio. |
| Comandi secondari | Ruoli applicabili | Versione di NuGet | Descrizione |
|---|---|---|---|
| add | Pubblicazione | 3.3+ | Aggiunge un pacchetto a un'origine del pacchetto non HTTP usando il layout gerarchico. Per le origini HTTP, usare il push. |
| delete | Pubblicazione | Tutte le date | Rimuove o annulla l'elenco di un pacchetto da un'origine del pacchetto. |
| init | Creazione | 3.3+ | Aggiunge pacchetti da una cartella a un'origine del pacchetto usando il layout gerarchico. |
| install | Consumo | Tutte le date | Installa un pacchetto nel progetto corrente, ma non modifica i progetti o i file di riferimento. |
| list | Consumo, forse pubblicazione | Tutte le date | Visualizza i pacchetti da una determinata origine. |
| mirror | Pubblicazione | Deprecato nella versione 3.2+ | Esegue il mirror di un pacchetto e delle relative dipendenze da un'origine a un repository di destinazione. |
| search | Consumo | 5.8+ | Esegue la ricerca in una determinata origine usando la stringa di query fornita. |
| sources | Consumo, pubblicazione | Tutte le date | Gestisce le origini dei pacchetti nei file di configurazione. |
| update | Consumo | Tutte le date | Aggiornamenti i pacchetti di un progetto alle versioni più recenti disponibili. Non supportato durante l'esecuzione in Mono. |
Diversi comandi usano varie variabili di ambiente.
Comandi dell'interfaccia della riga di comando nuGet in base ai ruoli applicabili:
| Ruolo | Comandi |
|---|---|
| Consumo | configinstall, help, , list, localsrestore, search, setapikey, , sourcesupdate |
| Creazione | config, help, init, packspec |
| Pubblicazione | add, config, delete, helplist, push, , setapikeysources |
Gli sviluppatori interessati solo all'utilizzo di pacchetti, ad esempio, devono comprendere solo il subset di comandi NuGet.
Nota
I nomi delle opzioni di comando non fanno distinzione tra maiuscole e minuscole. Le opzioni deprecate non sono incluse in questo riferimento, ad esempio NoPrompt (sostituite da NonInteractive) e Verbose (sostituite da Verbosity).
Localizzazione
NuGet.exe i messaggi di stato, avviso e errore vengono convertiti nelle stesse impostazioni locali di Visual Studio. NuGet.exe viene fornito come singolo exe e a causa delle considerazioni sulle dimensioni, solo i messaggi più comuni vengono tradotti in tutte le lingue.