A restauração automática do pacote NuGet não funciona com o MSBuild

Estou tentando construir uma solução com packagesfalta de conteúdo (excetorepositories.config dentro) com o MSBuild 12.0. Espero que ele restaure automaticamente todos os pacotes ausentes antes de compilar, mas este não é o caso - o MsBuild relata toneladas de erros:

"está faltando uma diretiva using ou uma referência do assembly?"

NuGet Manager é 2.7 (vejo isso no Visual Studio 2013 sobre a caixa). Eu até tentei passar o EnableNuGetPackageRestore=trueparâmetro - sem sorte. o que estou perdendo?

ATUALIZADO com a documentação oficial do NuGet mais recente a partir da v3.3.0

Abordagens de restauração de pacote

O NuGet oferece três abordagens para usar a restauração de pacote .

A Restauração automática de pacotes é a abordagem recomendada pela equipe do NuGet para a restauração de pacotes no Visual Studio e foi introduzida no NuGet 2.7. Começando com NuGet 2.7, a extensão NuGet Visual Studio se integra aos eventos de compilação do Visual Studio e restaura pacotes ausentes quando uma compilação começa. Esse recurso é habilitado por padrão, mas os desenvolvedores podem cancelar, se desejarem.

Funciona assim:

1. No projeto ou versão da solução, o Visual Studio gera um evento de que uma versão está começando na solução.
2. O NuGet responde a esse evento e verifica os arquivos packages.config incluídos na solução.
3. Para cada arquivo packages.config encontrado, seus pacotes são enumerados e Verificados se existem na pasta de pacotes da solução.
4. Quaisquer pacotes ausentes são baixados das fontes de pacote configuradas (e habilitadas) do usuário, respeitando a ordem das fontes de pacote.
5. Conforme os pacotes são baixados, eles são descompactados na pasta de pacotes da solução.

Se você tiver o Nuget 2.7+ instalado; é importante escolher um método para> gerenciar a restauração automática de pacotes no Visual Studio.

Dois métodos estão disponíveis:

1. (Nuget 2.7+): Visual Studio -> Ferramentas -> Gerenciador de Pacotes -> Configurações do Gerenciador de Pacotes -> Habilitar Restauração Automática de Pacotes
2. (Nuget 2.6 e abaixo) Clique com o botão direito em uma solução e clique em "Habilitar Restauração de Pacote para esta solução".

A restauração do pacote da linha de comando é necessária ao criar uma solução a partir da linha de comando; foi introduzido nas primeiras versões do NuGet, mas foi aprimorado no NuGet 2.7.

nuget.exe restore contoso.sln

A abordagem de restauração de pacote integrada ao MSBuild é a implementação original da Restauração de pacote e, embora continue a funcionar em muitos cenários, não cobre o conjunto completo de cenários endereçados pelas outras duas abordagens.

Se você estiver usando o Visual Studio 2017 ou posterior, que vem com o MSBuild 15 ou posterior, e seus arquivos .csproj estiverem no novo PackageReferenceformato , o método mais simples é usar o novo Restoredestino MSBuild .

Ninguém realmente respondeu à pergunta original, que é "como faço para que os pacotes NuGet sejam restaurados automaticamente ao compilar a partir da linha de comando com o MSBuild?" A resposta é: a menos que você esteja usando a opção "Habilitar restauração de pacote NuGet" (que agora está obsoleta de acordo com esta referência ), você não pode (mas veja abaixo). Se você está tentando fazer, por exemplo, compilações automatizadas em um servidor de CI, isso é uma droga.

No entanto, há uma maneira um pouco indireta de obter o comportamento desejado:

1. Baixe o executável NuGet mais recente em https://dist.nuget.org/win-x86-commandline/latest/nuget.exe e coloque-o em algum lugar em seu PATH. (Você pode fazer isso como uma etapa de pré-construção.)
2. Execute o nuget restorequal fará o download automático de todos os pacotes ausentes.
3. Execute msbuildpara construir sua solução.

Afora isso: embora a maneira nova e recomendada de fazer a restauração automática de pacotes envolva menos desordem em seu controle de versão, ela também torna a restauração de pacotes de linha de comando impossível, a menos que você pule o aro extra de baixar e executar nuget.exe. Progresso?

A Restauração Automática de Pacote do Nuget é um recurso do Visual Studio (começando em 2013), não do MSBuild. Você terá que executar nuget.exe restorese quiser restaurar pacotes da linha de comando.

Você também pode usar o recurso Habilitar restauração do pacote Nuget, mas isso não é mais recomendado pelo pessoal do nuget porque faz alterações intrusivas nos arquivos do projeto e pode causar problemas se você construir esses projetos em outra solução.

Levei algum tempo para descobrir a imagem completa e gostaria de compartilhar aqui.

O Visual Studio tem duas abordagens para usar a restauração de pacote: Restauração automática de pacote e restauração de pacote integrada ao MSBuild. O 'MSBuild-Integrated Package Restore' restaura pacotes DURANTE o processo de construção que pode causar problemas em alguns cenários. A 'Restauração automática de pacote' é a abordagem recomendada pela equipe do NuGet.

Existem várias etapas para fazer a 'Restauração Automática de Pacote' funcionar:

1. No Visual Studio, Ferramentas -> Extensões e atualizações, Atualizar NuGet se houver uma versão mais recente (versão 2.7 ou posterior)

