> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

Le Microsoft Game Development Kit (GDK) comprend des pages de propriétés Visual Studio personnalisées qui servent à configurer les projets 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**.

Les pages de propriétés **XBOX** et connexes suivantes sont disponibles.

* [XBOX General](#general)
* [XBOX Deploy](#deploy)
* [XBOX Layout](#layout)
* [Debugging](#debugging)
* [Pages de propriétés connexes](#related)
* [Game Dependency Lookup](#gamedependency)

<a id="general" />

## XBOX General

La page de propriétés **XBOX General** contient les propriétés suivantes.

* **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 aussi ê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)](/fr-CA/tools/tools-console/commandlinetools/xbconnect), [XBOX Manager](/fr-CA/tools/tools-console/xbom/xbom) ou [Windows Device Portal](/fr-CA/tools/tools-console/wdp/wdp) 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 de renseignements sur l'ajout de ressources localisées à votre projet, consultez [Localisation de MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Localization).

**Figure 1. La page de propriétés XBOX General** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_general.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2dd98c01503a3c4b3a5a8fb40167fca2" alt="Page de propriétés General" width="1162" height="809" data-path="images/gdk/tools/property_page_general.png" />

<Note>
  Il est aussi possible de spécifier l'adresse IP distante dans un fichier *project*.vcxproj.user, stocké avec *project*.vcxproj dans le répertoire du projet. Ce fichier doit avoir le format suivant.
</Note>

```text theme={null}
  <?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>  
```

Dans l'exemple précédent, remplacez *10.10.10.10* par l'adresse de votre console distante.

<a id="deploy" />

## XBOX Deploy

La page de propriétés **XBOX Deploy** permet de sélectionner chaque méthode de déploiement. Selon la sélection, la page de propriétés propose des options différentes. Pour plus de renseignements sur le déploiement, consultez [Déployer votre titre sur un dev kit](/fr-CA/home/setup-install/concepts/deployment).

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

Cette méthode de déploiement déploie le titre dans un dossier du kit de développement (xD:\Titles par défaut). Elle comprend les propriétés suivantes.

* **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)

Cette méthode de déploiement délègue le déploiement à un mécanisme externe et indépendant. Elle comprend les propriétés suivantes.

* **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)

Cette méthode de déploiement exécute le titre depuis le PC de développement par un partage réseau accessible au kit de développement.

* **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).

> <img src="https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29" alt="attention" width="11" height="11" data-path="images/gdk/tools/caution.gif" />**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)](/fr-CA/tools/tools-console/wdp/wdp) ou [Developer Home sur la console (Dev Home)](/fr-CA/tools/tools-console/devhome/devhome).

**Figure 2. Les pages de propriétés XBOX Deploy selon la méthode de déploiement** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2645bd2b57441d389e5d623a215d9602" alt="Page de propriétés Deploy pour Push" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_external.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=6956ecceabb322d6b75dae3477011d39" alt="Page de propriétés Deploy pour External" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_external.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_rfpc.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=cc068e6967bb903be4e5a6c57149bd2c" alt="Page de propriétés Deploy pour Run from PC" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_rfpc.png" />

<a id="layout" />

## XBOX Layout

La page de propriétés **XBOX Layout** contient les propriétés suivantes.

* **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** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_layout.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=996357b982ee8d5b00c0ea2b5252398c" alt="Page de propriétés Layout" width="785" height="545" data-path="images/gdk/tools/property_page_layout.png" />

<a id="debugging" />

## Debugging

La page de propriétés **Debugging** contient les propriétés suivantes.

* **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** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_debug.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=76a15961c2b3b73d8fc332052faa57f8" alt="Page de propriétés Debugging" width="1172" height="812" data-path="images/gdk/tools/property_page_debug.png" />

<a id="related" />

## Pages de propriétés connexes

Certaines propriétés supplémentaires, sans être propres à XBOX, ont des paramètres requis ou recommandés pour les applications XBOX. Ces paramètres garantissent un fonctionnement correct et optimal des applications XBOX et sont les suivants.

**RandomizedBaseAddress :** doit être défini sur **Yes**, valeur par défaut d'un projet GDK. Ce paramètre est requis pour le fonctionnement de la randomisation du format de l'espace d'adressage (ASLR). L'ASLR est requise par les applications XBOX. Ne définissez pas **RandomizedBaseAddress** sur **No** et ne tentez pas de désactiver l'ASLR.

**RandomizedBaseAddress** est défini dans la page de propriétés **Linker**/**Advanced**.

<a id="gamedependency" />

## Game Dependency Lookup

Lorsque vous spécifiez une dépendance de jeu dans votre projet, la recherche porte sur le chemin local en plus de la racine du jeu G: et de tous ses sous-répertoires afin de trouver les fichiers dépendants.

<a id="ID4EIIAC" />

## Voir aussi

[Gestion des applications (xbapp.exe)](/fr-CA/tools/tools-console/commandlinetools/xbapp)

[Connexion (xbconnect.exe)](/fr-CA/tools/tools-console/commandlinetools/xbconnect)

[Déployer votre titre sur un dev kit](/fr-CA/home/setup-install/concepts/deployment)

[Procédure : déployer des fichiers de ressources de jeu à l'aide de Visual Studio](/fr-CA/tools/tools-console/visualstudio/how-to-deploy-resources)


## Related topics

- [Visual Studio pour le développement sur console](/fr-CA/tools/tools-console/visualstudio/visualstudio.md)
- [Notes de prise en charge du GDK pour Visual Studio 2022](/fr-CA/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Notes de prise en charge du GDK pour Visual Studio 2026](/fr-CA/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Déboguer des projets XBOX à l'aide de Visual Studio](/fr-CA/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [Propriétés Visual Studio pour le développement de jeux sur PC](/fr-CA/tools/tools-pc/visualstudio/gr-vs-property-pages.md)