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 configurações do NuGet são armazenadas em seus arquivos NuGet.Config.

Acessando opções do NuGet

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

1. No menu principal: vá para Opções de Ferramentas >e expanda o Gerenciador de Pacotes NuGet no painel esquerdo.
2. No menu NuGet encontrado no comando de menu Configurações do Gerenciador de Pacotes do Gerenciador de Pacotes > do NuGet das 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.

Geral

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

Restauração de pacote

Configurações para restauração automática de pacote durante operações de build:

• Permitir que o NuGet baixe pacotes ausentes: selecione para habilitar a restauração do pacote e o comando Restaurar Pacotes NuGet.
• Verifique automaticamente se há pacotes ausentes durante o build no Visual Studio: selecione para restaurar automaticamente todos os pacotes ausentes ao executar um build do Visual Studio.

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

Redirecionamentos de associação

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

Gerenciamento de Pacotes

• Formato de gerenciamento de pacote 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 o formato de gerenciamento de pacote padrão.

  • PackageReference: armazena referências de pacote diretamente em arquivos de projeto. Esse é o formato moderno que dá suporte a uma 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 a 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 do pacote baixados
• pacotes globais: pasta de pacotes instalados
• temp: arquivos temporários
• plugins-cache: resultados da operação de plug-in

Para obter mais informações sobre caches e pastas do NuGet, consulte Gerenciando os pacotes globais, o cache e as 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 abri-los diretamente no Visual Studio para edição.

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

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

Fontes do pacote

A página de opções de Fontes de Pacote permite que você gerencie as fontes das quais o NuGet baixa pacotes.

Gerenciando fontes de pacote

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

• Nome: nome de exibição para a origem
• Origem: URL ou caminho do arquivo para a origem do pacote
• Caixa de seleção habilitada: habilite ou desabilite uma origem 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 pacote em todo o computador

As fontes de pacote definidas no nível do computador aparecem em uma seção dedicada abaixo. Elas geralmente são provisionadas por cargas de trabalho do Visual Studio e só podem ser habilitadas ou desabilitadas usando a caixa de seleção na coluna Habilitada.

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á permitir explicitamente. Quando uma fonte HTTP é usada, a primeira coluna da tabela Fontes do Pacote mostrará um ícone com informações sobre um aviso ou um erro com a origem do pacote nessa linha.

⚠️ Quando uma origem do pacote HTTP é usada e Permite Conexões Inseguras está habilitada, um aviso é mostrado na coluna de status mais à esquerda:

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

❌ Quando uma origem HTTP é usada e Permitir Conexões Inseguras é desabilitada, um erro é mostrado na coluna de status mais à esquerda e a restauração do NuGet falhará:

O NuGet requer fontes HTTPS. Para usar uma origem 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 do Pacote permite controlar quais fontes de pacote 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 do pacote

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

• Padrão de pacote: padrão de pacote mapeado no momento (por exemplo, Microsoft.* ou Contoso.Contracts)
• Fonte: uma ou mais fontes de pacote mapeadas para o padrão de pacote. As fontes do pacote 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 de Origem do Pacote.

Mapeamentos de origem inválidos

Se uma fonte de pacote listada no mapeamento de origem existente não estiver habilitada em seus arquivos NuGet.Config, um erro será exibido na coluna mais à esquerda.

Verifique se todos os valores de origem 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.