Pular para o conteúdo principal
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 Para depurar em um PC remoto, selecione Depurador Remoto do Windows e siga as etapas descritas em depurar um jogo em um PC remoto.
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 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 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. 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 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 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. 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 Depois de instalada, use o menu Depurar para exibir as configurações de Child Process Debugging. O menu Child Process Debugging no Visual Studio 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 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. 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

​
Veja também

Visual Studio
Última modificação em 8 de outubro de 2026