Installare e gestire pacchetti usando l'interfaccia della riga di comando di dotnetInstall and manage packages using the dotnet CLI

Lo strumento della riga di comando consente di installare, disinstallare e aggiornare facilmente pacchetti NuGet in progetti e soluzioni.The CLI tool allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Viene eseguito in Windows, Mac OS X e Linux.It runs on Windows, Mac OS X, and Linux.

L'interfaccia della riga di comando di dotnet viene usata per i progetti .NET Core e .NET Standard (tipi di progetto in stile SDK) e per qualsiasi altro progetto in stile SDK, ad esempio i progetti in stile SDK per .NET Framework.The dotnet CLI is for use in your .NET Core and .NET Standard project (SDK-style project types), and for any other SDK-style projects (for example, an SDK-style project that targets .NET Framework). Per altre informazioni, vedere Attributo SDK.For more information, see SDK attribute.

Questo articolo illustra l'utilizzo di base di alcuni dei comandi più comuni dell'interfaccia della riga di comando di dotnet.This article shows you basic usage for a few of the most common dotnet CLI commands. Per la maggior parte di questi comandi, lo strumento della riga di comando cerca un file di progetto nella directory corrente, a meno che non venga specificato un file di progetto nel comando. Il file di progetto è un'opzione facoltativa.For most of these commands, the CLI tool looks for a project file in the current directory, unless a project file is specified in the command (the project file is an optional switch). Per un elenco completo dei comandi e degli argomenti che è possibile usare, vedere Strumenti dell'interfaccia della riga di comando di .NET Core.For a complete list of commands and the arguments you may use, see the .NET Core command-line interface (CLI) tools.

PrerequisitiPrerequisites

  • .NET Core SDK, che fornisce lo strumento da riga di comando dotnet.The .NET Core SDK, which provides the dotnet command-line tool. A partire da Visual Studio 2017, l'interfaccia della riga di comando di dotnet viene installata automaticamente con qualsiasi carico di lavoro .NET Core correlato.Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.

Installa un pacchettoInstall a package

Il comando dotnet add package aggiunge un riferimento al pacchetto nel file di progetto, quindi esegue dotnet restore per installare il pacchetto.dotnet add package adds a package reference to the project file, then runs dotnet restore to install the package.

  1. Aprire una riga di comando e passare alla directory che contiene il file di progetto.Open a command line and switch to the directory that contains your project file.

  2. Usare il comando seguente per installare un pacchetto Nuget:Use the following command to install a Nuget package:

    dotnet add package <PACKAGE_NAME>
    

    Ad esempio, per installare il pacchetto Newtonsoft.Json, usare il comando seguenteFor example, to install the Newtonsoft.Json package, use the following command

    dotnet add package Newtonsoft.Json
    
  3. Dopo aver eseguito il comando, esaminare il file di progetto per assicurarsi che il pacchetto sia stato installato.After the command completes, look at the project file to make sure the package was installed.

    È possibile aprire il file .csproj per visualizzare il riferimento aggiunto:You can open the .csproj file to see the added reference:

    <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="12.0.1" />
    </ItemGroup>
    

Installare una versione specifica di un pacchettoInstall a specific version of a package

Se la versione non viene specificata, NuGet installa la versione più recente del pacchetto.If the version is not specified, NuGet installs the latest version of the package. È anche possibile usare il comando dotnet add package per installare una versione specifica di un pacchetto Nuget:You can also use the dotnet add package command to install a specific version of a Nuget package:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Per aggiungere ad esempio la versione 12.0.1 del pacchetto Newtonsoft.Json, usare questo comando:For example, to add version 12.0.1 of the Newtonsoft.Json package, use this command:

dotnet add package Newtonsoft.Json -v 12.0.1

Elencare i riferimenti al pacchettoList package references

È possibile elencare i riferimenti al pacchetto per il progetto usando il comando dotnet list package.You can list the package references for your project using the dotnet list package command.

dotnet list package

Rimuovere un pacchettoRemove a package

Usare il comando dotnet remove package per rimuovere un riferimento al pacchetto dal file di progetto.Use the dotnet remove package command to remove a package reference from the project file.

dotnet remove package <PACKAGE_NAME>

Ad esempio, per rimuovere il pacchetto Newtonsoft.Json, usare il comando seguenteFor example, to remove the Newtonsoft.Json package, use the following command

dotnet remove package Newtonsoft.Json

Aggiornare un pacchettoUpdate a package

Se la versione del pacchetto non viene specificata, NuGet installa la versione del pacchetto più recente quando si usa il comando dotnet add package (opzione -v).NuGet installs the latest version of the package when you use the dotnet add package command unless you specify the package version (-v switch).

Ripristinare pacchettiRestore packages

Usare il comando dotnet restore che ripristina i pacchetti elencati nel file di progetto (vedere PackageReference).Use the dotnet restore command, which restores packages listed in the project file (see PackageReference). Con .NET Core 2.0 e versioni successive, il ripristino viene eseguito automaticamente con dotnet build e dotnet run.With .NET Core 2.0 and later, restore is done automatically with dotnet build and dotnet run. A partire da NuGet 4.0, esegue lo stesso codice di nuget restore.As of NuGet 4.0, this runs the same code as nuget restore.

Come per gli altri comandi dell'interfaccia della riga di comando dotnet, aprire prima di tutto una riga di comando e passare alla directory che contiene il file di progetto.As with the other dotnet CLI commands, first open a command line and switch to the directory that contains your project file.

Per ripristinare un pacchetto tramite dotnet restore:To restore a package using dotnet restore:

dotnet restore