Partilhar 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 é apenas 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 com .NET.

    Você pode instalar a edição Community 2022 gratuitamente a partir do visualstudio.microsoft.comou usar a edição Professional ou Enterprise.

    O Visual Studio 2017 e versões posteriores inclui automaticamente o Gestor de Pacotes NuGet quando uma carga de trabalho relacionada ao .NET é instalada. Para instalá-lo individualmente no Visual Studio Installer, selecione o separador componentes individuais e, em seguida, selecione o gestor de pacotes NuGet em Ferramentas de código.

    Para o Visual Studio 2015, se lhe faltar o Gerenciador de Pacotes NuGet, verifique Ferramentas>Atualizações e Extensões e procure pela extensão Gerenciador de Pacotes NuGet. Se você não conseguir usar o instalador de extensões no Visual Studio, baixe a extensão diretamente do https://dist.nuget.org/index.html.

  • Registe-se para obter uma conta gratuita no nuget.org se ainda não tiver uma. Você deve se 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ções e selecione Projeto>Gerenciar Pacotes NuGet.

    A janela Gerenciador de Pacotes NuGet é aberta.

  2. Selecione a guia Procurar para exibir pacotes por popularidade da fonte selecionada no momento (consulte Fontes de pacotes).

    • Para procurar um pacote específico, use a caixa de pesquisa no canto superior esquerdo.
    • Informações abreviadas podem ser mostradas ao lado de cada ID de pacote para ajudar a identificar o pacote correto e variam com base na(s) fonte(s) do pacote selecionado(s). Os exemplos incluem contagem de download de pacotes, hiperlinks de perfil de autor ou proprietário.

    Observação

    No Visual Studio 17.11 e superior, os proprietários de pacotes são exibidos como hiperlinks de perfil quando a fonte de pacotes selecionada os suporta. 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, o pacote , o autor e os metadados são mostrados, que aparecem como texto sem formatação. Para obter mais informações, consulte Metadados do pacote Autores.

    • Selecione um pacote para ver as informações detalhadas do pacote. O painel de detalhes à direita é exibido e permite que você selecione uma versão para instalar. Captura de tela mostrando a janela do Gerenciador de Pacotes NuGet com a guia Procurar, o painel de detalhes e a guia Você pode ver os metadados do pacote, informações sobre o(s) proprietário(s), autor(es), licença, etc., na guia Detalhes do pacote e o arquivo LEIA-ME do pacote (se for fornecido pelo autor do pacote) na guia LEIA-ME. Captura de tela mostrando a janela do Gerenciador de Pacotes NuGet com a guia LEIA-ME selecionada.

  3. No painel direito, selecione uma versão na lista suspensa. Se quiser incluir versões de pré-lançamento na lista Versão, selecione Incluir pré-lançamento.

  4. Para instalar o pacote NuGet, selecione Instalar. Poderá ser-lhe pedido para aceitar os termos de licença ou ser-lhe pedido para verificar a instalação.

    Visual Studio instala o pacote e suas dependências no projeto. Quando a instalação estiver concluída, os pacotes adicionados aparecerão no separador Instalado. Você também pode encontrar pacotes no nó Dependências>Pacotes do seu projeto no Gerenciador de Soluções. Após instalar um pacote, podes referenciá-lo no projeto com uma declaraçã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 Gerenciador de Pacotes NuGet, selecione Geral e escolha o formato de gerenciamento de pacotes padrão . Para obter mais informações, consulte Escolher o formato de gerenciamento de pacotes padrão.

Desinstalar um pacote

Para desinstalar um pacote NuGet, siga estas etapas:

  1. Carregue um projeto no 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 de pesquisa para localizá-lo, se necessário) e, em seguida, 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 Explorador de Soluções e selecione Projeto>Gerenciar Pacotes NuGet. Para projetos de site, selecione primeiro a pasta Bin.

  2. Selecione o separador Atualizações para ver pacotes com atualizações disponíveis da origem do Pacote selecionado . Selecione Incluir pré-lançamento para adicionar pacotes de pré-lançamento à lista de atualizações.

  3. Selecione o pacote a ser atualizado. No painel direito, selecione a Versão desejada do na lista suspensa 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 Update está desativado e a seguinte mensagem aparece: 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 ou SDK maior e não pode ser atualizado independentemente. 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 tempo de execução 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 os metapacotes e o controle de versão do .NET Core. Esse cenário se aplica aos seguintes pacotes comumente usados:

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

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

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

  6. Você também pode atualizar um pacote individual na guia Instalado. Nesse caso, você também pode selecionar uma versão e a opção Incluir pré-lançamento.

