Skip to main content
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

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.

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

Étape 2 : Installer le Windows SDK

Les titres GDK sont basés sur Win32, donc le 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 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++.
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.
Créez un point de restauration système avant d’installer le GDK.

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

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.

Exemples du GDK

Exemples de référence fournis avec le GDK.
Dernière modification le 1 septembre 2026