XBOX Gaming Explorer

O XBOX Gaming Explorer é uma janela hospedada no ambiente de desenvolvimento integrado (IDE) do Visual Studio que simplifica fluxos de trabalho comuns de desenvolvedores relacionados ao console, principalmente em torno da depuração, da inicialização de processos e do monitoramento do status dos seus consoles. O XBOX Gaming Explorer integra alguns recursos comuns voltados para desenvolvedores do xbWatson e do XBOX Manager e simplifica o acesso a cenários comuns de depuração. Use o XBOX Gaming Explorer para fazer mais diretamente no IDE do Visual Studio. O XBOX Gaming Explorer pode ser acessado usando o menu XBOX no Visual Studio. O menu XBOX fica no menu Extensions, conforme mostrado na figura a seguir. Os recursos do XBOX Gaming Explorer estão agrupados em três guias: Console Details, Consoles e XBOX Developer Tools Launcher. A faixa de opções usada para selecionar uma das quatro guias também permite exibir esta página de ajuda e acessar o recurso Report A Problem, que é comum a outras ferramentas, como o XBOX Manager.

​

Console Details

Use a guia Console Details para monitorar o processo do jogo em execução no seu console, iniciar e depurar títulos registrados, alternar seu título entre os vários estados do Gerenciamento do Tempo de Vida do Processo (PLM), salvar minidespejos e executar executáveis no console, conforme mostrado na figura a seguir.

​

Game Processes

O processo do título e todos os programas utilitários em execução no Game OS são listados na tabela Game Processes. As colunas exibidas na tabela mostram o status atual de um processo, juntamente com seu identificador de processo (PID) e o número de threads em execução e de identificadores abertos. O conjunto de colunas exibido na tabela pode ser alterado usando o ícone de engrenagem ao lado do cabeçalho da tabela. A coluna Status inclui os três ícones a seguir.

• O ícone de triângulo fica verde quando ocorre uma alteração nos dados do processo nos últimos cinco segundos.
• O ícone de quadrado fica vermelho quando o processo termina.
• O ícone de caixas duplas fica azul-claro quando um depurador está anexado ao processo.

Esses três ícones são mostrados na figura a seguir. Selecione a seta ao lado de um processo ou clique com o botão direito do mouse em uma linha da tabela para exibir um menu de contexto, conforme mostrado na figura a seguir. O menu de contexto oferece as seguintes ações:

• Anexar ao processo
• Encerrar o processo
• Salvar um minidespejo
• Atualizar a janela de propriedades do Visual Studio com informações sobre esse processo.

Selecionar Save Dump As… no menu de contexto exibe uma caixa de diálogo que permite especificar o tipo de minidespejo e o arquivo no seu PC de desenvolvimento em que o minidespejo será salvo, conforme mostrado na figura a seguir.

​

Games

A guia Console Details inclui uma lista dos títulos registrados no console atual. A lista Games inclui um menu de contexto, conforme mostrado na figura a seguir, que pode ser usado para executar as seguintes ações:

• Iniciar, encerrar ou anexar a um título
• Escolher o executável do título a ser iniciado
• Definir os argumentos de linha de comando de um título
• Salvar um minidespejo
• Fazer a transição de um título para um estado de PLM diferente
• Exibir as propriedades de um título na janela de propriedades do Visual Studio.

Selecionar o menu de contexto Set Command Arguments… exibe uma caixa de edição que você pode usar para inserir os argumentos a serem passados para o título quando ele for iniciado. Depois de inserir os argumentos, selecione o botão Save Parameters para que os parâmetros sejam passados para o título na próxima vez que ele for iniciado.

​

Editar as propriedades do jogo

Selecionar o item de menu Show/Edit Title Properties na seção Games da exibição de detalhes do console preenche a página de propriedades do Visual Studio com um conjunto de propriedades do título. As propriedades são agrupadas em categorias. As propriedades mostradas em negrito podem ser editadas. A categoria Debugging contém propriedades que costumam ser definidas em vários cenários de depuração. Selecionar True na lista suspensa Break on Suspend Timeout faz com que o depurador interrompa a execução do seu título se o seu manipulador de suspensão levar mais de 1 segundo para ser concluído. Selecionar True na lista suspensa Log Module Loading faz com que a saída do carregador do sistema operacional seja exibida na janela Output do Visual Studio durante a depuração. O log do carregador inclui informações sobre todos os módulos que o sistema operacional carrega, incluindo redirecionamentos. A depuração de falhas de carregamento de DLL (incluindo “A dependent dll was not found”) é um uso comum desse log. Selecionar True na lista suspensa Stop at Entry Point faz com que o depurador interrompa a execução no ponto de entrada principal do título. Essa opção é útil para depurar problemas que ocorrem no início da inicialização do título. Consulte Propriedades do Visual Studio para desenvolvimento para XBOX para obter mais informações sobre essas propriedades.

​

Run Executable

A guia Console Details oferece a capacidade de iniciar executáveis de ferramentas no console. Essas ferramentas incluem as fornecidas pelo sistema operacional ou quaisquer ferramentas desenvolvidas pelo seu estúdio. As ferramentas iniciadas usando o XBOX Gaming Explorer são executadas no Game OS, não no System OS. Use a parte Run Executable da guia Console Details para especificar o caminho da sua ferramenta no console, juntamente com quaisquer argumentos de inicialização. A saída de qualquer ferramenta iniciada usando Run Executable é mostrada na janela de saída Gaming do Visual Studio. Na figura a seguir, Run Executable foi usado para executar o utilitário do sistema operacional filever.exe para listar as informações de versão de todos os executáveis do título em execução no momento. Você deve especificar o caminho totalmente qualificado do executável que deseja executar, a menos que esse executável esteja no diretório C:\windows\system32 no Game OS do seu console.

​

Consoles

A guia Consoles fornece uma lista dos consoles aos quais você pode se conectar e usar com o XBOX Gaming Explorer. Se você especificou um console padrão com o XBOX Manager ou o xbconnect, esse console aparecerá automaticamente no XBOX Gaming Explorer. O console padrão é identificado por um asterisco (*) ao lado do ícone que representa o console. Consoles adicionais podem ser adicionados usando o botão Add a Console na guia Consoles, conforme mostrado na figura a seguir. Selecionar um console na lista estabelece a conexão com esse console e atualiza a guia Console Details com os processos e títulos desse console. A lista de consoles tem um menu de contexto, conforme mostrado na figura a seguir, para executar várias ações no console, incluindo preencher a janela de propriedades do Visual Studio com informações sobre o console. As propriedades mostradas em negrito podem ser editadas diretamente na janela de propriedades.

​

XBOX Developer Tools Launcher

A guia XBOX Developer Tools Launcher, mostrada na figura a seguir, oferece uma maneira conveniente de iniciar outras ferramentas fornecidas com o Microsoft Game Development Kit (GDK). Inicie uma ferramenta selecionando o nome ou o ícone dela.

​

Veja também

Visual Studio Recuperar despejos de memória