Depuración de proyectos de PC en dispositivos Windows remotos en Visual Studio

​

Habilitación de la implementación y depuración con F5 en el proyecto de tu juego

1. El PC de desarrollo y el dispositivo Windows remoto deben aprovisionarse y emparejarse siguiendo los pasos descritos en la guía de inicio rápido.
2. El Monitor de depuración de Microsoft Visual Studio (MSVSMON.EXE) debe estar instalado en el dispositivo remoto. MSVSMON.EXE lo instala automáticamente la aplicación XBOX PC Toolbox. Como alternativa, la instalación se puede realizar con WinGet desde un símbolo del sistema con permisos de administrador en el dispositivo remoto:

   winget install Microsoft.VisualStudio.2022.OnecoreMsvsmon

3. wdEndpoint.exe debe estar en ejecución en el dispositivo remoto. wdEndpoint.exe lo instala e inicia automáticamente la aplicación XBOX PC Toolbox. Como alternativa, la instalación se puede realizar con Winget desde un símbolo del sistema en el dispositivo remoto:

   winget install Microsoft.Gaming.RemoteIterationEndpoint 

​

Adición de compatibilidad con la depuración remota con F5 a un proyecto de 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. La lista de argumentos de comando que se pasan al juego.
• Deployment Directory. El directorio del PC de desarrollo que se implementa en el dispositivo Windows remoto. El valor predeterminado es $(Outdir).
• Remote Folder. La carpeta en la que se implementa el juego en el dispositivo Windows remoto. La carpeta es relativa a la Common Root. Consulta el tema wdEndpoint.exe para obtener más información sobre la Common Root.
• Remote EndPoint Name. El dispositivo remoto predeterminado es la propia máquina del desarrollador, igual que con la depuración remota estándar de Windows. Actualiza el valor de Remote EndPoint Name con el nombre del dispositivo donde se está ejecutando wdEndpoint.exe.
• File filter for deployment. Se usa para especificar el conjunto de archivos que deben excluirse de la implementación. Excluir los archivos .pdb de la implementación es una práctica habitual, por ejemplo. Proporciona una lista de patrones de archivo que se van a excluir, separados por punto y coma, por ejemplo: *.pdb;*.ipdb;*.iobj;*.obj;*.pch;*.

​

Valores predeterminados por proyecto del depurador remoto con 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>

​

Implementación del entorno de ejecución de Visual C++ (CRT)

<CopyCppRuntimeToOutputDir>true</CopyCppRuntimeToOutputDir>

​

Adición de compatibilidad con la depuración remota con F5 a un proyecto de CMake

1. Instala la compatibilidad con el XBOX PC Remote Debugger y asegúrate de que el dispositivo Windows remoto esté aprovisionado y ejecutando wdEndpoint.exe.
2. Abre la carpeta de tu proyecto de CMake en Visual Studio.
3. En el Explorador de soluciones, haz clic con el botón derecho en CMakeLists.txt y selecciona Add Debug Configuration….
4. Selecciona 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. Actualiza la configuración generada con valores para las siguientes propiedades:
   • deployDirectory. La carpeta de salida local que contiene los archivos que se van a implementar.
   • remoteGameshareFolder. La carpeta que se va a crear o usar en el dispositivo remoto.
   • remoteMachineName. El nombre del dispositivo remoto donde se está ejecutando wdEndpoint.exe.
   • targetName. El ejecutable del juego que se va a iniciar después de la implementación.
6. Opcionalmente, actualiza estas propiedades según sea necesario:
   • deployExcludeFilter. Una lista de patrones de archivo separados por punto y coma que se excluirán de la implementación.
   • args. Argumentos de línea de comandos que se pasan al juego cuando se inicia.
   • disableDeploy. Establece esta propiedad cuando quieras omitir la implementación y solo iniciar o realizar la asociación con el depurador.
7. Compila tu juego localmente, selecciona CMakeLists.txt en la barra de herramientas del depurador y presiona F5 para implementar el juego en el dispositivo remoto e iniciarlo bajo el depurador.

​

Asociación del depurador de Visual Studio a juegos que se ejecutan en dispositivos Windows remotos

​

Consulte también