Erros de implantação no Visual Studio - XBOX Game Development Documentation

As verificações de configuração e de implantação podem causar o seguinte erro de implantação no Visual Studio:

Files for Configuration='Debug' are either not built, or not completely copied to the layout directory. Build required to proceed.

Resolva esse erro da forma a seguir.

Contexto

A implantação do Visual Studio executa um conjunto de verificações para garantir que a configuração do Visual Studio que você selecionou para compilar e implantar (como debug ou release) seja a que realmente é implantada a partir da pasta Gaming.Xbox.XboxOne.x64\Layout\Image\Loose. Essas verificações resolvem problemas causados pela implantação de configurações parcialmente compiladas; tentar implantar uma configuração parcialmente compilada pode causar problemas de registro do aplicativo ou falhas difíceis de diagnosticar. Isso parece ser um problema principalmente quando você alterna de uma configuração de build para outra e tenta implantar sem fazer uma recompilação. Embora essas verificações sejam uma enorme ajuda para quem depende exclusivamente do sistema de projetos XBOX para garantir que tudo esteja devidamente atualizado, elas podem causar problemas em ambientes de build personalizados. Este tópico explica como diagnosticar e corrigir esses problemas. Se você encontrar problemas que não sejam fáceis de resolver e precisar de ajuda, entre em contato com seu gerente de conta de desenvolvedor (DAM). As verificações são gerenciadas por meio dos arquivos XML gerados pelo sistema de build no diretório Gaming.Xbox.XboxOne.x64\Layout\Contributors. Se IsolatedConfiguration=No, há um arquivo para todas as configurações. Se IsolatedConfiguration=Yes, há um arquivo por configuração. Cada arquivo XML lista os arquivos que devem estar no diretório Gaming.Xbox.XboxOne.x64\Layout\Image\Loose para uma determinada configuração, além da origem desse arquivo. Veja a seguir um exemplo.

<Contributor ComponentSource="c:\scratch\d\gdk\samples\setfastresources_06_2014\graphics\setfastresources\setfastresources140.vcxproj_release">
  <Configuration Name="Release">
    <File Source="C:\GDK\Samples\SetFastResources_06_2014\graphics\SetFastResources\Gaming.Xbox.XboxOne.x64\Release140\bin\file.txt">C:\GDK\Samples\SetFastResources_06_2014\graphics\SetFastResources\Gaming.Xbox.XboxOne.x64\Layout\Image\Loose\file.txt</File>
    ...
    <File Source="C:\GDK\Samples\SetFastResources_06_2014\graphics\SetFastResources\Gaming.Xbox.XboxOne.x64\Release140\bin\Media\Textures\ATGStoreLogo.png">C:\GDK\Samples\SetFastResources_06_2014\graphics\SetFastResources\Gaming.Xbox.XboxOne.x64\Layout\Image\Loose\Media\Textures\ATGStoreLogo.png</File>
  </Configuration>
</Contributor>  

Se o arquivo não existir ou precisar ser atualizado, ele será copiado de Source para a pasta Gaming.Xbox.XboxOne.x64\Layout\Image\Loose. Se o arquivo Source não existir ou o arquivo Configuration estiver vazio (porque você está compilando usando um processo de build personalizado), a implantação falhará com um erro semelhante ao seguinte. Expected file in OutputDir 'missing.txt' does not exist.

Files for Configuration='Debug' are either not built,           or not completely copied to the layout directory.           Build required to proceed.

Diagnosticar problemas

Normalmente, esse problema é causado por uma das situações mostradas na tabela a seguir.

