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

# Installer la chaîne d'outils du GDK

> Exigences, prérequis et instructions d'installation pas à pas du Windows SDK, de Visual Studio et du XBOX Game Development Kit sur votre PC de développement.

Configurez votre PC de développement, installez la chaîne d'outils et téléchargez le GDK. Effectuez les étapes dans l'ordre. Les étapes ultérieures dépendent des précédentes.

## Étape 1 : vérifier les exigences du PC de développement

### Système d'exploitation

<Warning>
  Les composants Visual Studio (VSIX) du GDK ne prennent pas en charge les appareils ARM. Installez le GDK sur un PC de développement x64.
</Warning>

| Objectif                                         | Prise en charge                                                                  |
| ------------------------------------------------ | -------------------------------------------------------------------------------- |
| Développement de titres XBOX (clients)           | Windows 10 ou Windows 11 (64 bits) : Famille, Pro ou Entreprise.                 |
| Développement de titres XBOX (serveurs de build) | Windows Server 2019 (1809 ou ultérieur) : Standard ou Datacenter.                |
| Développement de titres Windows (Gaming Runtime) | Windows 10 May 2019 Update ou ultérieur (64 bits), ou Windows 11 (64 bits).      |
| Test de jeux PC packagés en MSIXVC               | Windows 10 May 2019 Update ou ultérieur (64 bits), avec Gaming Services Runtime. |

### Matériel

* Un PC x64 rapide et récent avec 30 GB d'espace libre pour l'installation du GDK.
* Pour le développement ciblant XBOX, utilisez un SSD NVMe (avec dissipateur thermique), une carte réseau 10 GbE sur le PC de développement, un commutateur 10 GbE avec des câbles Cat 6a (PC de développement et dev kit sur le même sous-réseau) et une carte mère compatible Thunderbolt 3.
* Des écrans 4K ou UHD compatibles HDR pour valider les fonctionnalités d'affichage.

<Accordion title="Matériel 10 GbE de référence validé">
  - Commutateur 8 ports Netgear XS708T
  - Adaptateur PCIe 10GBase-T AQuantia Aqtion AQN-107
  - Intel Ethernet Converged Network Adapter X540-T1
  - SSD Samsung 970 EVO NVMe M.2 1 TB
  - Câbles Ethernet de catégorie 6a
</Accordion>

## Étape 2 : installer le Windows SDK

Les titres GDK sont basés sur Win32, donc le [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) est essentiel à l'expérience développeur. Il fournit Direct3D, XAudio, les API PIX for Windows, les services de base du système d'exploitation, la partition `WINAPI_FAMILY_GAMES`, `xgameplatform.lib`, l'API unifiée [GameInput](/build/core-features/common/input/overviews/input-overview) et la gestion du cycle de vie des processus (PLM).

Version minimale requise : Windows SDK 22000 ou ultérieur (Windows 11 SDK). Installez-le de manière autonome ou comme composant facultatif du Visual Studio Installer.

## Étape 3 : installer Visual Studio

Utilisez Visual Studio 2022 ou Visual Studio 2026 avec la charge de travail C++.

<Note>
  Si vous installez une nouvelle édition de Visual Studio après le GDK, réparez le GDK afin qu'il s'intègre à la nouvelle édition. Si vous devez désinstaller Visual Studio, désinstallez d'abord le GDK.
</Note>

<Tip>
  Créez un point de restauration système avant d'installer le GDK.
</Tip>

## Étape 4 : télécharger et installer le GDK

1. Téléchargez le GDK, et éventuellement Game Core for XBOX, depuis la [page de téléchargement du GDK XBOX](https://aka.ms/gdkdl). L'accès ID\@XBOX est requis.
2. Exécutez le programme d'installation en tant qu'**Administrateur**.
3. Acceptez les termes de la licence.
4. Sélectionnez le GDK, et éventuellement les composants Game Core for XBOX.
5. Attendez la fin de l'installation, puis redémarrez si vous y êtes invité.

Après l'installation, ouvrez Visual Studio et vérifiez que les plateformes **Gaming.Desktop.x64** et **Gaming.XBOX.Scarlett.x64** apparaissent dans le Gestionnaire de configuration.

### Ce que contient le GDK

* **Gaming Runtime :** packaging MSIXVC, TCUI, Connected Storage, blocs asynchrones, association d'appareils, utilisateur, TTS, accessibilité et Screen Time.
* **Gaming Cloud Services :** XSAPI, XAL, réseau multijoueur, PlayFab et Store avec achats intégrés.
* **Extensions d'appareils de jeu :** DirectX 12.x, Audio.x, PIX.x, `XMemAlloc` et autres API mémoire spécifiques à la console.

## Outils PC et XBOX

**Jeux PC :** itérez, testez et déboguez localement avec les outils Visual Studio standard et PIX for Windows. Vous pouvez également configurer VS Remote Tools pour reproduire des problèmes sur un PC de laboratoire.

**Jeux XBOX :** itérez à distance sur des consoles XBOX Series X|S ou des dev kits de la famille XBOX One à l'aide de PIX for XBOX, des outils en ligne de commande `xb*`, de XBOX Manager, de Dev Home et du XBOX Device Portal (XDP).

## Serveurs de symboles Microsoft

Activez les serveurs de symboles Microsoft pour obtenir les symboles du Gaming Runtime. Dans Visual Studio, accédez à **Débogage** > **Options** > **Symboles** et sélectionnez **Serveurs de symboles Microsoft**. Consultez la documentation du [serveur de symboles publics Microsoft](https://learn.microsoft.com/windows-hardware/drivers/debugger/microsoft-public-symbols).

## Build Without Install (BWOI)

BWOI permet à vos serveurs de build d'utiliser le GDK sans exécuter le programme d'installation. C'est essentiel pour la CI et les environnements de build verrouillés. Extrayez la charge utile d'installation du GDK dans un répertoire connu, faites pointer vos variables d'environnement de build vers celui-ci, puis compilez avec `msbuild` ou votre chaîne d'outils.

* BWOI n'installe pas l'intégration VSIX de Visual Studio.
* Certains outils nécessitent une étape d'extraction ponctuelle, comme les charges utiles de XBTC et de makepkg.
* Les dev kits attribués à chaque développeur et PIX s'installent toujours normalement sur les stations de travail.

Utilisez BWOI pour exécuter des builds GDK dans une CI conteneurisée.

## Développement de jeux Windows à distance

Utilisez les outils de développement de jeux à distance pour déployer et déboguer sur un Windows PC distant via le réseau de développement. Cela facilite les pipelines de développement multi-PC — par exemple, un artiste sur Windows 10, une build sur Server 2019 et une cible sur un PC de test distinct. Hyper-V ou VMware conviennent pour des images de test éphémères.

## Étapes suivantes

Vérifiez que votre installation fonctionne en ouvrant un exemple fourni dans Visual Studio.

<Card title="Exemples GDK" icon="arrow-right" href="/home/setup-install/samples">
  Exemples de référence fournis avec le GDK.
</Card>


## Related topics

- [Configurer et installer le GDK](/fr/home/setup-install/get-started.md)
- [Exemples GDK](/fr/home/setup-install/samples.md)
- [Compiler et exécuter votre premier titre console avec le GDKX](/fr/home/build-first-title/first-console-title-walkthrough.md)
- [Exigences de sécurité pour les titulaires de licence du GDK](/fr/home/onboarding-access/security-requirements.md)
- [Intégration des partenaires XBOX pour l'accès et la publication](/fr/home/onboarding.md)