XBOX Gaming Explorer

XBOX Gaming Explorer est une fenêtre hébergée dans l’environnement de développement intégré (IDE) Visual Studio qui simplifie les workflows de développement courants liés à la console, principalement le débogage, le lancement de processus et la surveillance de l’état de vos consoles. XBOX Gaming Explorer intègre certaines fonctionnalités courantes destinées aux développeurs issues de xbWatson et de XBOX Manager, et simplifie l’accès aux scénarios de débogage courants. Utilisez XBOX Gaming Explorer pour en faire davantage directement depuis l’IDE Visual Studio. XBOX Gaming Explorer est accessible à partir du menu XBOX de Visual Studio. Le menu XBOX se trouve sous le menu Extensions, comme illustré dans la figure suivante. Les fonctionnalités de XBOX Gaming Explorer sont regroupées en trois onglets : Console Details, Consoles et XBOX Developer Tools Launcher. Le ruban permettant de sélectionner l’un des quatre onglets offre aussi la possibilité d’afficher cette page d’aide et d’accéder à la fonctionnalité Report A Problem, commune à d’autres outils comme XBOX Manager.

​

Console Details

Utilisez l’onglet Console Details pour surveiller le processus de jeu en cours d’exécution sur votre console, lancer et déboguer les titres inscrits, faire passer votre titre par les différents états de gestion de la durée de vie des processus (PLM), enregistrer des minidumps et exécuter des exécutables sur la console, comme illustré dans la figure suivante.

​

Game Processes

Le processus du titre et tous les programmes utilitaires exécutés dans Game OS sont répertoriés dans le tableau Game Processes. Les colonnes affichées dans le tableau indiquent l’état actuel d’un processus, ainsi que son identificateur de processus (PID), le nombre de threads en cours d’exécution et le nombre de handles ouverts. L’ensemble des colonnes affichées dans le tableau peut être modifié à l’aide de l’icône d’engrenage située à côté de l’en-tête du tableau. La colonne Status comprend les trois icônes suivantes.

• L’icône en forme de triangle devient verte lorsqu’une modification des données du processus s’est produite au cours des cinq dernières secondes.
• L’icône en forme de carré devient rouge lorsque le processus s’est terminé.
• L’icône en forme de double carré devient bleu clair lorsqu’un débogueur est attaché au processus.

Ces trois icônes sont illustrées dans la figure suivante. Sélectionnez la flèche située à côté d’un processus ou cliquez avec le bouton droit sur une ligne du tableau pour afficher un menu contextuel, comme illustré dans la figure suivante. Le menu contextuel permet d’effectuer les actions suivantes :

• S’attacher au processus
• Arrêter le processus
• Enregistrer un minidump
• Mettre à jour la fenêtre Propriétés de Visual Studio avec des informations sur ce processus.

La sélection de Save Dump As… dans le menu contextuel affiche une boîte de dialogue qui vous permet de spécifier le type de minidump et le fichier de votre PC de développement dans lequel le minidump sera enregistré, comme illustré dans la figure suivante.

​

Games

L’onglet Console Details inclut la liste des titres inscrits sur la console actuelle. La liste Games comporte un menu contextuel, illustré dans la figure suivante, qui permet d’effectuer les actions suivantes :

• Lancer ou arrêter un titre, ou s’y attacher
• Choisir l’exécutable du titre à lancer
• Définir les arguments de ligne de commande d’un titre
• Enregistrer un minidump
• Faire passer un titre à un autre état PLM
• Afficher les propriétés d’un titre dans la fenêtre Propriétés de Visual Studio.

La sélection du menu contextuel Set Command Arguments… affiche une zone de modification qui vous permet de saisir les arguments à passer au titre lors de son lancement. Après avoir saisi les arguments, sélectionnez le bouton Save Parameters pour que les paramètres soient passés au titre lors de son prochain lancement.

​

Modification des propriétés d’un jeu

La sélection de l’élément de menu Show/Edit Title Properties dans la section Games de la vue des détails de la console remplit la page de propriétés de Visual Studio avec un ensemble de propriétés du titre. Les propriétés sont regroupées par catégorie. Les propriétés affichées en gras peuvent être modifiées. La catégorie Debugging contient des propriétés couramment définies dans divers scénarios de débogage. La sélection de True dans la liste déroulante Break on Suspend Timeout provoque l’arrêt du débogueur dans votre titre si l’exécution de votre gestionnaire de suspension prend plus d’une seconde. La sélection de True dans la liste déroulante Log Module Loading entraîne l’affichage de la sortie du chargeur du système d’exploitation dans la fenêtre Sortie de Visual Studio pendant le débogage. La journalisation du chargeur inclut des informations sur tous les modules chargés par le système d’exploitation, y compris les redirections. Le débogage des échecs de chargement de DLL (y compris “A dependent dll was not found”) est une utilisation courante de cette journalisation. La sélection de True dans la liste déroulante Stop at Entry Point provoque l’arrêt du débogueur sur le point d’entrée principal du titre. Cette option est utile pour déboguer les problèmes qui se produisent tôt dans le démarrage du titre. Pour plus de renseignements sur ces propriétés, voir Propriétés Visual Studio pour le développement XBOX.

​

Run Executable

L’onglet Console Details permet de lancer des exécutables d’outils sur la console. Ces outils incluent ceux fournis par le système d’exploitation ou tout outil développé par votre studio. Les outils lancés à l’aide de XBOX Gaming Explorer s’exécutent dans Game OS, et non dans System OS. Utilisez la partie Run Executable de l’onglet Console Details pour spécifier le chemin d’accès à votre outil sur la console, ainsi que les éventuels arguments de lancement. La sortie de tout outil lancé à l’aide de Run Executable est affichée dans la fenêtre de sortie Gaming de Visual Studio. Dans la figure suivante, Run Executable a été utilisé pour exécuter l’utilitaire du système d’exploitation filever.exe afin de répertorier les informations de version de tous les exécutables du titre en cours d’exécution. Vous devez spécifier le chemin d’accès complet à l’exécutable que vous voulez exécuter, sauf si cet exécutable se trouve dans le répertoire C:\windows\system32 de Game OS sur votre console.

​

Consoles

L’onglet Consoles fournit la liste des consoles auxquelles vous pouvez vous connecter et que vous pouvez utiliser avec XBOX Gaming Explorer. Si vous avez spécifié une console par défaut avec XBOX Manager ou xbconnect, cette console apparaît automatiquement dans XBOX Gaming Explorer. La console par défaut est signalée par un astérisque (*) à côté de l’icône qui la représente. Vous pouvez ajouter d’autres consoles à l’aide du bouton Add a Console de l’onglet Consoles, comme illustré dans la figure suivante. La sélection d’une console dans la liste établit la connexion à cette console et met à jour l’onglet Console Details avec les processus et les titres de cette console. La liste des consoles comporte un menu contextuel, illustré dans la figure suivante, qui permet d’effectuer diverses actions sur la console, notamment remplir la fenêtre Propriétés de Visual Studio avec des informations sur la console. Les propriétés affichées en gras peuvent être modifiées directement depuis la fenêtre Propriétés.

​

XBOX Developer Tools Launcher

L’onglet XBOX Developer Tools Launcher, illustré dans la figure suivante, offre un moyen pratique de lancer les autres outils fournis avec le Microsoft Game Development Kit (GDK). Lancez un outil en sélectionnant son nom ou son icône.

​

Voir aussi

Visual Studio Récupération des vidages sur incident