Depurar projetos de PC em dispositivos Windows remotos no Visual Studio

​

Habilitar a implantação e depuração com F5 no projeto do jogo

1. Seu PC de desenvolvimento e o dispositivo Windows remoto devem ser provisionados e emparelhados usando as etapas descritas no guia de início rápido.
2. O Microsoft Visual Studio Debug Monitor (MSVSMON.EXE) deve estar instalado no dispositivo remoto. O MSVSMON.EXE é instalado automaticamente pelo aplicativo XBOX PC Toolbox. Como alternativa, a instalação pode ser feita usando o WinGet em um prompt de administrador no dispositivo remoto:

   winget install Microsoft.VisualStudio.2022.OnecoreMsvsmon

3. O wdEndpoint.exe deve estar em execução no dispositivo remoto. O wdEndpoint.exe é instalado e iniciado automaticamente pelo aplicativo XBOX PC Toolbox. Como alternativa, a instalação pode ser feita usando o WinGet em um prompt de comando no dispositivo remoto:

   winget install Microsoft.Gaming.RemoteIterationEndpoint 

​

Adicionar suporte à depuração remota com F5 a um projeto 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. A lista de argumentos de comando a serem passados ao jogo.
• Deployment Directory. O diretório no PC de desenvolvimento a ser implantado no dispositivo Windows remoto. O padrão é $(Outdir).
• Remote Folder. A pasta na qual o jogo é implantado no dispositivo Windows remoto. A pasta é relativa à Common Root. Veja o tópico wdEndpoint.exe para obter mais informações sobre a Common Root.
• Remote EndPoint Name. O dispositivo remoto padrão é a própria máquina do desenvolvedor, como na Depuração Remota padrão do Windows. Atualize o Remote EndPoint Name para o nome do dispositivo em que o wdEndpoint.exe está em execução.
• File filter for deployment. Usado para especificar o conjunto de arquivos que devem ser excluídos da implantação. Excluir arquivos .pdb da implantação é uma prática comum, por exemplo. Forneça uma lista de padrões de arquivo a serem excluídos, separados por ponto e vírgula, por exemplo: *.pdb;*.ipdb;*.iobj;*.obj;*.pch;*.

​

Padrões por projeto do depurador remoto com 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>

​

Implantação do Visual C++ Runtime (CRT)

<CopyCppRuntimeToOutputDir>true</CopyCppRuntimeToOutputDir>

​

Adicionar suporte à depuração remota com F5 a um projeto CMake

1. Instale o suporte ao XBOX PC Remote Debugger e verifique se o dispositivo Windows remoto está provisionado e executando o wdEndpoint.exe.
2. Abra a pasta do projeto CMake no Visual Studio.
3. No Gerenciador de Soluções, clique com o botão direito do mouse em CMakeLists.txt e selecione Adicionar Configuração de Depuração….
4. Selecione 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. Atualize a configuração gerada com valores para as seguintes propriedades:
   • deployDirectory. A pasta de saída local que contém os arquivos a serem implantados.
   • remoteGameshareFolder. A pasta a ser criada ou usada no dispositivo remoto.
   • remoteMachineName. O nome do dispositivo remoto em que o wdEndpoint.exe está em execução.
   • targetName. O executável do jogo a ser iniciado após a implantação.
6. Opcionalmente, atualize estas propriedades conforme necessário:
   • deployExcludeFilter. Uma lista separada por ponto e vírgula de padrões de arquivo a serem excluídos da implantação.
   • args. Argumentos de linha de comando a serem passados ao jogo quando ele for iniciado.
   • disableDeploy. Defina esta propriedade quando quiser ignorar a implantação e apenas iniciar ou anexar com o depurador.
7. Compile o jogo localmente, selecione CMakeLists.txt na barra de ferramentas do depurador e pressione F5 para implantar o jogo no dispositivo remoto e iniciá-lo sob o depurador.

​

Anexar o depurador do Visual Studio a jogos em execução em dispositivos Windows remotos

​

Veja também