Opções do Gerenciador de Pacotes NuGet no Visual Studio

O Visual Studio fornece várias páginas de opções para configurar o comportamento do Gerenciador de Pacotes NuGet. As definições de configuração do NuGet são armazenadas no (s) seu(s) arquivo(s) NuGet.Config.

Acessando as opções do NuGet

Há várias maneiras de acessar as opções do Gerenciador de Pacotes NuGet:

1. No menu principal: vá para Opções de Ferramentas >e expanda Gerenciador de Pacotes NuGet no painel esquerdo.
2. No menu NuGet localizado no comando de menu Configurações > do Gerenciador > de Pacotes NuGet Ferramentas .
3. Pesquisa rápida: use a pesquisa do Visual Studio para pesquisar "NuGet" ou um nome de configuração relacionado ao NuGet, para ir rapidamente para a página Opções.
4. Na interface do usuário do Gerenciador de Pacotes: pressione o ícone de configurações (engrenagem) na barra de ferramentas da interface do usuário do Gerenciador de Pacotes.
5. No Console do Gerenciador de Pacotes: Clique no ícone de configurações (engrenagem) na barra de ferramentas do Console do Gerenciador de Pacotes.

General

A página Opções gerais contém configurações que controlam o comportamento de gerenciamento de pacotes do NuGet.

Restauração de pacotes

Configurações para restauração automática de pacotes durante operações de compilação:

• Permitir que o NuGet baixe pacotes ausentes: selecione para habilitar a restauração de pacotes e o comando Restaurar pacotes NuGet.
• Verificar automaticamente se há pacotes ausentes durante a compilação no Visual Studio: Selecione para restaurar automaticamente quaisquer pacotes ausentes quando você executar uma compilação do Visual Studio.

Consulte Restauração de pacotes para obter mais informações sobre o comportamento de restauração de pacotes.

Redirecionamentos de vinculação

• Ignorar a aplicação de redirecionamentos de vinculação: quando habilitado, o NuGet não adicionará ou atualizará automaticamente redirecionamentos de vinculação em arquivos app.config ou web.config durante a instalação ou atualizações do pacote

Gestão de Pacotes

• Formato de gerenciamento de pacotes padrão: escolha entre os formatos NuGet PackageReference (recomendado para a maioria dos projetos) e packages.config (formato herdado para projetos mais antigos). Para obter mais informações, consulte Escolher formato de gerenciamento de pacotes padrão.

  • PackageReference: Armazena referências de pacotes diretamente em arquivos de projeto. Este é o formato moderno que suporta melhor resolução de dependência e é necessário para projetos no estilo SDK
  • packages.config: Formato de arquivo XML herdado que armazena informações do pacote separadamente do arquivo de projeto

• Solicitar seleção de formato na primeira instalação do pacote: Quando habilitado, o Visual Studio solicitará que você escolha entre PackageReference e packages.config na primeira vez que instalar um pacote em um projeto que ainda não tenha pacotes.

Limpar recursos locais do NuGet

O botão de comando Limpar Recursos Locais do NuGet permite limpar os caches locais do NuGet, incluindo:

• http-cache: Pacotes e metadados de pacotes baixados
• global-packages: pasta de pacotes instalados
• temp: Arquivos temporários
• plugins-cache: Resultados da operação do plugin

Para obter mais informações sobre caches e pastas do NuGet, consulte Gerenciando pacotes globais, cache e pastas temporárias.

Arquivos de configuração

A página de opções Arquivos de configuração exibe os arquivos NuGet.Config que se aplicam à sua solução atual e permite que você os abra diretamente no Visual Studio para edição.

Para editar um arquivo, selecione um caminho de arquivo e pressione o botão "Abrir". O arquivo será aberto em uma nova guia no Visual Studio, onde pode ser editado diretamente.

Os arquivos de configuração são listados em ordem da prioridade mais alta para a mais baixa. O NuGet usa um sistema de configuração hierárquica onde as configurações de vários arquivos de configuração são mescladas. Para obter mais informações, consulte Configurações comuns do NuGet.

