Installare e gestire pacchetti NuGet con l'interfaccia della riga di comando dotnet

Articolo
08/21/2023

È possibile usare lo strumento dotnet CLI in Windows, macOS o Linux per installare, disinstallare e aggiornare facilmente pacchetti NuGet in progetti e soluzioni .NET. Questo articolo descrive i comandi più comuni dell'interfaccia della riga di comando dotnet per la gestione dei pacchetti NuGet.

L'interfaccia della riga di comando dotnet viene eseguita in progetti di tipo .NET, .NET Core, .NET Standard SDK e qualsiasi altro progetto di tipo SDK, ad esempio quelli destinati a .NET Framework. Per altre informazioni, vedere SDK di progetto .NET.

Per la maggior parte dei comandi, lo strumento dell'interfaccia della riga di comando cerca un file di progetto nella directory corrente, a meno che non venga specificato un file di progetto diverso come opzione facoltativa nel comando. Per un elenco completo dei comandi e dei relativi argomenti, vedere i comandi dell'interfaccia della riga di comando dotnet.

Prerequisiti

.NET Core SDK, che fornisce lo strumento da riga di comando dotnet. A partire da Visual Studio 2017, l'interfaccia della riga di comando dotnet viene installata automaticamente con tutti i carichi di lavoro correlati a .NET e .NET Core.

Installare o aggiornare un pacchetto

Il comando dotnet add package aggiunge un riferimento al pacchetto al file di progetto e quindi viene eseguito dotnet restore per installare il pacchetto.

Aprire una riga di comando e passare alla directory che contiene il file di progetto.
Usare il comando seguente per installare un pacchetto NuGet:
```
dotnet add package <PACKAGE_NAME>
```
Ad esempio, per installare il pacchetto Newtonsoft.Json, usare il comando seguente
```
dotnet add package Newtonsoft.Json
```
Al termine del comando, è possibile aprire il file di progetto per visualizzare il riferimento al pacchetto.

Ad esempio, aprire il file con estensione csproj per visualizzare il riferimento al pacchetto aggiunto Newtonsoft.Json :
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>
```

Installare una versione specifica di un pacchetto

Il dotnet add package comando installa la versione più recente del pacchetto a meno che non si specifichi una versione diversa.

Per installare una versione specifica di un pacchetto NuGet, usare l'opzione o --version facoltativa-v:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Per aggiungere ad esempio la versione 12.0.1 del pacchetto Newtonsoft.Json, usare questo comando:

dotnet add package Newtonsoft.Json --version 12.0.1

Elencare i riferimenti al pacchetto

Elencare i riferimenti e le versioni del pacchetto per il progetto usando il comando dotnet list package :

dotnet list package

Rimuovere un pacchetto

Usare il comando dotnet remove package per rimuovere un riferimento al pacchetto dal file di progetto.

dotnet remove package <PACKAGE_NAME>

Ad esempio, per rimuovere il Newtonsoft.Json pacchetto, usare il comando seguente:

dotnet remove package Newtonsoft.Json

Ripristinare pacchetti

Il comando dotnet restore ripristina i pacchetti elencati dal file di progetto con <PackageReference>. Per altre informazioni, vedere PackageReference nei file di progetto.

.NET Core 2.0 e versioni successive dotnet build e dotnet run comandi ripristinano automaticamente i pacchetti. A partire da NuGet 4.0, dotnet restore esegue lo stesso codice di nuget restore.

Per ripristinare un pacchetto con dotnet restore:

Aprire una riga di comando e passare alla directory che contiene il file di progetto.
Eseguire dotnet restore.