2. Se você usar o TFS, na pasta .nuget da solução, remova os arquivos NuGet.exe e NuGet.targes. Em seguida, edite NuGet.Config para não fazer check-in de pacotes NuGet:

   <configuration>  
     <solution>  
       <add key="disableSourceControlIntegration" value="true" />  
     </solution>  
   </configuration> 

   Se você fez check-in da pasta de pacotes da solução no TFS antes, exclua a pasta e faça check-in da exclusão da exclusão da pasta do pacote.

   Se você não usa o TFS, exclua a pasta .nuget.

3. Em cada arquivo de projeto (.csproj ou .vbproj) em sua solução, remova a linha que faz referência ao arquivo NuGet.targets. A referência se parece com isto:

   <Import Project="$(SolutionDir)\.nuget\NuGet.targets" Condition="Exists('$(SolutionDir)\.nuget\NuGet.targets')" />

   Remova esta linha em cada arquivo de projeto em sua solução.

4. No menu do Visual Studio, por meio de

   Ferramentas -> Opções -> Gerenciador de pacotes -> Geral ou Ferramentas -> Gerenciador de pacotes NuGet -> Configurações do gerenciador de pacotes

   habilite as duas opções a seguir 1) 'Permitir que o NuGet baixe pacotes ausentes' 2) 'Verificar automaticamente se há pacotes ausentes durante a compilação no Visual Studio'

5. Teste a configuração de restauração de seu pacote seguindo as seguintes etapas

   • Salve sua solução e feche o Visual Studio
   • Exclua a pasta de pacotes da sua solução
   • Inicie o Visual Studio, abra sua solução e reconstrua-a.

MSBuild 15 tem a / t: opção de restauração que faz isso. ele vem com o Visual Studio 2017.

Se quiser usar isso, você também terá que usar o novo PackageReference , o que significa substituir o packages.configarquivo por elementos como este (faça isso em * .csproj):

<ItemGroup>
  <!-- ... -->
  <PackageReference Include="Contoso.Utility.UsefulStuff" Version="3.6.0" />
  <!-- ... -->
</ItemGroup>

Há uma migração automática para este formato se você clicar com o botão direito em 'Referências' (pode não aparecer se você apenas abrir o Visual Studio, reconstruir ou abrir a janela 'Gerenciar pacotes NuGet para solução' e ela começará a aparecer).

Ian Kemp tem a resposta (tem alguns pontos aliás ..), isso é simplesmente adicionar um pouco de carne a um de seus passos.

A razão pela qual acabei aqui foi que as máquinas de desenvolvimento estavam construindo bem, mas o servidor de construção simplesmente não estava baixando os pacotes necessários (pasta de pacotes vazia) e, portanto, a construção estava falhando. No entanto, fazer logon no servidor de compilação e compilar manualmente a solução funcionou.

Para cumprir a segunda das etapas de 3 pontos de Ians (executando a restauração do nuget ), você pode criar um destino MSBuild executando o comando exec para executar o comando de restauração do nuget, como abaixo (neste caso, nuget.exe está na pasta .nuget, em vez de no caminho), que pode então ser executado em uma etapa de construção do TeamCity (outro CI disponível ...) imediatamente antes de construir a solução

<Target Name="BeforeBuild">
  <Exec Command="..\.nuget\nuget restore ..\MySolution.sln"/>
</Target>

Para o registro, eu já tentei o tipo de execução "nuget installer", mas esta etapa estava travando em projetos da web (funcionou para projetos de DLL e Windows)

Observe que se você estiver usando o TeamCity como um servidor de compilação, receberá uma etapa de "Instalador NuGet" que pode ser usada para restaurar todos os pacotes antes da etapa de compilação.

Existe um packages.config arquivo com o projeto, ele contém os detalhes do pacote.

Também há uma pasta .nuget que contém NuGet.exe e NuGet.targets . se algum dos arquivos estiver faltando, ele não restaurará o pacote ausente e causará "está faltando uma diretiva de uso ou uma referência de assembly?" erro

Às vezes, isso ocorre quando você tem a pasta do pacote que está tentando restaurar dentro da pasta "packages" (ou seja, "Packages / EntityFramework.6.0.0 /" ), mas as "DLLs" não estão dentro dela (a maior parte do controle de versão sistemas ignoram automaticamente os arquivos ".dll"). Isso ocorre porque antes do NuGet tentar restaurar cada pacote, ele verifica se as pastas já existem; portanto, se existirem, o NuGet presume que a "dll" está dentro dele. Portanto, se este for o problema para você, basta excluir a pasta que o NuGet irá restaurá-la corretamente.

Tive um problema com os pacotes nuget não sendo incluídos em uma compilação noturna com script que cria o arquivo sln usando devenv.exe.

Segui o conselho da Microsoft e a etapa principal foi atualizar a configuração do NuGet %AppData%/NuGetpara que contivesse:

<configuration>
    <packageRestore>
        <add key="automatic" value="True" />
    </packageRestore>
</configuration>

No Visual Studio 2017 - quando você compila usando IDE - ele irá baixar todos os pacotes nuget ausentes e salvar na pasta "pacotes".

Mas na compilação da máquina de construção foi feita usando msbuild.exe. Nesse caso, baixei o nuget.exe e mantive o caminho.

Durante cada processo de compilação, antes de executar msbuild.exe. Ele irá executar -> nuget.exe restaurar NAME_OF_SLN_File (se houver apenas um arquivo .SLN, você pode ignorar esse parâmetro)

Você também pode usar

Update-Package -reinstall

para restaurar os pacotes NuGet no Console de gerenciamento de pacotes no Visual Studio.