Solução de problemas relacionados a erros na restauração de pacotes

Este artigo se concentra em erros comuns ao restaurar pacotes e etapas para resolvê-los.

A Restauração de Pacote tenta instalar todas as dependências de pacote para o estado correto que corresponde às referências do pacote no arquivo de projeto (.csproj) ou no arquivo packages.config . (No Visual Studio, as referências aparecem no Gerenciador de Soluções nas Dependências \ NuGet ou no nó Referências .) Para seguir as etapas necessárias para restaurar pacotes, consulte Os pacotes de restauração. Se as referências de pacote no arquivo de projeto (.csproj) ou no arquivo packages.config estiverem incorretas (elas não correspondem ao estado desejado após a Restauração do Pacote), você precisará instalar ou atualizar pacotes em vez de usar a Restauração de Pacote.

Se as instruções aqui não funcionarem para você, registre um problema no GitHub para que possamos examinar seu cenário com mais cuidado. Não use o controle "Esta página é útil?" que pode aparecer nesta página porque não nos dá a capacidade de entrar em contato com você para obter mais informações.

Solução rápida para usuários do Visual Studio

Se você estiver usando o Visual Studio, primeiro habilite a restauração do pacote da seguinte maneira. Caso contrário, continue para as seções a seguir.

  1. Selecione o comando de menu Ferramentas> Gerenciador de Pacotes NuGet> Configurações do Gerenciador de Pacotes.
  2. Defina ambas as opções em Restauração de Pacote.
  3. Selecione OK.
  4. Crie seu projeto novamente.

Habilitar a restauração do pacote NuGet na Ferramenta/Opções

Essas configurações também podem ser alteradas em seu NuGet.Config arquivo; consulte a seção de consentimento . Se o projeto for um projeto mais antigo que usa a restauração de pacote integrada do MSBuild, talvez seja necessário migrar para a restauração automática do pacote.

Este projeto faz referência a pacotes NuGet que estão ausentes neste computador

Mensagem de erro completa:

This project references NuGet package(s) that are missing on this computer.
Use NuGet Package Restore to download them. The missing file is {name}.

Esse erro ocorre quando você tenta criar um projeto que contém referências a um ou mais pacotes NuGet, mas esses pacotes não estão atualmente instalados no computador ou no projeto.

  • Ao usar o formato de gerenciamento PackageReference , esse erro pode ser uma sobra de uma migração de packages.config para PackageReference e precisa ser removido manualmente do arquivo de projeto.
  • Ao usar packages.config, o erro significa que o pacote não está instalado na packages pasta na raiz da solução.

Essa situação geralmente ocorre quando você obtém o código do projeto do controle de versão ou de outro download. Normalmente, os pacotes são omitidos do controle do código-fonte ou downloads porque podem ser restaurados de feeds de pacotes como nuget.org (consulte Pacotes e controle do código-fonte). Incluí-los de outra forma incharia o repositório ou criaria arquivos .zip desnecessariamente grandes.

O erro também pode acontecer se o arquivo de projeto contiver caminhos absolutos para os diretórios de pacotes e você mover o projeto.

Use um dos seguintes métodos para restaurar os pacotes:

Após uma restauração bem-sucedida, o pacote deve estar presente na pasta de pacotes globais . Para projetos que usam PackageReference, uma restauração deve recriar o obj/project.assets.json arquivo; para projetos que usam packages.config, o pacote deve aparecer na pasta do packages projeto. O projeto agora deve ser construído com sucesso. Caso contrário, registre um problema no GitHub para que possamos acompanhar você.

Arquivo de ativos project.assets.json não encontrado

Mensagem de erro completa:

Assets file '<path>\project.assets.json' not found. Run a NuGet package restore to generate this file.

O project.assets.json arquivo mantém o grafo de dependência de um projeto ao usar o formato de gerenciamento PackageReference, que é usado para garantir que todos os pacotes necessários sejam instalados no computador. Como esse arquivo é gerado dinamicamente por meio da restauração do pacote, ele normalmente não é adicionado ao controle do código-fonte. Como resultado, esse erro ocorre ao criar um projeto com uma ferramenta como msbuild essa não restaura pacotes automaticamente.

Nesse caso, execute msbuild -t:restore seguido por msbuild, ou use dotnet build (que restaura pacotes automaticamente). Você também pode usar qualquer um dos métodos de restauração de pacote na seção anterior.

Mensagem de erro completa:

One or more NuGet packages need to be restored but couldn't be because consent has
not been granted. To give consent, open the Visual Studio Options dialog, click on
the NuGet Package Manager node and check 'Allow NuGet to download missing packages
during build.' You can also give consent by setting the environment variable
'EnableNuGetPackageRestore' to 'true'. Missing packages: {name}

Esse erro indica que a restauração do pacote está desabilitada na configuração do NuGet.

Você pode alterar as configurações aplicáveis no Visual Studio, conforme descrito anteriormente na solução Rápida para usuários do Visual Studio.

Você também pode editar essas configurações diretamente no arquivo aplicável nuget.config (normalmente %AppData%\NuGet\NuGet.Config no Windows e ~/.nuget/NuGet/NuGet.Config no Mac/Linux). Verifique se as teclas enabled e automatic sob packageRestore estão definidas como True.

<!-- Package restore is enabled -->
<configuration>
    <packageRestore>
        <add key="enabled" value="True" />
        <add key="automatic" value="True" />
    </packageRestore>
</configuration>

Importante

Se você editar os packageRestore ajustes diretamente em nuget.config, reinicie o Visual Studio para que a caixa de diálogo mostre os valores atuais.

Outras condições potenciais

  • Você pode encontrar erros de build devido a arquivos ausentes, com uma mensagem dizendo para usar a restauração do NuGet para baixá-los. No entanto, a execução de uma restauração pode dizer: "Todos os pacotes já estão instalados e não há nada para restaurar." Nesse caso, exclua a packages pasta (ao usar packages.config) ou o obj/project.assets.json arquivo (ao usar PackageReference) e execute a restauração novamente.

  • Ao obter um projeto do controle do código-fonte, as pastas do projeto podem ser definidas como somente leitura. Altere as permissões de pasta e tente restaurar pacotes novamente.

  • Você pode estar usando uma versão antiga do NuGet. Verifique nuget.org/downloads para versões recomendadas mais recentes. Para o Visual Studio 2015, recomendamos a versão 3.6.0.

Se você encontrar outros problemas, registre um problema no GitHub para que possamos obter mais detalhes de você.

  • Last updated on