> ## 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 étape par étape pour le Windows SDK, Visual Studio et le 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. Suivez les étapes dans l'ordre. Les étapes ultérieures dépendent des précédentes.

## Étape 1 : Confirmer 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                                               | Pris 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 compilation) | 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 des jeux PC empaquetés en MSIXVC                  | Windows 10 May 2019 Update ou ultérieur (64 bits), avec Gaming Services Runtime. |

### Matériel

* Un PC x64 rapide et moderne 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 (le PC de développement et le kit de développement 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 validé de référence">
  - 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 au cœur de l'expérience de développement. 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 façon autonome ou comme composant optionnel 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 facultativement Game Core for XBOX, à partir de la [page de téléchargement du GDK XBOX](https://aka.ms/gdkdl). Cela requiert un accès ID\@XBOX.
2. Exécutez le programme d'installation en tant qu'**administrateur**.
3. Acceptez les modalités de la licence.
4. Sélectionnez le GDK, et facultativement les composants Game Core for XBOX.
5. Attendez que le programme d'installation se termine, puis redémarrez si vous y êtes invité.

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

### Ce qui est inclus dans le GDK

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

## Outils PC et XBOX

**Jeux PC :** Itérez, testez et déboguez localement avec les outils standards de Visual Studio et PIX for Windows. Facultativement, configurez les VS Remote Tools pour reproduire des problèmes sur un PC de laboratoire.

**Jeux XBOX :** Itérez à distance sur des kits de développement de consoles XBOX Series X|S ou 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, allez à **Debug** > **Options** > **Symbols** et sélectionnez **Microsoft Symbol Servers**. 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 compilation d'utiliser le GDK sans exécuter le programme d'installation. C'est essentiel pour l'intégration continue et les environnements de compilation verrouillés. Extrayez la charge utile d'installation du GDK dans un répertoire connu, pointez vos variables d'environnement de compilation vers celui-ci et 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 unique, comme les charges utiles XBTC et makepkg.
* Les kits de développement individuels et PIX s'installent toujours normalement sur les postes de travail.

Utilisez BWOI pour exécuter des compilations GDK dans une intégration continue 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 compilation 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.

## Prochaines étapes

Confirmez que votre installation fonctionne en ouvrant un exemple fourni dans Visual Studio.

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


## Related topics

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