Instalar e gerenciar pacotes NuGet usando a CLI do dotnet

Artigo
12/22/2023

Você pode usar a ferramenta CLI do dotnet no Windows, macOS ou Linux para instalar, desinstalar e atualizar facilmente pacotes NuGet em projetos e soluções .NET. Este artigo descreve os comandos mais comuns da CLI di dotnet para gerenciar pacotes NuGet.

A CLI do dotnet é executada em projetos estilo .NET, .NET Core, .NET Standard SDK e quaisquer outros projetos no estilo SDK, por exemplo, aqueles destinados ao .NET Framework. Para obter mais informações, confira SDKs de Projeto do .NET

Para a maioria dos comandos, a ferramenta de CLI procura um arquivo de projeto no diretório atual, a menos que um arquivo de projeto seja especificado no comando. Para obter uma lista completa de comandos e seus argumentos, consulte Comandos da CLI do dotnet.

Pré-requisitos

O SDK do .NET Core, que fornece a ferramenta de linha de comando dotnet. No Visual Studio 2017 em diante, a CLI do dotnet é instalada automaticamente com qualquer carga de trabalho relacionada ao .NET Core.

Instalar ou atualizar um pacote

O comando dotnet add package adiciona uma referência de pacote ao arquivo de projeto e, em seguida, executa dotnet restore para instalar o pacote.

Abra uma linha de comando e alterne para o diretório que contém o arquivo de projeto.
Use o seguinte comando para instalar um pacote NuGet:
```
dotnet add package <PACKAGE_NAME>
```
Por exemplo, para instalar o pacote Newtonsoft.Json, use o comando a seguir
```
dotnet add package Newtonsoft.Json
```
Após a conclusão do comando, abra o arquivo de projeto para ver a referência de pacote:

Por exemplo, abra o arquivo .csproj para ver a referência de pacote Newtonsoft.Json adicionada:
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>
```

Instalar uma versão específica de um pacote

O comando dotnet add package instala a última versão do pacote, a menos que você especifique uma versão diferente.

Para instalar uma versão específica de um pacote NuGet, use a opção -v ou --version opcional:

dotnet add package <PACKAGE_NAME> -v <VERSION>

Por exemplo, para adicionar a versão 12.0.1 do pacote Newtonsoft.Json, use este comando:

dotnet add package Newtonsoft.Json --version 12.0.1

Listar as referências de pacote

Liste as referências e versões de pacote para o projeto usando o comando dotnet list package.

dotnet list package

Remover um pacote

Use o comando dotnet remove package para remover uma referência de pacote do arquivo de projeto.

dotnet remove package <PACKAGE_NAME>

Por exemplo, para remover o pacote Newtonsoft.Json, use o seguinte comando:

dotnet remove package Newtonsoft.Json

Restaurar pacotes

O comando dotnet restore restaura pacotes que o arquivo de projeto lista com <PackageReference>. Para obter mais informações, consulte PackageReference em arquivos de projeto.

Os comandos dotnet build e dotnet run do .NET Core 2.0 em diante restauram os pacotes automaticamente. No NuGet 4.0, dotnet restore executa o mesmo código que nuget restore.

Para restaurar um pacote com dotnet restore:

Abra uma linha de comando e alterne para o diretório que contém o arquivo de projeto.
Execute dotnet restore.