Erreurs de déploiement dans Visual Studio - XBOX Game Development Documentation

Les vérifications de configuration et de déploiement peuvent provoquer l’erreur de déploiement suivante dans Visual Studio :

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

Résolvez cette erreur comme suit.

Contexte

Le déploiement de Visual Studio effectue un ensemble de vérifications pour s’assurer que la configuration Visual Studio que vous avez sélectionnée pour la génération et le déploiement (par exemple debug ou release) est bien celle qui est effectivement déployée depuis le dossier Gaming.Xbox.XboxOne.x64\Layout\Image\Loose. Ces vérifications résolvent les problèmes causés par le déploiement de configurations partiellement générées : tenter de déployer une configuration partiellement générée peut entraîner des problèmes d’inscription d’application ou des plantages difficiles à diagnostiquer. Ce problème apparaît en particulier lorsque vous passez d’une configuration de build à une autre, puis tentez de déployer sans régénérer. Si ces vérifications sont d’une aide précieuse pour ceux qui s’appuient uniquement sur le système de projet XBOX pour s’assurer que tout est correctement mis à jour, elles peuvent poser des problèmes dans les environnements de build personnalisés. Cette rubrique explique comment diagnostiquer et résoudre ces problèmes. Si vous rencontrez des problèmes difficiles à résoudre et avez besoin d’aide, communiquez avec votre gestionnaire de compte développeur (DAM). Les vérifications sont gérées au moyen des fichiers XML générés par le système de build dans le répertoire Gaming.Xbox.XboxOne.x64\Layout\Contributors. Si IsolatedConfiguration=No, il existe un seul fichier pour toutes les configurations. Si IsolatedConfiguration=Yes, il existe un fichier par configuration. Chaque fichier XML répertorie les fichiers qui doivent se trouver dans le répertoire Gaming.Xbox.XboxOne.x64\Layout\Image\Loose pour une configuration donnée, ainsi que la source de chaque fichier. En voici un exemple.

<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>  

Si le fichier n’existe pas ou doit être mis à jour, il est copié depuis Source vers le dossier Gaming.Xbox.XboxOne.x64\Layout\Image\Loose. Si le fichier Source n’existe pas ou si le fichier Configuration est vide (parce que vous effectuez la génération à l’aide d’un processus de build personnalisé), le déploiement échoue avec une erreur semblable à la suivante. 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.

Diagnostiquer les problèmes

Ce problème est généralement causé par l’une des situations présentées dans le tableau suivant.

Cause possible	Solution
Un développeur a changé de configuration et la nouvelle configuration n’a pas été générée.	Régénérez, puis déployez à nouveau.
Il manque des fichiers dans la configuration en cours de déploiement.	Corrigez le système de build pour vous assurer que les fichiers manquants sont générés. Le message d’erreur doit indiquer ce qui manque. Si ce n’est pas le cas, vérifiez les paramètres Source et Target définis dans le fichier de configuration Contributors.
Le même emplacement est utilisé pour le répertoire intermédiaire (IntDir) et le répertoire de sortie (OutDir).	Utilisez des emplacements différents pour IntDir et OutDir.
Un développeur a modifié la valeur du paramètre de build IsolatedConfiguration (No en Yes, ou Yes en No).	Supprimez le dossier `Gaming.Xbox.XboxOne.x64\Layout`, puis régénérez le projet.
Un développeur utilise un processus de build personnalisé qui ne met pas à jour le fichier de configuration Contributors.	Mettez à jour le processus de build personnalisé pour qu’il génère un fichier Configurations valide. Vous pouvez aussi désactiver les vérifications supplémentaires de la configuration de déploiement. Pour plus de renseignements, consultez la section Désactiver les vérifications supplémentaires ci-après.

Désactiver les vérifications supplémentaires

Vous pouvez désactiver ces vérifications supplémentaires à l’aide de la propriété DisableConfigurationRefresh.

ATTENTION : soyez prudent lorsque vous utilisez la propriété DisableConfigurationRefresh. La désactivation de ces vérifications signifie que le système de build de Visual Studio ne vérifie plus que le contenu du dossier Image\Loose est correct avant de démarrer le déploiement. Vous risquez de rencontrer exactement le type de problèmes difficiles à diagnostiquer que ces vérifications sont censées empêcher. Avant d’utiliser cette propriété, assurez-vous que votre processus de build est correct et que le passage d’une configuration à une autre ne laisse pas le dossier Image\Loose dans un état incorrect.

Pour ajouter la propriété DisableConfigurationRefresh, ouvrez votre fichier projet dans un éditeur de texte. Dans le groupe de propriétés Globals, ajoutez une entrée pour <DisableConfigurationRefresh>true</DisableConfigurationRefresh>. En voici un exemple.

<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>  

Collecter les journaux XTF pour les échecs de déploiement et de lancement de titres

Voici les étapes permettant d’activer la journalisation détaillée du processus de déploiement sur un PC de développement et sur un kit de développement.

Ouvrez une invite de commandes GDK sur le PC de développement.
Connectez-vous à la console en exécutant la commande suivante.

      xbconnect.exe <console IP>

Activez la journalisation détaillée sur la console en exécutant la commande suivante.

      xbconfig.exe ToolsLogLevel=Verbose

[!NOTE] Vous pouvez ignorer le texte indiquant que vous devez redémarrer la console pour que la modification prenne effet.

Activez la journalisation détaillée sur le PC de développement en définissant les variables d’environnement suivantes.

      set XTF_LOG_LEVEL=5

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

Vous pouvez désactiver la journalisation XTF en exécutant les commandes suivantes.

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

Les chemins suivants peuvent contenir des informations utiles pour le débogage.

Le chemin \\<console IP>\SystemScratch\xtflogs sur la console
Le <chemin sur votre PC de développement où créer le fichier journal> que vous avez utilisé pour XTF_LOG_FILE

Voir aussi

Deploying your title to your XBOX dev kit

​Contexte

​Diagnostiquer les problèmes

​Désactiver les vérifications supplémentaires

​Collecter les journaux XTF pour les échecs de déploiement et de lancement de titres

​Voir aussi

Contexte

Diagnostiquer les problèmes

Désactiver les vérifications supplémentaires

Collecter les journaux XTF pour les échecs de déploiement et de lancement de titres

Voir aussi