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

# Depurar projetos de PC usando o Visual Studio

> Depurar projetos de PC usando o Visual Studio

A partir da versão de junho de 2022 do Microsoft Game Development Kit (GDK), o depurador de código nativo fornecido como parte do Visual Studio é usado para depurar projetos de jogos para PC. Para depurar em um PC local, selecione **Depurador Local do Windows** na lista suspensa de depuradores da barra de ferramentas do Visual Studio, conforme mostrado na figura a seguir.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=56657c38839ade7382132de3c5436463" alt="O depurador padrão é usado para um projeto" width="405" height="111" data-path="images/gdk/tools/vs_pc_debugger.png" />

Para depurar em um PC remoto, selecione **Depurador Remoto do Windows** e siga as etapas descritas em [depurar um jogo em um PC remoto](#vs_pc_debug_remote).

<Note>O depurador a ser usado em projetos com uma versão do Microsoft Game Development Kit (GDK) anterior a junho de 2022 se chama Local Machine. A depuração remota não é compatível com versões do Microsoft Game Development Kit (GDK) anteriores a junho de 2022.</Note>

Ao atualizar projetos para a versão de junho de 2022 do Microsoft Game Development Kit (GDK), pode haver casos em que a propriedade do depurador será definida como **Unsupported debug option**, conforme mostrado na figura a seguir. Se isso ocorrer, a propriedade do depurador deverá ser redefinida para **Depurador Local do Windows** usando a barra de ferramentas de depuração, a página de propriedades do projeto ou definindo a propriedade do msbuild **DebuggerFlavor** como **WindowsLocalDebugger** (remover totalmente a propriedade **DebuggerFlavor** também fará com que o **Depurador Local do Windows** seja usado).

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_unsupported_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=bfc1a4109ce380cefb6f2726318d3172" alt="Depurador sem suporte após uma atualização" width="554" height="253" data-path="images/gdk/tools/vs_pc_unsupported_debugger.png" />

A partir da versão de junho de 2022 do Microsoft Game Development Kit (GDK), os projetos de PC não exigem mais uma etapa de implantação. A caixa de seleção **Implantar** na caixa de diálogo **Gerenciador de Configurações** do Visual Studio fica desabilitada.

Quando um título é iniciado no varejo, um processo inicializador intermediário é usado. Esse processo bootstrapper mostra uma tela inicial antes da renderização do título, verifica se há atualizações do jogo, pré-sincroniza os salvamentos na nuvem, faz a pré-entrada de um usuário e assim por diante. Esses comportamentos não são exercitados em cenários de depuração de arquivos soltos. Use um [build empacotado](#vs_pc_debug_packaged_build) para testar ou depurar um jogo da forma como ele seria iniciado no varejo.

<a id="vs_pc_debug_packaged_build" />

## Depurar builds empacotados

Antes de depurar um build empacotado, o pacote deve ser instalado usando [wdapp install](/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install). Depois de instalado, o título pode ser depurado usando o recurso **Depurar Pacote do Aplicativo Instalado** do Visual Studio. Use o menu **Depurar** para abrir a caixa de diálogo de depuração, conforme mostrado na figura a seguir.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_menu.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=f06707e7ae498d3863e820cfaa29391f" alt="O item de menu Depurar Pacote do Aplicativo Instalado no Visual Studio" width="652" height="311" data-path="images/gdk/tools/vs_pc_diap_menu.png" />

Para depurar seu título, pesquise-o na caixa de diálogo, defina **Depurar este tipo de código** como *Somente Nativo* e clique no botão **Iniciar**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_dialog.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=b763e70e505dfa7cad5bd189b55dd19a" alt="A caixa de diálogo Depurar Pacote do Aplicativo Instalado no Visual Studio" width="630" height="597" data-path="images/gdk/tools/vs_pc_diap_dialog.png" />

Para depurar o título da forma como ele seria iniciado em um ambiente de varejo, adicione o sinalizador **/bootstrapper** à linha de comando [wdapp install](/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp#wdapp_install). Os títulos instalados dessa forma serão iniciados por um processo bootstrapper. A depuração nesse cenário requer a extensão **Child Process Debugging** no Visual Studio. Instale a extensão usando a caixa de diálogo **Gerenciar Extensões**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_debugger_install_child_process_debugging.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=f9d1e9b9bb0b34316aab21107d4da207" alt="Instalação da extensão Child Process Debugging do Visual Studio" width="974" height="439" data-path="images/gdk/tools/vs_pc_debugger_install_child_process_debugging.png" />

Depois de instalada, use o menu **Depurar** para exibir as configurações de **Child Process Debugging**.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_child_process_debugging_menu.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=7f49ac61f434c0328bfac80be5846272" alt="O menu Child Process Debugging no Visual Studio" width="658" height="341" data-path="images/gdk/tools/vs_pc_child_process_debugging_menu.png" />

Clique na caixa de seleção **Enable child process debugging** na página de configurações.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_child_process_debugging_setting.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=87d06bafb8bb0e40260ec6ad47118377" alt="Configuração do Child Process Debugging no Visual Studio" width="625" height="303" data-path="images/gdk/tools/vs_pc_child_process_debugging_setting.png" />

Com a depuração de processos filho habilitada, a caixa de diálogo **Depurar Pacote do Aplicativo Instalado** agora anexará o depurador ao título, e não ao processo bootstrapper.

<a id="vs_pc_debug_remote" />

## Depurar um jogo em um PC remoto

Depurar um título em um PC remoto requer as ferramentas remotas do Visual Studio. Instale as ferramentas e configure o depurador remoto conforme descrito em [Depuração remota de um projeto C++ no Visual Studio](https://learn.microsoft.com/visualstudio/debugger/remote-debugging-cpp).

Selecione **Depurador Remoto do Windows** na lista suspensa **Depurador a ser iniciado** da página de propriedades do projeto. Insira o nome do executável do título, o diretório de trabalho desejado e assim por diante. Por padrão, o Visual Studio implantará o executável do título e as dependências binárias. Para depurar um jogo remoto do Microsoft Game Development Kit (GDK), arquivos adicionais, incluindo o arquivo MicrosoftGame.config e os arquivos de logotipo, também precisarão ser implantados. Especifique os arquivos adicionais a serem implantados usando a propriedade **Arquivos adicionais a serem implantados** na página de propriedades **Depurador Remoto do Windows**, conforme mostrado na figura a seguir.

<img src="https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_remote_debugger.png?fit=max&auto=format&n=NsRUQ49ZRpXgoZ9R&q=85&s=d5daa87b45f098e8b9dfe68f3a794830" alt="Implantação do MicrosoftGame.config e de outros arquivos no cenário de PC remoto" width="784" height="541" data-path="images/gdk/tools/vs_pc_remote_debugger.png" />

## Veja também

[Visual Studio](/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc)


## Related topics

- [Visual Studio](/pt-BR/tools/tools-pc/visualstudio/index.md)
- [Visual Studio (conteúdo)](/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)
- [Depurar projetos XBOX usando o Visual Studio](/pt-BR/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [Depurar projetos de PC em dispositivos Windows remotos no Visual Studio](/pt-BR/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md)
- [Notas de suporte do GDK para o Visual Studio 2022](/pt-BR/tools/tools-console/visualstudio/vs-2022-support-notes.md)
