> ## 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.

# Déployer votre titre sur un kit de développement

> Types de déploiement (Push, Run from PC, Streaming Install), outils (XBOX Manager, xbapp, Visual Studio) et conseils pour accélérer l'itération (NIC de débogage, XTD, mise en cache des données).

<Note>
  Depuis le GDK de mars 2022, **Run from PC** prend en charge le **Priority File Set** pour contrôler quels fichiers sont mis en cache avec la mise en cache des données — utilisez cette fonctionnalité pour une itération Run-from-PC prévisible lorsqu'elle est combinée avec [DirectStorage](/build/console-features/console-features-overview).
</Note>

## Types de déploiement

Le déploiement peut varier selon l'identité (inscrit ou non inscrit) et selon la méthode :

| Type | Description |
| - | - |
| **Push** | Copie le paquet complet dans le stockage local du kit de développement. Le plus lent à déployer, le plus rapide à exécuter. |
| **Run from PC (RfPC)** | Diffuse les fichiers depuis votre PC à la demande. Itération rapide; prend en charge la mise en cache des données pour des E/S représentatives de la vente au détail. |
| **Streaming Install** | Simule l'expérience Streaming Install de la version de vente au détail (installation à la demande, bloc par bloc). |
| **Registered / Unregistered Folder or Network** | Variantes pour tester des dispositions de fichiers non empaquetés et des scénarios réseau. |

### Déploiement Push

Utilisez Push lorsque vous voulez que le déploiement se présente et se comporte exactement comme une installation de vente au détail — le paquet réside entièrement sur le disque du kit de développement.

### Run from PC

Diffuse les fichiers sur le réseau (**XBTP**) ou via un partage SMB hérité. Deux variantes :

* **RfPC sur XBTP** (recommandé) — nécessite la configuration du pare-feu et les services XrfsSvc / XbtpLinkSvc sur le PC.
* **RfPC hérité basé sur un partage SMB**.

#### Configuration du RfPC sur XBTP

1. Activez RfPC dans les paramètres de déploiement de votre projet.
2. Configurez le pare-feu (voir ci-dessous).
3. Ajustez au besoin les paramètres de `XrfsSvc` et `XbtpLinkSvc` pour les grandes équipes ou les machines de build partagées.

#### Configuration du pare-feu

Autorisez les processus XrfsSvc et XbtpLinkSvc dans le pare-feu Windows Defender sur votre PC de développement. Les ports pour XBTP sont couverts dans [Configurer l'accès au réseau de développement](/fr-CA/home/setup-install/devkits/settings/configure-dev-network).

#### Mise en cache des données (kit de développement XBOX Series X)

La mise en cache des données met en miroir les fichiers servis par RfPC afin que le comportement des E/S corresponde étroitement à un déploiement Push — utile lorsque vous itérez sur des chemins de code DirectStorage.

* Activez et gérez le cache à l'aide de DevHome ou de XBOX Manager.
* Le **Priority File Set** (GDK de mars 2022 et versions ultérieures) vous permet de pré-mettre en cache des fichiers spécifiques, ce qui améliore la prévisibilité. Les règles sont rédigées dans un schéma Priority File Set et peuvent être appliquées à partir de la ligne de commande ou de Visual Studio. La génération automatique est prise en charge.

#### RfPC hérité par partage SMB

Toujours pris en charge. Nécessite des partages SMB sur le PC de développement pointant vers la disposition de votre paquet. Les liens symboliques sont pris en charge pour rediriger des portions du paquet.

### Streaming Install

Installe le titre par blocs pendant son exécution — exerce les chemins de code Streaming Install que votre titre utilisera dans la version de vente au détail.

## Outils

### XBOX Manager

* **Default Deploy**
* Assistant **Deploy/Install Application**
* **Déploiement par glisser-déposer**
* Déploiement via le **Folder Explorer**
* **Lancement** des titres déployés
* La liste **Games & Apps** affiche les types de déploiement (Push, RfPC, non inscrit).

### Invite de commandes (`xbapp`)

Déployez et lancez à partir de scripts :

```text theme={null}
xbapp deploy <package>
xbapp launch <aumid>
xbapp launch /d <aumid>        REM defer execution (attach a debugger first)
```

### Visual Studio

Déployez et lancez à partir des cibles MSBuild intégrées au GDK. Choisissez le type de déploiement dans les propriétés du projet.

### Autres lanceurs

* **XBOX Gaming Explorer** — lancez les titres déployés directement depuis Visual Studio.
* **DevHome** — lancez les titres à partir de l'interface de la console.

### Dossiers de superposition (overlay)

Superposez des fichiers individuels par-dessus un paquet installé pour une itération rapide — sans réempaquetage ni redéploiement. Consultez [Débogage avec des dossiers de superposition](/build/console-features/debugging-diagnostics/debugging-with-overlay-folders).

## Améliorer la vitesse d'itération

### Déployer via la NIC de débogage

La deuxième NIC du kit de développement (10 GbE) est nettement plus rapide que le port 1 GbE pour les déploiements.

**Prérequis**

* Une NIC 10 GbE dans votre PC de développement et un commutateur 10 GbE (ou un câble direct).
* Configurez la carte 10 GbE sur le PC de développement.
* Pointez votre espace de travail vers l'adresse IP de la NIC de débogage.

Consultez [Utiliser la deuxième NIC du kit de développement](/build/console-features/debugging-diagnostics/devkit-second-nic).

### Déployer avec le XTD (XBOX Transfer Device)

Le **XTD** décharge les transferts en masse via Thunderbolt.

* Tous les kits de développement ne prennent pas en charge le XTD; vérifiez donc la liste de compatibilité dans les spécifications matérielles des consoles XBOX de vente au détail et des kits de développement.
* Configurez le XTD sur votre PC de développement et branchez le câble Thunderbolt au kit de développement.
* Effectuez le dépannage à l'aide du flux de diagnostic standard (voir ci-dessous).
* Le XTD accélère également les captures et l'analyse PIX.
* **Jumelez le XTD avec la NIC de débogage** pour l'itération la plus rapide possible.

## Changements avec le GDK

* Prise en charge des **builds empaquetées côte à côte** — plusieurs builds du même titre installées en même temps.
* Les **titres XBOX One (ERA)** se déploient via le chemin du GDK.
* Changements d'**AUMID** — vérifiez vos scripts de lancement si vous avez migré depuis le XDK.
* Mises à jour du **scratch unifié** — comportement de `TitleScratch` / `SystemScratch` affiné.

## Dépannage du déploiement

Commencez par :

* [Analyser et diagnostiquer les erreurs](/build/console-features/debugging-diagnostics/inspecting-errors)
* [Dépannage des problèmes courants du GDK](/build/console-features/debugging-diagnostics/troubleshooting-common-issues)
* [Problèmes de la plateforme de déploiement](/build/console-features/debugging-diagnostics/troubleshooting-common-issues) (erreurs XTF, échecs d'installation non inscrite, diagnostics `xbtplink`)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Développer un nouveau titre GDK](/fr-CA/home/build-first-title/developing-new-titles.md)
- [Compiler et exécuter votre premier titre console GDKX](/fr-CA/home/build-first-title/first-console-title-walkthrough.md)
- [Documentation de développement de jeux XBOX](/fr-CA/index.md)
- [Configurer et installer le GDK](/fr-CA/home/setup-install/get-started.md)