Instalar e gerenciar pacotes NuGet com a CLI dotnet

Pode usar a ferramenta dotnet de linha de comandos (CLI) 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 dotnet para gerenciar pacotes NuGet.

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

Para a maioria dos comandos, a ferramenta 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 dotnet CLI commands.

Pré-requisitos

O .NET SDK, que fornece a CLI dotnet. No Visual Studio, a CLI dotnet instala-se automaticamente com todas as cargas de trabalho relacionadas com .NET.

Instalar ou atualizar um pacote

O comando dotnet package add adiciona uma referência ao ficheiro do projeto e depois executa dotnet restore para instalar o pacote.

  1. Abra uma janela de linha de comandos e vá ao diretório que contém o ficheiro do seu 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 estiver a utilizar .NET 9 ou anterior, use a forma com o verbo em primeiro lugar do comando:

    dotnet add package <package-name>

  3. Depois de o comando terminar, abra o ficheiro do projeto para verificar a referência do pacote.

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

    <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 -v ou --version opcional:

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 pacotes

Podes usar o comando dotnet package list para listar as referências e versões dos pacotes do teu projeto. A partir do diretório que contém o ficheiro do seu projeto, execute o seguinte comando:

dotnet package list

Se estiver a utilizar o .NET 9 ou uma versão anterior, utilize em vez disso a forma na qual o verbo aparece em primeiro lugar:

dotnet list package

Remover um pacote

Podes usar o comando dotnet package remove para remover uma referência de pacote do ficheiro do projeto. A partir do diretório que contém o ficheiro do seu 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 estiver a utilizar o .NET 9 ou uma versão anterior, utilize em vez disso a forma na qual o verbo aparece em primeiro lugar:

dotnet remove package <package-name>

Restaurar pacotes

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

A partir de .NET Core 2.0 e continuando até .NET, os comandos dotnet build e dotnet run restauram automaticamente os pacotes, tal como muitos outros comandos dotnet CLI. A partir do NuGet 4.0, dotnet restore executa o mesmo código do nuget restore comando CLI do NuGet.

Para restaurar pacotes usando dotnet restore:

  1. Abra uma janela de linha de comandos e vá ao diretório que contém o ficheiro do seu projeto.
  2. Execute dotnet restore.

Conteúdo relacionado

  • Last updated on