Informazioni di riferimento sull'interfaccia della riga di comando di NuGet

Articolo
12/21/2023

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.

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.exe riga di comando è già installato, è possibile aggiornare lo strumento alla versione più recente con il comando nuget update -self.
Per la compatibilità con i sistemi di integrazione continua meno recenti, un URL precedente fornisce https://nuget.org/nuget.exe attualmente 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.exe file alla variabile di ambiente PATH.

I comportamenti possono variare leggermente in base alla distribuzione del sistema operativo.

Nota

Visual Studio per Mac è prevista per il ritiro entro il 31 agosto 2024 in conformità con Criteri moderni relativi al ciclo di vita di Microsoft. Per altre informazioni, vedere What's happening to Visual Studio per Mac.

Installare Mono versione 4.4.2 o successiva.

Eseguire il comando seguente da un prompt della shell:

# Download the latest stable `nuget.exe` to `/usr/local/bin`
sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe

Creare un alias aggiungendo lo script seguente al file appropriato per il sistema operativo (in ~/.bash_aliases genere o ~/.bash_profile):
```
# Create as alias for nuget
alias nuget="mono /usr/local/bin/nuget.exe"
```
Ricaricare la shell. Testare l'installazione immettendo il comando nuget senza parametri. Dovrebbe essere visualizzata la Guida dell'interfaccia della riga di comando di NuGet.

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, restoree update.
I packcomandi , deleterestore, locals, e push sono 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.