Causa possível	Como corrigir
Um desenvolvedor alternou entre configurações, e a nova configuração não foi compilada.	Recompile e implante novamente.
A configuração que está sendo implantada não tem alguns arquivos.	Corrija o sistema de build para garantir que os arquivos ausentes sejam compilados. A mensagem de erro deve indicar o que está faltando. Caso contrário, verifique os parâmetros Source e Target definidos no arquivo de configuração Contributors.
O mesmo local é usado para o diretório intermediário (IntDir) e o diretório de saída (OutDir).	Use locais diferentes para IntDir e OutDir.
Um desenvolvedor alterou o valor do parâmetro de build IsolatedConfiguration (de No para Yes ou de Yes para No).	Exclua a pasta `Gaming.Xbox.XboxOne.x64\Layout` e recompile o projeto.
Um desenvolvedor está usando um processo de build personalizado que não atualiza o arquivo de configuração Contributors.	Atualize o processo de build personalizado para gerar um arquivo Configurations válido. Como alternativa, você pode recusar as verificações adicionais de configuração de implantação. Para obter mais informações, veja a seção Recusar as verificações adicionais a seguir.

Recusar as verificações adicionais

Você pode recusar essas verificações adicionais usando a propriedade DisableConfigurationRefresh.

CUIDADO: tenha cuidado ao usar a propriedade DisableConfigurationRefresh. Desativar essas verificações significa que o sistema de build do Visual Studio não valida se o conteúdo da pasta Image\Loose está correto antes de iniciar a implantação. Você pode encontrar exatamente os tipos de problemas difíceis de diagnosticar que essas verificações foram projetadas para evitar. Antes de usar essa propriedade, verifique se o seu processo de build está correto e se alternar entre configurações não deixa a pasta Image\Loose em um estado incorreto.

Para adicionar a propriedade DisableConfigurationRefresh, abra o arquivo do projeto em um editor de texto. No grupo de propriedades Globals, adicione uma entrada para <DisableConfigurationRefresh>true</DisableConfigurationRefresh>. Veja a seguir um exemplo.

<PropertyGroup Label="Globals">
  <RootNamespace>SetFastResources</RootNamespace>
  <VCTargetsPath Condition="'$(VCTargetsPath14)' != '' and '$(VSVersion)' == '' and '$(VisualStudioVersion)' == ''">$(VCTargetsPath14)</VCTargetsPath>
  <DefaultLanguage>en-US</DefaultLanguage>
  <ProjectGuid>{25D7897B-1E8D-439B-936F-BB68D477B790}</ProjectGuid>
  <Keyword>Win32Proj</Keyword>
  <ProjectName>SetFastResources140</ProjectName>

  <!-- Disable Deployment configuration checks.  -->
  <DisableConfigurationRefresh>true</DisableConfigurationRefresh>

</PropertyGroup>  

Coletar logs do XTF para falhas de implantação e de inicialização de títulos

Veja algumas etapas para habilitar o registro em log detalhado do processo de implantação em um PC de desenvolvimento e em um Development Kit.

Abra um prompt de comando do GDK no PC de desenvolvimento.
Conecte-se ao console executando o comando a seguir.

      xbconnect.exe <console IP>

Habilite o registro em log detalhado no console executando o comando a seguir.

      xbconfig.exe ToolsLogLevel=Verbose

[!NOTE] Você pode ignorar o texto que diz que é preciso reinicializar o console para que a alteração entre em vigor.

Habilite o registro em log detalhado no PC de desenvolvimento definindo as variáveis de ambiente a seguir.

      set XTF_LOG_LEVEL=5

      set XTF_LOG_FILE=<path on your development PC to create the log file>

Você pode desabilitar o registro em log do XTF executando os comandos a seguir.

Xbconfig.exe ToolsLogLevel=Quiet
set XTF_LOG_LEVEL=
set XTF_LOG_FILE=

Os caminhos a seguir podem conter informações úteis para a depuração.

O caminho \\<console IP>\SystemScratch\xtflogs no console
O <caminho no seu PC de desenvolvimento para criar o arquivo de log> que você usou para XTF_LOG_FILE

Veja também

Implantar seu título no seu dev kit XBOX

​Contexto

​Diagnosticar problemas

​Recusar as verificações adicionais

​Coletar logs do XTF para falhas de implantação e de inicialização de títulos

​Veja também

Contexto

Diagnosticar problemas

Recusar as verificações adicionais

Coletar logs do XTF para falhas de implantação e de inicialização de títulos

Veja também