> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erreurs de déploiement dans Visual Studio

> Erreurs de déploiement dans Visual Studio

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.

```xml theme={null}
<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 (<b>IntDir</b>) et le répertoire de sortie (<b>OutDir</b>). | Utilisez des emplacements différents pour <b>IntDir</b> et <b>OutDir</b>. |
| Un développeur a modifié la valeur du paramètre de build *IsolatedConfiguration* (<b>No</b> en <b>Yes</b>, ou <b>Yes</b> en <b>No</b>). | Supprimez le dossier <code>Gaming.Xbox.XboxOne.x64\Layout</code>, 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**.

> <img src="https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29" alt="attention" width="11" height="11" data-path="images/gdk/tools/caution.gif" />**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.

```xml theme={null}
<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>  
```

<a id="ID4EVG" />

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

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

```
      xbconnect.exe <console IP>  
```

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

1. 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](/fr-CA/home/setup-install/concepts/deployment)


## Related topics

- [Visual Studio](/fr-CA/tools/tools-console/visualstudio/index.md)
- [Débogage en direct dans Visual Studio sur les exceptions de nuanceur](/fr-CA/tools/tools-console/hix/shader-exceptions-live-debugging-in-vs.md)
- [Modèles de projet dans Visual Studio pour le développement de jeux sur PC](/fr-CA/tools/tools-pc/visualstudio/gr-vs-templates.md)
- [Déboguer CloudScript avec Azure Functions dans Visual Studio Code](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/debugging-with-CloudScript-AF-VSCode.md)
- [Déboguer CloudScript avec Azure Functions dans Visual Studio](/fr-CA/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/debugging-with-CloudScript-AF-VS.md)