Compartilhar via


Instalar e gerenciar pacotes no Visual Studio usando o Gerenciador de Pacotes NuGet

A interface do usuário do Gerenciador de Pacotes NuGet no Microsoft Visual Studio para Windows permite que você instale, desinstale e atualize facilmente pacotes NuGet em projetos e soluções.

O artigo é somente para usuários do Windows. Se você estiver usando o Visual Studio para Mac, consulte Incluindo um pacote NuGet em seu projeto.

Pré-requisitos

  • Instale o Visual Studio 2022 para Windows com qualquer carga de trabalho relacionada ao .NET.

    Você pode instalar a edição Community 2022 gratuitamente de visualstudio.microsoft.comou usar a edição Profissional ou Enterprise.

    O Visual Studio 2017 e versões superiores incluem automaticamente o Gerenciador de Pacotes NuGet quando uma carga de trabalho relacionada ao .NET é instalada. Para instalá-lo individualmente no Instalador do Visual Studio, selecione a guia Componentes individuais e, em seguida, selecione o gerenciador de pacotes NuGet em Ferramentas de código.

    Para o Visual Studio 2015, se você não tiver o Gerenciador de Pacotes NuGet, verifique Ferramentas >Extensões e Atualizações e pesquise a extensão Gerenciador de Pacotes NuGet . Se não for possível usar o instalador de extensões no Visual Studio, baixe a extensão diretamente do https://dist.nuget.org/index.html.

  • Registre-se para uma conta gratuita no nuget.org se você ainda não tiver uma. Você deve registrar e confirmar a conta antes de carregar um pacote NuGet.

Localizar e instalar um pacote

Para localizar e instalar um pacote NuGet com o Visual Studio, siga estas etapas:

  1. Carregue um projeto no Gerenciador de Soluçõese, em seguida, selecione Projeto>Gerenciar Pacotes NuGet.

    A janela do Gerenciador de Pacotes do NuGet é aberta.

  2. Selecione a guia Procurar para exibir pacotes por popularidade na origem selecionada no momento (consulte Fontes do Pacote).

    • Para pesquisar um pacote específico, use a caixa de pesquisa no canto superior esquerdo.
    • Informações abreviadas podem ser mostradas ao lado de cada ID do pacote para ajudar a identificar o pacote correto e variam de acordo com as fontes do pacote selecionadas. Exemplos incluem hiperlinks de perfil do autor ou proprietário, e contagens de download de pacote.

    Nota

    No Visual Studio 17.11 e superior, os proprietários de pacotes são mostrados como hiperlinks de perfil quando suportados pela origem do pacote selecionado. A propriedade do pacote é definida pela origem do pacote. Por exemplo, consulte Gerenciar proprietários de pacotes no nuget.org.

    No Visual Studio 17.10 e anteriores, os metadados do pacote autor são mostrados, aparecendo como texto sem formatação. Para obter mais informações, consulte os metadados do pacote Authors.

    • Selecione um pacote para ver informações detalhadas do pacote. O painel de detalhes à direita é exibido e permite que você selecione uma versão a ser instalada. Captura de tela mostrando a janela do Gerenciador de Pacotes Do NuGet com a guia Procurar, o painel de detalhes e a guia Você pode ver metadados do pacote, informações sobre os proprietários, os autores, a licença etc., na guia Detalhes do Pacote e o arquivo README do pacote (se for fornecido pelo autor do pacote) na guia LEIAME. Captura de tela mostrando a janela do Gerenciador de Pacotes NuGet com a guia LEIAME selecionada.
  3. No painel direito, selecione uma versão na lista suspensa. Se você quiser incluir versões de pré-lançamento na lista de versões , selecione Incluirde pré-lançamento.

  4. Para instalar o pacote NuGet, selecione Instalar. Você pode ser solicitado a aceitar os termos de licença ou solicitado a verificar a instalação.

    O Visual Studio instala o pacote e suas dependências no projeto. Quando a instalação for concluída, os pacotes adicionados aparecerão na guia Instalado. Você também pode encontrar pacotes no nó Dependências>Pacotes do projeto no Gerenciador de Soluções do . Depois de instalar um pacote, você pode fazer referência a ele no projeto com uma instrução using.

  5. (Opcional) O NuGet tem dois formatos nos quais um projeto pode usar pacotes: PackageReference e packages.config. Para definir o formato padrão, selecione Ferramentas>Opções, expanda do Gerenciador de Pacotes Do NuGet, selecione Geral e escolha o formato de gerenciamento de pacote padrão . Para obter mais informações, consulte Escolher o formato de gerenciamento de pacote padrão.

