Skip to main content
Ceci est l’étape 3 du parcours guidé. Installez le GDK et compilez un exemple à partir de Configurer et installer le GDK avant de commencer ici. Chaque jeu GDK commence par un projet Visual Studio. Vous sélectionnez un modèle en fonction de l’endroit où votre jeu doit s’exécuter : Windows PC uniquement, consoles XBOX uniquement, ou les deux cibles à partir du même code. Vous n’avez pas besoin de trancher définitivement maintenant, car vous pouvez ajouter une autre cible plus tard.
Si vous n’êtes pas sûr de la cible à choisir, commencez par Desktop (Gaming.Desktop.x64) lorsque vous disposez d’un Windows PC et pas encore de dev kit. Vous pouvez tout tester localement. Ajoutez les cibles XBOX après avoir reçu un dev kit.

​
Modèles de projet

L’installation du GXDK ajoute neuf modèles de projet GDK à Visual Studio : cinq pour PC et quatre pour les consoles XBOX.

​
Créer un projet

  1. Ouvrez Visual Studio.
  2. Accédez à Fichier > Nouveau > Projet.
  3. Dans Tous les langages, sélectionnez C++. Dans Toutes les plateformes, sélectionnez XBOX ou Windows. Dans Tous les types de projets, sélectionnez Jeux. Vous pouvez aussi effectuer une recherche par nom de modèle.
  4. Sélectionnez un modèle, puis sélectionnez OK.

​
Sélectionner un modèle

​
PC uniquement

Commencez avec Direct3D 12 Desktop Game.
  • Utilise WINAPI_FAMILY_DESKTOP_APP et se lie à l’ensemble complet des bibliothèques PC, y compris kernel32.lib et user32.lib.
  • Inclut les en-têtes et bibliothèques pour D3D12. Fournit une swap chain simple, un périphérique D3D et une boucle de mise à jour et de rendu.
  • Inclut XGameRuntime.h et lie XGameRuntime.lib. Toutes les capacités du Gaming Runtime du GDK sont prêtes.
  • Bibliothèque d’extension XSAPI disponible par défaut.
  • Se compile sur la plateforme x64 standard ou la plateforme personnalisée Gaming.Desktop.x64.
  • Crée un fichier MicrosoftGameConfig.mgc avec des espaces réservés pour votre identité Partner Center.

​
XBOX uniquement

Commencez avec Direct3D 12 XBOX Game.
  • Utilise WINAPI_FAMILY_GAMES et se lie à XGamePlatform.lib.
  • Inclut les en-têtes D3D12 prêts pour les extensions D3D12.x de XBOX.
  • Inclut XGameRuntime.h et lie XGameRuntime.lib.
  • Bibliothèque d’extension XSAPI disponible par défaut.
  • Utilise la plateforme MSBuild Gaming.XBOX.XboxOne.x64 avec la configuration attendue pour le débogage à distance.
  • Crée un fichier MicrosoftGameConfig.mgc avec des espaces réservés.

​
PC et XBOX (base de code partagée)

Commencez avec un modèle, par exemple Direct3D 12 Desktop Game, et ajoutez une seconde configuration de build ciblant Gaming.XBOX.XboxOne.x64 (ou inversement). Adaptez le code source avec des gardes #define ou #ifdef, ou isolez le code spécifique à la plateforme dans des DLL séparées :
  • La configuration PC utilise D3D12 standard.
  • La configuration XBOX utilise D3D12.x.
Changer la configuration active modifie automatiquement le débogueur, les bibliothèques liées et les autres paramètres d’outillage.

​
Livrer de bout en bout sur un dev kit

Avant de sélectionner un parcours plus approfondi, suivez la procédure pas à pas pratique sur console. Elle prend le modèle Direct3D 12 XBOX Game que vous avez créé et l’amène jusqu’à un déploiement en fichiers libres (loose) s’exécutant sur un dev kit XBOX. Elle produit ensuite un XVC installable.

Compiler et exécuter votre premier titre console avec le GDKX

Tutoriel en 14 étapes : épingler l’édition du GDK, ajouter DirectXTK12, compiler pour les consoles XBOX Series X|S, déployer sur un dev kit, diagnostiquer les échecs de lancement et produire un XVC installable.

​
Étapes suivantes

Vous avez un projet qui compile. Sélectionnez le parcours soigneusement conçu qui correspond à ce que vous publiez. Le guide vous oriente vers la documentation plus approfondie (Créer, Services, Optimiser, Publication et Références API) dont vous avez besoin ensuite.

Portage

Portez un titre déjà publié depuis une autre plateforme.

XBOX Play Anywhere

Un seul achat, PC et console. Sauvegardes partagées.

Consoles XBOX Series X|S

Console d’abord : Quick Resume, DirectStorage et Smart Delivery.

Windows et ROG XBOX Ally

Publiez sur Windows PC et sur consoles portables.

Unreal Engine

Plugins GDK et extensions de plateforme pour Unreal.

Unity

Intégration Unity pour PC et XBOX.

Godot et moteurs communautaires

Notes pour Godot, GameMaker et les moteurs personnalisés.
La plupart des titres associent le GDK à PlayFab pour l’identité, le multijoueur, les classements, l’économie et les live-ops. Vous pouvez l’intégrer à tout moment une fois que votre projet compile.

​
Voir aussi

Dernière modification le 1 septembre 2026

Sujets connexes

Compiler et exécuter votre premier titre console avec le GDKXGuides de portage vers le GDK XBOXVue d'ensemble de Godot et des moteurs communautairesGuide de certification étape par étapeVue d'ensemble de XBOX Series X|S