Étape 1 : vérifier les exigences du PC de développement
Système d’exploitation
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.
Matériel 10 GbE de référence validé
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
Étape 2 : installer le Windows SDK
Les titres GDK sont basés sur Win32, donc le 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 partitionWINAPI_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 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++.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.
Étape 4 : télécharger et installer le GDK
- Téléchargez le GDK, et éventuellement Game Core for XBOX, depuis la page de téléchargement du GDK XBOX. L’accès ID@XBOX est requis.
- Exécutez le programme d’installation en tant qu’Administrateur.
- Acceptez les termes de la licence.
- Sélectionnez le GDK, et éventuellement les composants Game Core for XBOX.
- Attendez la fin de l’installation, puis redémarrez si vous y êtes invité.
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,
XMemAllocet 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 commandexb*, 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.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 avecmsbuild 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.
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.Exemples GDK
Exemples de référence fournis avec le GDK.