Desinstalar um pacote

Para desinstalar um pacote NuGet, siga estas etapas:

  1. Carregue um projeto no do Gerenciador de Soluções, selecione Projeto>Gerenciar Pacotes NuGete, em seguida, selecione a guia Instalado.

  2. Selecione o pacote a ser desinstalado no painel esquerdo (use a caixa Pesquisar para localizá-lo, se necessário) e selecione Desinstalar no painel direito.

    Captura de tela mostrando o Gerenciador de Pacotes NuGet com um pacote selecionado e seu botão Desinstalar realçado.

Atualizar um pacote

Para atualizar um pacote NuGet, siga estas etapas:

  1. Carregue um projeto no Gerenciador de Soluções e selecione Projeto>Gerenciar Pacotes NuGet. Para projetos de site, selecione a pasta Bin primeiro.

  2. Selecione a guia Atualizações para ver os pacotes que têm atualizações disponíveis da fonte de pacotesselecionada. Selecione Incluir pacotes de pré-lançamento para adicioná-los à lista de atualizações.

  3. Selecione o pacote a ser atualizado. No painel direito, selecione a versão desejada no menu suspenso e, em seguida, selecione Atualizar.

    Captura de tela mostrando o Gerenciador de Pacotes NuGet com um pacote selecionado e seu botão Atualizar realçado.

  4. Para alguns pacotes, o botão Atualizar está desabilitado e a seguinte mensagem é exibida: referenciado implicitamente por um SDK. Para atualizar o pacote, atualize o SDK ao qual ele pertence. Esta mensagem indica que o pacote faz parte de uma estrutura maior ou SDK e não pode ser atualizado de forma independente. Esses pacotes são marcados internamente com <IsImplicitlyDefined>True</IsImplicitlyDefined>. Por exemplo, Microsoft.NETCore.App faz parte do SDK do .NET Core e a versão do pacote é diferente da versão da estrutura de runtime usada pelo aplicativo. Para baixar uma nova versão do .NET Core, atualize sua instalação do .NET Core. Para obter mais informações, consulte metapacotes do .NET Core ede controle de versão. Esse cenário se aplica aos seguintes pacotes comumente usados:

    • Microsoft.AspNetCore.All
    • Microsoft.AspNetCore.App
    • Microsoft.NETCore.App
    • NETStandard.Library

    Captura de tela mostrando um pacote NuGet com o botão Atualizar desabilitado.

  5. Para atualizar vários pacotes para suas versões mais recentes, escolha-os na lista de pacotes do NuGet e selecione Atualizar.

  6. Você pode também atualizar um pacote individual da guia Instalado. Nesse caso, também é possível selecionar uma Versão e a opção Incluir pré-lançamentos.

Gerenciar pacotes para a solução

Gerenciar pacotes para uma solução é um meio conveniente para trabalhar com vários projetos simultaneamente:

  1. Selecione uma solução no Gerenciador de Soluçõese, em seguida, selecione Ferramentas>Gerenciador de Pacotes NuGet>Gerenciar Pacotes NuGet para Solução.

  2. Na janela Gerenciar Pacotes NuGet para solução, selecione os projetos afetados pelas operações.

    Captura de tela mostrando a janela Gerenciar Pacotes para solução com vários projetos selecionados.

Aba Consolidar

Os desenvolvedores normalmente consideram uma má prática usar versões diferentes do mesmo pacote NuGet em diferentes projetos na mesma solução. O Visual Studio permite que você use uma versão comum para seus pacotes NuGet. Para fazer isso, use a guia Consolidar da janela do Gerenciador de Pacotes do NuGet para descobrir onde os pacotes com números de versão distintos são usados por projetos diferentes na solução.

Captura de tela mostrando a janela Gerenciar Pacotes para solução com a guia Consolidar selecionada.

Neste exemplo, o projeto ClassLibrary1 está usando EntityFramework 6.2.0, enquanto o ConsoleApp1 está usando EntityFramework 6.1.0. Para consolidar as versões do pacote, siga estas etapas:

  1. Na guia Consolidar, selecione os projetos a serem atualizados na lista de projetos.

  2. Selecione a versão na lista de Versão para ser usada em todos esses projetos.

  3. Selecione Instalar.

    O Gerenciador de Pacotes NuGet instala a versão selecionada do pacote em todos os projetos escolhidos; depois disso, o pacote não aparece mais na guia Consolidar.

Fontes do pacote