Fontes de pacotes

A página de opções Fontes de pacotes permite gerenciar as fontes das quais o NuGet baixa pacotes.

Gerenciando códigos-fonte de pacotes

Lista todas as fontes de pacotes configuradas de acordo com seus arquivos NuGet.Config.

• Nome: Nome para exibição da fonte
• Fonte: URL ou caminho do arquivo para a origem do pacote
• Caixa de seleção Habilitado: habilite ou desabilite uma fonte sem removê-la.
• Permitir conexões inseguras: habilitar ou desabilitar a permissão de conexões HTTP inseguras

Para modificar, use os botões Adicionar, Editar e Remover abaixo da tabela. As caixas de seleção podem ser alternadas diretamente na tabela. Pressione "Salvar" na caixa de diálogo Adicionar/Editar e as alterações serão atualizadas no arquivo NuGet.Config relevante.

Fontes de pacotes em toda a máquina

As fontes de pacotes definidas no nível da máquina aparecem em uma seção dedicada abaixo. Eles geralmente são provisionados por cargas de trabalho do Visual Studio e só podem ser habilitados ou desabilitados usando a caixa de seleção na coluna Habilitado.

Permitir conexões inseguras

Por motivos de segurança, o NuGet impõe o uso de fontes HTTPS por padrão. Se você precisar usar uma fonte HTTP, deverá permiti-la explicitamente. Quando uma fonte HTTP é usada, a primeira coluna da tabela Fontes de Pacote mostrará um ícone com informações sobre um aviso ou um erro com a fonte do pacote nessa linha.

⚠️ Quando uma fonte de pacote HTTP é usada e Permitir conexões inseguras está habilitado, um aviso é mostrado na coluna de status mais à esquerda:

As fontes HTTP são inseguras. Em vez disso, considere o uso de HTTPS. 'AllowInsecureConnections' está habilitado, permitindo acesso HTTP.

❌ Quando uma fonte HTTP é usada e Permitir conexões não seguras é desabilitado, um erro é mostrado na coluna de status mais à esquerda e a restauração do NuGet falhará:

O NuGet requer fontes HTTPS. Para usar uma fonte HTTP, você deve definir explicitamente 'allowInsecureConnections' como true no arquivo NuGet.Config.

Para obter mais informações sobre como configurar permissões de origem HTTP, consulte https://aka.ms/nuget-https-everywhere.

Mapeamento de origem do pacote

O Mapeamento de Origem de Pacotes permite controlar quais fontes de pacotes são usadas para pacotes específicos, melhorando a segurança da cadeia de suprimentos.

Para modificar, use os botões Adicionar, Editar e Remover abaixo da tabela.

Gerenciando mapeamentos de origem de pacotes

Lista todos os mapeamentos de origem de pacote configurados de acordo com seus arquivos NuGet.Config.

• Padrão de pacote: padrão de pacote que está atualmente mapeado (por exemplo, Microsoft.* ou Contoso.Contracts)
• Fonte: Uma ou mais fontes de pacote mapeadas para o padrão de pacote. As fontes de pacotes devem estar habilitadas para serem mostradas.

Para modificar, use os botões Adicionar, Editar e Remover abaixo da tabela. Pressione "Salvar" na caixa de diálogo Adicionar/Editar e as alterações serão atualizadas no arquivo NuGet.Config relevante.

Para obter mais informações, consulte Mapeamento da fonte do pacote.

Mapeamentos de origem inválidos

Se uma fonte de pacote listada no mapeamento de origem existente não estiver habilitada no(s) arquivo(s) NuGet.Config, um erro aparecerá na coluna mais à esquerda.

Certifique-se de que todos os valores Source em seus mapeamentos se referem a fontes de pacote que estão disponíveis e habilitadas. Caso contrário, o mapeamento pode não funcionar conforme o esperado.