Gerenciar pacotes para a solução

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

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

  2. Na janela Gerir pacotes NuGet para a solução, selecione os projetos que são afetados pelas operações.

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

Guia 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 o separador Consolidar da janela do Gerenciador de Pacotes NuGet para descobrir onde pacotes com números de versão distintos são usados por diferentes projetos 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 ConsoleApp1 está usando EntityFramework 6.1.0. Para consolidar versões de pacote, siga estas etapas:

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

  2. Selecione a versão a ser usada para todos esses projetos na lista Version list.

  3. Selecione Instalar.

    O Gestor de Pacotes NuGet instala a versão do pacote selecionado em todos os projetos selecionados, após o que o pacote não aparece mais no separador Consolidar.

Fontes de pacotes

O Visual Studio ignora a ordem das fontes de pacote e usa o pacote de qualquer fonte que seja a primeira a responder a uma solicitação. Para obter mais informações, consulte Restaurar pacotes. Para obter informações sobre como carregar um pacote de uma fonte específica, consulte Package source mapping.

Para gerenciar fontes de pacotes NuGet, siga estas etapas:

  1. Para mudar a origem de onde o Visual Studio carrega os metadados do pacote, selecione uma origem no seletor de origem do pacote .

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

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

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

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

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

  4. Para adicionar uma fonte, selecione +, edite o Nome, introduza o URL ou o caminho no Origem, e, em seguida, selecione Atualizar.

    A fonte agora aparece na lista suspensa da origem do pacote .

  5. Para alterar a origem de pacote, selecione-a, faça edições nas caixas Nome e Origem e selecione Atualizar.

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

  7. Para remover uma origem de pacote, selecione-a e, em seguida, selecione o botão X.

    Se uma fonte de pacote reaparecer depois de a eliminar, poderá estar listada num ficheiro NuGet.config ao nível do computador ou do utilizador. Para obter o local desses arquivos, consulte Configurações comuns do NuGet. Remova a fonte do pacote nos ficheiros editando-os manualmente ou utilizando o comando nuget sources.

Controle de Opções do Gerenciador de Pacotes NuGet

Quando seleciona um pacote, o Gerenciador de Pacotes NuGet exibe um controlo expansível Opções abaixo do seletor de Versão. Para a maioria dos tipos de projeto, apenas 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

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

  • Comportamento de dependência: Esta opção configura como o NuGet decide quais versões de pacotes dependentes instalar. Ele tem as seguintes configurações:

    • Ignorar dependências ignora a instalação de dependências, o que normalmente quebra o pacote que está sendo instalado.
    • Menor [Padrão] instala a dependência com o número mínimo de versão que atende aos requisitos do pacote principal escolhido.
    • Patch de maior atualização instala a versão com a mesma versão maior e menor, mas com 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
    • Maior número secundário instala a versão com o mesmo número de versão principal, mas o maior número de versão secundária e número de correção. Se a versão 1.2.2 for especificada, a versão mais alta que começa com 1 será instalada
    • Highest instala a versão mais alta disponível do pacote.

  • Ação de conflito de arquivo: Esta opção especifica como o NuGet deve lidar com pacotes que já existem no projeto ou na máquina local. Ele tem as seguintes configurações:

    • Prompt instrui o NuGet a perguntar se deve manter ou substituir pacotes existentes.
    • Ignorar tudo instrui o NuGet a ignorar a substituição de quaisquer pacotes existentes.
    • Substituir tudo instrui o NuGet a substituir quaisquer pacotes existentes.

Opções de desinstalação

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

  • Remover dependências: Quando selecionado, remove quaisquer pacotes dependentes se eles não forem referenciados em nenhuma outra parte do projeto.

  • Força a desinstalação, mesmo que haja dependências: 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 que instalou. O uso desta opção pode, no entanto, levar a referências quebradas no projeto. Nesse caso, talvez seja necessário reinstalar os outros pacotes.

Ver também

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