Instalar e gerenciar pacotes NuGet com a CLI do dotnet

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

A CLI do .NET é executada em projetos no estilo SDK do .NET, .NET Core, .NET Standard e quaisquer outros projetos no estilo SDK, por exemplo, aqueles que visam o .NET Framework. Para obter mais informações, consulte SDKs de projeto do .NET.

Para a maioria dos comandos, a ferramenta da CLI procura um arquivo de projeto no diretório atual, a menos que um arquivo de projeto diferente seja especificado como uma opção opcional no comando. Para obter uma lista completa de comandos e seus argumentos, consulte os comandos da CLI do dotnet.

Pré-requisitos

O SDK .NET, que fornece a CLI do .NET. Em Visual Studio, a CLI do dotnet é instalada automaticamente com todas as cargas de trabalho relacionadas a .NET.

Instalar ou atualizar um pacote

O comando adicionar pacote dotnet adiciona uma referência de pacote ao arquivo de projeto e, em seguida, é executado dotnet restore para instalar o pacote.

  1. Abra uma janela de linha de comando e vá para o diretório que contém o arquivo de projeto.

  2. Use o seguinte comando para instalar um pacote NuGet:

    dotnet package add <package-name>

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

    dotnet package add Newtonsoft.Json

    Se você estiver usando .NET 9 ou anterior, use a forma de verbo primeiro do comando em vez disso:

    dotnet add package <package-name>

  3. Depois que o comando for concluído, abra o arquivo de projeto para verificar a referência do pacote.

    Por exemplo, abra o arquivo .csproj e verifique a referência de pacote adicionada Newtonsoft.Json :

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

Instalar uma versão específica de um pacote

O dotnet package add comando instala a versão mais recente 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 opcional -v ou --version.

dotnet package add <package-name> -v <version>

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

dotnet package add Newtonsoft.Json --version 13.0.1

Listar referências de pacote

Você pode usar o comando da lista de pacotes dotnet para listar as referências e versões do pacote para seu projeto. No diretório que contém o arquivo de projeto, execute o seguinte comando:

dotnet package list

Se você estiver usando .NET 9 ou anterior, use a forma com verbo primeiro em vez disso.

dotnet list package

Remover um pacote

Você pode usar o comando remover o pacote dotnet para remover uma referência de pacote do arquivo de projeto. No diretório que contém o arquivo de projeto, execute o seguinte comando:

dotnet package remove <package-name>

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

dotnet package remove Newtonsoft.Json

Se você estiver usando .NET 9 ou anterior, use a forma com verbo primeiro em vez disso.

dotnet remove package <package-name>

Restaurar pacotes

O dotnet restore comando restaura pacotes listados em <PackageReference> elementos no arquivo de projeto. Para obter mais informações, consulte PackageReference os arquivos do projeto.

Começando com o .NET Core 2.0 e continuando por .NET, os comandos dotnet build e dotnet run restauram pacotes automaticamente, assim como muitos outros comandos da CLI do dotnet. A partir do NuGet 4.0, dotnet restore executa o mesmo código que o comando da CLI do nuget restore NuGet.

Para restaurar pacotes usando dotnet restore:

  1. Abra uma janela de linha de comando e vá para o diretório que contém o arquivo de projeto.
  2. Execute dotnet restore.

Conteúdo relacionado

  • Last updated on