> ## 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 dev kit

> Types de déploiement (Push, Run from PC, Streaming Install), outils (XBOX Manager, xbapp, Visual Studio) et astuces 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 **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, en combinaison avec [DirectStorage](/build/console-features/console-features-overview).
</Note>

## Types de déploiement

Le déploiement peut se distinguer par identité (enregistré ou non enregistré) et par méthode :

| Type | Description |
| - | - |
| **Push** | Copie le package complet dans le stockage local du dev kit. 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 version commerciale. |
| **Streaming Install** | Simule l'expérience Streaming Install de la version commerciale (installation à la demande, bloc par bloc). |
| **Registered / Unregistered Folder or Network** | Variantes pour tester des dispositions en fichiers libres et des scénarios réseau. |

### Déploiement Push

Utilisez Push lorsque vous voulez que le déploiement ressemble et se comporte exactement comme une installation commerciale — le package réside intégralement sur le disque du dev kit.

### Run from PC

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

* **RfPC via 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 via XBTP

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

#### Configuration du pare-feu

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

#### Mise en cache des données (XBOX Series X Dev Kit)

La mise en cache des données réplique les fichiers servis par RfPC afin que le comportement des E/S soit très proche d'un déploiement Push — utile lorsque vous itérez sur des chemins de code DirectStorage.

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

#### RfPC hérité via partage SMB

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

### Streaming Install

Installe par blocs pendant l'exécution du titre — exerce les chemins de code Streaming Install que votre titre utilisera en version commerciale.

## Outils

### XBOX Manager

* **Default Deploy**
* **Assistant Deploy/Install Application**
* **Drag deploy**
* Déploiement via l'**Explorateur de dossiers**
* **Lancement** des titres déployés
* La liste **Games & Apps** affiche les types de déploiement (Push, RfPC, non enregistré).

### Invite de commandes (`xbapp`)

Déployez et lancez depuis des 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 depuis les 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 depuis l'interface de la console.

### Dossiers de superposition

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

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

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

La seconde carte réseau (NIC) du dev kit (10 GbE) est nettement plus rapide que le port 1 GbE pour les déploiements.

**Prérequis**

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

Consultez [Utiliser la seconde carte réseau du dev kit](/build/console-features/debugging-diagnostics/devkit-second-nic).

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

Le **XTD** décharge les transferts volumineux via Thunderbolt.

* Tous les dev kits ne prennent pas en charge le XTD ; vérifiez la liste de compatibilité dans les spécifications matérielles des consoles XBOX commerciales et des dev kits.
* Configurez le XTD sur votre PC de développement et branchez le câble Thunderbolt au dev kit.
* En cas de problème, suivez le flux de diagnostic standard (voir ci-dessous).
* Le XTD accélère également les captures et l'analyse PIX.
* **Associez le XTD au NIC de débogage** pour l'itération la plus rapide possible.

## Changements avec le GDK

* Prise en charge des **builds packagées côte à côte** — plusieurs builds du même titre installées simultanément.
* Les **titres XBOX One (ERA)** se déploient via le chemin 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é.

## Résoudre les problèmes de déploiement

Commencez par :

* [Analyser et diagnostiquer les erreurs](/build/console-features/debugging-diagnostics/inspecting-errors)
* [Résoudre les problèmes GDK courants](/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 enregistrée, diagnostics `xbtplink`)


## Related topics

- [Développer un nouveau titre GDK](/fr/home/build-first-title/developing-new-titles.md)
- [Compiler et exécuter votre premier titre console GDKX](/fr/home/build-first-title/first-console-title-walkthrough.md)
- [Configurer et installer le GDK](/fr/home/setup-install/get-started.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Intégration des partenaires XBOX : accès et publication](/fr/home/onboarding.md)