Propriétés de Visual Studio pour le développement XBOX

​

Pour accéder aux pages de propriétés XBOX

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis sélectionnez Properties.
2. Développez Configuration Properties.
3. Repérez les pages de propriétés XBOX General, XBOX Deploy, XBOX Layout et Debugging.

• XBOX General
• XBOX Deploy
• XBOX Layout
• Debugging
• Pages de propriétés connexes
• Game Dependency Lookup

​

XBOX General

• Gaming Edition Target. Spécifie l’édition du GDK avec laquelle le projet sera généré. Par défaut, il s’agit de la version la plus élevée du GDK installée sur votre PC de développement.
• Gaming Extension Libraries. Spécifie l’ensemble des bibliothèques Gaming Extension à utiliser (comme Xbox.Services.API.C).
• Alternate Binary Subdirectory Cette propriété facultative permet de spécifier un sous-répertoire pour les binaires et les dépendances CRT sous la racine du jeu. Elle sert à refléter la structure du dossier Layout et est utilisée par le débogueur pour trouver l’exécutable lors du débogage. Lorsque vous spécifiez un sous-répertoire, le fichier MicrosoftGame.config doit toujours se trouver à la racine du titre. Toute modification des chemins de l’emplacement de l’exécutable dans le fichier MicrosoftGame.config doit également être mise à jour.
• Remote IP Address. Spécifie le nom ou l’adresse IP de la console distante. Il s’agit de la console sur laquelle les projets générés sont déployés, exécutés et débogués. Si cette propriété est laissée vide, ou définie sur une valeur vide, la console distante par défaut spécifiée par Connexion (xbconnect.exe), XBOX Manager ou Windows Device Portal est utilisée.
• Package Localization Dir. Spécifie un répertoire facultatif, relatif au répertoire du projet, à utiliser lors de la création de ressources d’interpréteur de commandes localisées. Pour plus d’informations sur l’ajout de ressources localisées à votre projet, consultez Localisation de MicrosoftGame.config.

Figure 1. La page de propriétés XBOX General

  <?xml version="1.0" encoding="utf-8"?>  
  <Project ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
      <RemoteAddress>10.10.10.10</RemoteAddress>  
    </PropertyGroup>  
  </Project>  

​

XBOX Deploy

​

Méthode XBOX Deploy : Push (exécution depuis le kit de développement)

• Deployment folder path override. Propriété facultative permettant de remplacer le chemin de déploiement par défaut sur le kit de développement.
• Remove extra files from target device. Propriété facultative qui, lorsqu’elle est cochée, supprime les fichiers présents sur la console qui ne font pas partie de la sortie de build du projet (fichiers orphelins).

​

Méthode XBOX Deploy : External (Visual Studio n’est pas utilisé pour le déploiement)

• Title launch string. Chaîne de lancement utilisée pour lancer le titre au démarrage du débogage (F5).
• Target devkit titles. Sélectionnez un titre dans la liste des titres correspondant au projet actuel sur le kit de développement cible pour renseigner la chaîne de lancement du titre.

​

Méthode XBOX Deploy : Run from PC (inscription d’un partage réseau)

• Network share path override. Propriété facultative permettant de remplacer le chemin de partage réseau par défaut pour le déploiement Run From PC.
• Network share username. Propriété facultative permettant d’accéder aux emplacements de partage réseau qui nécessitent des informations d’identification (partage réseau SMB).
• Network share password. Propriété facultative permettant d’accéder aux emplacements de partage réseau qui nécessitent des informations d’identification (partage réseau SMB).

ATTENTION : ce nom d’utilisateur et ce mot de passe sont transmis en texte clair et stockés localement en texte clair. Pour plus de sécurité, laissez ce champ vide et gérez vos informations d’identification comme indiqué dans XBOX Device Portal (Windows Device Portal sur XBOX) ou Developer Home sur la console (Dev Home).

Figure 2. Les pages de propriétés XBOX Deploy selon la méthode de déploiement

​

XBOX Layout

• Layout Directory. Spécifie le répertoire local dans lequel les résultats du build sont disposés. C’est depuis ce répertoire que l’application est déployée sur la console distante.
• Exclusion Filter. Spécifie les fichiers et types de fichiers qui ne seront pas copiés du répertoire de sortie du build vers le répertoire de disposition. Notez que cette propriété ne peut pas servir à exclure des fichiers situés en dehors du répertoire de sortie du build.
• Isolate Configurations. Lorsque cette propriété est définie sur Yes, Visual Studio traite chaque configuration de build comme une sortie distincte pour déterminer la liste des fichiers copiés dans le répertoire de disposition. La valeur par défaut est No.
• Game OS. Spécifie le chemin du Game OS à fournir avec la disposition en fichiers non empaquetés d’un titre.
• Deploy from Outdir. Lorsque cette propriété est définie sur Yes, Visual Studio déploie le contenu du répertoire de sortie du build au lieu de copier les fichiers dans le répertoire de disposition avant le déploiement. Les valeurs des propriétés Layout Directory, Exclusion Filter et Isolate Configurations sont alors ignorées.

Figure 3. La page de propriétés XBOX Layout

​

Debugging

• Debugger to launch : pour les projets XBOX, sélectionnez XBOX Game Core Debugger.
• Debugger Type. Spécifie le type de débogueur à utiliser. Lorsque cette propriété est définie sur Auto, le type de débogueur est sélectionné en fonction du contenu du fichier .exe.
• Command Arguments. Les arguments de ligne de commande à passer à l’application.
• Log Module Loading. Active la sortie de débogage détaillée, qui inclut des informations sur le chargement des modules. L’option Log Module Loading est utile pour déboguer les problèmes de type « dependent dll was not found ».

Figure 4. La page de propriétés Debugging

​

Pages de propriétés connexes

​

Game Dependency Lookup

​

Voir aussi