Déboguer des projets PC sur des appareils Windows distants dans Visual Studio

​

Activer le déploiement et le débogage avec F5 dans le projet de votre jeu

1. Votre PC de développement et votre appareil Windows distant doivent être provisionnés et appairés en suivant les étapes décrites dans le guide de démarrage rapide.
2. Le moniteur de débogage Microsoft Visual Studio (MSVSMON.EXE) doit être installé sur l’appareil distant. MSVSMON.EXE est installé automatiquement par l’application XBOX PC Toolbox. Vous pouvez également l’installer à l’aide de WinGet depuis une invite administrateur sur l’appareil distant :

   winget install Microsoft.VisualStudio.2022.OnecoreMsvsmon

3. wdEndpoint.exe doit être en cours d’exécution sur l’appareil distant. wdEndpoint.exe est installé et démarré automatiquement par l’application XBOX PC Toolbox. Vous pouvez également l’installer à l’aide de Winget depuis une invite de commandes sur l’appareil distant :

   winget install Microsoft.Gaming.RemoteIterationEndpoint 

​

Ajout de la prise en charge du débogage à distance avec F5 à un projet MSBuild

<ItemGroup>
  <ProjectCapability Include="Gaming.Xbox.PC.Remote" />
</ItemGroup>
<Import Condition="'$(XboxPCRemotePath)'!='' AND Exists('$(XboxPCRemotePath)XboxPCcppDebugger.props')"
  Project="$(XboxPCRemotePath)XboxPCcppDebugger.props" />
<ItemGroup>
  <PropertyPageSchema Condition="'$(XboxPCRemotePath)'!=''" Include="$(XboxPCRemotePath)XboxPCcppDebugger.xml" />
</ItemGroup>

• Remote Command Arguments. Liste des arguments de commande à passer au jeu.
• Deployment Directory. Répertoire du PC de développement à déployer sur l’appareil Windows distant. La valeur par défaut est $(Outdir).
• Remote Folder. Dossier dans lequel le jeu est déployé sur l’appareil Windows distant. Ce dossier est relatif à la Common Root. Pour plus d’informations sur la Common Root, consultez la rubrique wdEndpoint.exe.
• Remote EndPoint Name. L’appareil distant par défaut est la machine de développement elle-même, comme pour le débogage à distance Windows standard. Remplacez la valeur de Remote EndPoint Name par le nom de l’appareil sur lequel wdEndpoint.exe est en cours d’exécution.
• File filter for deployment. Permet de spécifier l’ensemble des fichiers à exclure du déploiement. Par exemple, il est courant d’exclure les fichiers .pdb du déploiement. Fournissez une liste de modèles de fichiers à exclure, séparés par des points-virgules, par exemple : *.pdb;*.ipdb;*.iobj;*.obj;*.pch;*.

​

Valeurs par défaut par projet du débogueur distant F5

<ItemGroup>
  <ProjectCapability Include="Gaming.Xbox.PC.Remote" />
</ItemGroup>
<Import Condition="'$(XboxPCRemotePath)'!='' AND Exists('$(XboxPCRemotePath)XboxPCcppDebugger.props')"
  Project="$(XboxPCRemotePath)XboxPCcppDebugger.props" />
<PropertyGroup>
  <RemoteGameshareFolder>MyGameTitle</RemoteGameshareFolder>
</PropertyGroup>
<ItemGroup>
  <PropertyPageSchema Condition="'$(XboxPCRemotePath)'!=''" Include="$(XboxPCRemotePath)XboxPCcppDebugger.xml" />
</ItemGroup>

​

Déploiement du runtime Visual C++ (CRT)

<CopyCppRuntimeToOutputDir>true</CopyCppRuntimeToOutputDir>

​

Ajout de la prise en charge du débogage à distance avec F5 à un projet CMake

1. Installez la prise en charge de XBOX PC Remote Debugger et assurez-vous que votre appareil Windows distant est provisionné et exécute wdEndpoint.exe.
2. Ouvrez le dossier de votre projet CMake dans Visual Studio.
3. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur CMakeLists.txt et sélectionnez Ajouter une configuration de débogage….
4. Sélectionnez XBOX PC Remote Debugger Folder.

   {
     "version": "0.2.1",
     "defaults": {},
     "configurations": [
       {
         "type": "default",
         "name": "MyGame.exe",
         "project": "CMakeLists.txt",
         "projectTarget": "MyGame.exe",
         "deployDirectory": "${workspaceRoot}\\out\\build\\x64-Release\\bin",
         "deployExcludeFilter": "*.pdb;*.ipdb;*.iobj;*.obj;*.pch;*.ilk;*.exp;*.lib;*.winmd;*.appxrecipe;*.log;*.tlog;*unsuccessfulbuild;*.lastbuildstate;*.copycomplete",
         "remoteGameshareFolder": "MyGame",
         "remoteMachineName": "MyROGAlly",
         "targetName": "MyGame.exe",
         "args": [],
         "deployType": "GamingXboxPCRemoteDeploy"
       }
     ]
   }

5. Mettez à jour la configuration générée avec des valeurs pour les propriétés suivantes :
   • deployDirectory. Dossier de sortie local qui contient les fichiers à déployer.
   • remoteGameshareFolder. Dossier à créer ou à utiliser sur l’appareil distant.
   • remoteMachineName. Nom de l’appareil distant sur lequel wdEndpoint.exe est en cours d’exécution.
   • targetName. Exécutable du jeu à lancer après le déploiement.
6. Mettez éventuellement à jour ces propriétés selon vos besoins :
   • deployExcludeFilter. Liste de modèles de fichiers, séparés par des points-virgules, à exclure du déploiement.
   • args. Arguments de ligne de commande à passer au jeu lors de son démarrage.
   • disableDeploy. Définissez cette propriété lorsque vous voulez ignorer le déploiement et uniquement lancer le jeu ou attacher le débogueur.
7. Générez votre jeu localement, puis sélectionnez CMakeLists.txt dans la barre d’outils du débogueur et appuyez sur F5 pour déployer le jeu sur l’appareil distant et le démarrer sous le débogueur.

​

Attacher le débogueur Visual Studio à des jeux exécutés sur des appareils Windows distants

​

Voir aussi