Compartilhar via

Instalar e gerenciar pacotes NuGet com a CLI do dotnet

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

A CLI do dotnet é executada em projetos no estilo .NET, .NET Core, SDK do .NET Standard e quaisquer outros projetos no estilo SDK, por exemplo, aqueles destinados ao .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 do .NET Core, que fornece a ferramenta dotnet de linha de comando. A partir do Visual Studio 2017, a CLI do dotnet é instalada automaticamente com todas as cargas de trabalho relacionadas ao .NET e 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, é executado dotnet restore para instalar o pacote.

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

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

    dotnet add package <PACKAGE_NAME>

    Por exemplo, para instalar o Newtonsoft.Json pacote, use o comando a seguir

    dotnet add package Newtonsoft.Json

  3. Depois que o comando for concluído, você poderá abrir o arquivo de projeto para ver a referência do pacote.

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

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

Instalar uma versão específica de um pacote

O dotnet add package 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 add package <PACKAGE_NAME> -v <VERSION>

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

dotnet add package Newtonsoft.Json --version 12.0.1

Listar referências de pacote

Liste as referências e versões do pacote para seu projeto usando o comando do pacote de lista dotnet :

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 Newtonsoft.Json pacote, use o seguinte comando:

dotnet remove package Newtonsoft.Json

Restaurar pacotes

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

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

Para restaurar um pacote com dotnet restore:

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

Próximas etapas

  • Last updated on