> ## Documentation Index > Fetch the complete documentation index at: https://docs.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. ![O depurador padrão é usado para um projeto](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_debugger.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=56657c38839ade7382132de3c5436463) 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. 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). ![Depurador sem suporte após uma atualização](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_unsupported_debugger.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=bfc1a4109ce380cefb6f2726318d3172) 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. ## Depurar builds empacotados Antes de depurar um build empacotado, o pacote deve ser instalado usando [wdapp install](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#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. ![O item de menu Depurar Pacote do Aplicativo Instalado no Visual Studio](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_menu.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=f06707e7ae498d3863e820cfaa29391f) 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**. ![A caixa de diálogo Depurar Pacote do Aplicativo Instalado no Visual Studio](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_diap_dialog.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=b763e70e505dfa7cad5bd189b55dd19a) 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](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#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**. ![Instalação da extensão Child Process Debugging do Visual Studio](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) Depois de instalada, use o menu **Depurar** para exibir as configurações de **Child Process Debugging**. ![O menu Child Process Debugging no Visual Studio](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) Clique na caixa de seleção **Enable child process debugging** na página de configurações. ![Configuração do Child Process Debugging no Visual Studio](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) 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. ## 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. ![Implantação do MicrosoftGame.config e de outros arquivos no cenário de PC remoto](https://mintcdn.com/microsoft-4404708b/NsRUQ49ZRpXgoZ9R/images/gdk/tools/vs_pc_remote_debugger.png?fit=max\&auto=format\&n=NsRUQ49ZRpXgoZ9R\&q=85\&s=d5daa87b45f098e8b9dfe68f3a794830) ## Veja também [Visual Studio](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md) ## Related topics - [Visual Studio (conteúdo)](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md) - [Visualstudio](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/index.md) - [Depurar projetos XBOX usando o Visual Studio](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/debugging-with-visualstudio.md) - [Depurar projetos de PC em dispositivos Windows remotos no Visual Studio](https://docs.xbox.com/pt-BR/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md) - [Notas de suporte do GDK para o Visual Studio 2022](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2022-support-notes.md)