Partilhar via

Instalar e gerenciar pacotes NuGet com a CLI dotnet

Você pode usar a ferramenta dotnet 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 é executada em projetos no 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, 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 SDK do .NET Core, que fornece a ferramenta de linha de comandos dotnet. A partir do Visual Studio 2017, a CLI 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 seguinte comando

    dotnet add package Newtonsoft.Json

  3. Após a conclusão do comando, você pode 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 -v ou --version opcional:

dotnet add package <PACKAGE_NAME> -v <VERSION>

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

dotnet add package Newtonsoft.Json --version 12.0.1

Listar referências de pacotes

Liste as referências e versões do pacote para seu 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 Newtonsoft.Json pacote, use o seguinte comando:

dotnet remove package Newtonsoft.Json

Restaurar pacotes

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

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

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óximos passos

  • Last updated on