O Visual Studio ignora a ordem das fontes do pacote e usa o pacote de qualquer origem que seja a primeira a responder a uma solicitação. Para obter mais informações, consulte Pacotes de restauração. Para obter informações sobre como carregar um pacote de uma fonte específica, consulte Mapeamento de origem do pacote.

Para gerenciar fontes de pacote do NuGet, siga estas etapas:

  1. Para alterar a origem da qual o Visual Studio carrega metadados do pacote, selecione uma origem no seletor de origem do pacote.

    Captura de tela mostrando o seletor de origem do pacote realçado.

  2. Para gerenciar suas fontes de pacote, selecione o ícone Configurações ou selecione Ferramentas>Opções.

    Captura de tela mostrando o ícone de configurações de origem do pacote realçado.

  3. Na janela Opções, expanda o nó Gerenciador de Pacotes NuGet e selecione Fontes do Pacote.

    Captura de tela mostrando a janela Opções com fontes de pacote selecionadas.

  4. Para adicionar uma origem, selecione +, edite o Nome , insira a URL ou o caminho em Origem , e em seguida selecione Atualizar .

    A origem agora aparece na lista suspensa de origem do pacote.

  5. Para alterar uma origem do pacote, selecione-a, edite as caixas Nome e Origem, e depois selecione Atualizar.

  6. Para desabilitar uma fonte de pacote, desmarque a caixa à esquerda do nome na lista.

  7. Para remover uma fonte de pacote, selecione-a e depois selecione o botão X.

    Se uma fonte de pacote reaparecer depois de excluí-la, ela poderá ser listada em um arquivo de NuGet.config no nível do computador ou no nível do usuário. Para obter o local desses arquivos, consulte configurações comuns do NuGet. Remova a origem do pacote nos arquivos editando-os manualmente ou usando o comando de fontes do NuGet.

Opções de controle do Gerenciador de Pacotes NuGet

Quando você seleciona um pacote, o Gerenciador de Pacotes do NuGet exibe um controle de Opções expansível abaixo do seletor de Versão . Para a maioria dos tipos de projeto, somente a opção Mostrar janela de visualização é fornecida.

Captura de tela mostrando o controle Opções do Gerenciador de Pacotes NuGet expandido.

As seções a seguir explicam as opções disponíveis.

Opções de instalação e atualização

Essas opções estão disponíveis apenas para determinados tipos de projeto:

  • comportamento de dependência: essa opção configura como o NuGet decide quais versões de pacotes dependentes serão instaladas. Ele tem as seguintes configurações:

    • Ignorar dependências ignora a instalação de dependências, o que normalmente interrompe o pacote que está sendo instalado.
    • Lowest [Padrão] instala a dependência com a versão mínima que atende aos requisitos do pacote principal escolhido.
    • o patch mais alto instala a versão com os mesmos números de versão principal e secundária, mas o número de patch mais alto. Por exemplo, se a versão 1.2.2 for especificada, a versão mais alta que começa com a 1.2 será instalada
    • instala a versão com o mesmo número de versão principal, mas com o maior número de versão menor e número de patch. Se a versão 1.2.2 for especificada, a versão mais alta que começa com 1 será instalada
    • a versão mais alta instala a versão mais recente disponível do pacote.
  • Ação de conflito de arquivo: essa opção especifica como o NuGet deve lidar com pacotes que já existem no projeto ou no computador local. Ele tem as seguintes configurações:

    • Prompt instrui o NuGet a perguntar se deseja manter ou substituir pacotes existentes.
    • Ignorar Todos os instrui o NuGet a ignorar a substituição de todos os pacotes existentes.
    • Substituir Todos os instrui o NuGet a substituir todos os pacotes existentes.

Opções de desinstalação

Essas opções estão disponíveis apenas para determinados tipos de projeto:

  • Remover dependências: quando selecionada, remove todos os pacotes dependentes se eles não forem referenciados em outro lugar do projeto.

  • Forçar a desinstalação mesmo que haja dependências nele: quando selecionado, desinstala um pacote mesmo que ele ainda esteja sendo referenciado no projeto. Essa opção normalmente é usada em combinação com Remover dependências para remover um pacote e quaisquer dependências instaladas. No entanto, usar essa opção pode levar a referências quebradas no projeto. Nesse caso, talvez seja necessário reinstalar esses outros pacotes.

  • Encontre vídeos do NuGet no Canal 9 e no YouTube .

Consulte também

Para obter mais informações sobre o NuGet, consulte os seguintes artigos: