Gestire pacchetti NuGet con l'interfaccia della riga di comando di NuGet

È possibile usare l'interfaccia della riga di comando nuget.exe per gestire i pacchetti NuGet in progetti e soluzioni Visual Studio. Questo articolo descrive i comandi più comuni dell'interfaccia della riga di comando di NuGet per la gestione dei pacchetti NuGet. Tutti questi comandi funzionano su Windows e la maggior parte funziona su macOS e in Linux con Mono.

L'interfaccia della riga di comando di NuGet viene eseguita in .NET Framework e progetti non in stile SDK, ad esempio progetti non in stile SDK destinati a .NET librerie Standard. I comandi dell'interfaccia della riga di comando di NuGet possono usare un progetto packages.config file che elenca i riferimenti ai pacchetti. Per i progetti non in stile SDK che usano PackageReference invece di packages.config per i riferimenti ai pacchetti, usare invece l'interfaccia della riga di comando dotnet .

Per la maggior parte dei comandi, lo strumento dell'interfaccia della riga di comando di NuGet usa la cartella corrente, a meno che non si specifichi un percorso diverso nel comando. Per eseguire i comandi dell'interfaccia della riga di comando di NuGet, aprire un programma da riga di comando e passare alla cartella che contiene il file di progetto.

Per un elenco completo dei comandi e dei relativi argomenti, vedere il Riferimento alla CLI di NuGet.

Prerequisiti

Scaricare l'interfaccia della riga di comando di NuGet da nuget.org. Salvare il filenuget.exe in una cartella appropriata e assicurarsi che la cartella si trova nella PATH variabile di ambiente.

Per controllare la versione della CLI di NuGet, aprire un programma della riga di comando ed eseguire nuget help. In alternativa, per evitare di dover scorrere verso l'alto, usare nuget help | more. La prima riga dell'output di aiuto mostra la versione.

Installare un pacchetto

Il comando dell'interfaccia install della riga di comando nuGet scarica e installa i pacchetti NuGet specificati.

Usare l'opzione -OutputDirectory per installare i pacchetti in una cartella specifica. Se non si specifica una cartella di output, install usa la cartella corrente.

nuget install <package-ID | configuration-file-path> -OutputDirectory <output-folder>

Ad esempio, per installare il Newtonsoft.json pacchetto nella sottocartella packages , usare il comando seguente:

nuget install Newtonsoft.Json -OutputDirectory packages

Anziché specificare un pacchetto da installare, è possibile specificare un file dipackages.config esistente nella cartella corrente o in un'altra cartella. Il install comando installa tutti i pacchetti elencati nel file packages.config .

nuget install packages.config

Ad esempio, il comando seguente installa tutti i pacchetti elencati in packages.config nella sottocartella config della cartella corrente. Il comando installa i pacchetti nella cartella packages .

nuget install config\packages.config -OutputDirectory packages

Installare una versione specifica di un pacchetto

Il install comando installa la versione più recente di un pacchetto a meno che non si specifichi una versione diversa. Per installare una versione specifica di un pacchetto, usare l'opzione -Version :

nuget install <package-ID> -Version <version>

Ad esempio, per installare la versione 12.0.1 del Newtonsoft.json pacchetto, usare:

nuget install Newtonsoft.Json -Version 12.0.1

Elencare i pacchetti

Usare il search comando per visualizzare informazioni di base sui pacchetti in un'origine specificata.

nuget search -Source <source>

Ad esempio, per elencare i pacchetti nella sottocartella pacchetti di MyProject, usare il comando seguente:

nuget search -Source C:\Users\%USERNAME%\source\repos\MyProject\packages

È anche possibile specificare i termini di ricerca per limitare i risultati in base ai nomi, ai tag o alle descrizioni dei pacchetti:

nuget search <search-terms> -Source <source>

Aggiornare tutti i pacchetti

Usare il update comando per aggiornare tutti i pacchetti in un progetto packages.config file alle versioni disponibili più recenti. Per <configuration-file-path>, usa il percorso del tuo file packages.config.

nuget update <configuration-file-path>

È consigliabile eseguire restore prima di eseguire update. Il update comando contiene quindi informazioni sulle versioni del pacchetto in uso. Queste informazioni consentono di risolvere correttamente le dipendenze.

Rimuovere un pacchetto

Per rimuovere un pacchetto, è possibile eliminare tale pacchetto dalla cartella del progetto. Per reinstallare i pacchetti, usare i restore comandi o install .

L'eliminazione di pacchetti dal disco non aggiorna il progetto, packages.configo i file NuGet.Config . Il modo migliore per rimuovere i pacchetti consiste nell'usare l'interfaccia utente Visual Studio Package Manager o Package Manager Console.

Ripristinare i pacchetti

Il comando CLI di NuGet restore scarica e installa eventuali pacchetti mancanti. Il comando funziona sui progetti che usano PackageReference o packages.config per i riferimenti ai pacchetti.

Come install, il restore comando aggiunge solo pacchetti al disco. Non modifica il file di progetto o packages.config file. Per aggiungere dipendenze di progetto, usare l'interfaccia utente o la console di Visual Studio Package Manager.

Per ripristinare i pacchetti, eseguire il comando seguente:

nuget restore <project-path>

Il restore comando usa un file di soluzione o un file package.config nel percorso del progetto specificato.

Ad esempio, per ripristinare tutti i pacchetti per MySolution.slnx nella directory corrente, eseguire il comando seguente:

nuget restore MySolution.slnx

Per altre informazioni, vedere Ripristinare i pacchetti.

Contenuti correlati

• Riferimenti per NuGet CLI
• Installare e gestire i pacchetti in Visual Studio usando NuGet Package Manager
• Eseguire la migrazione da packages.config a PackageReference
• Installare e gestire pacchetti NuGet con l'interfaccia della riga di comando dotnet