Passer au contenu principal

​
Configuration de l’environnement de build sans installer le Microsoft Game Development Kit

Cette rubrique traite de la configuration de l’environnement de build et des invites de commandes au sein du Microsoft Game Development Kit (GDK) extrait, car ceux-ci nécessitent des étapes supplémentaires après l’extraction du Microsoft Game Development Kit (GDK) pour fonctionner correctement.

​
Fichiers de commandes des variables d’environnement

Le Microsoft Game Development Kit (GDK) inclut un ensemble de fichiers .cmd utilisés pour définir les variables d’environnement. Ils sont nécessaires pour créer correctement des invites de commandes donnant accès aux opérations en ligne de commande (y compris la génération avec MSBuild). Il existe deux instances de ces fichiers .cmd. Elles se trouvent aux emplacements de fichiers extraits suivants, donnés à titre d’exemple.
  • C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd
  • C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingDesktopVars.cmd
L’examen de ces fichiers peut vous aider à mieux comprendre comment les variables d’environnement sont définies et détectées. La plupart des variables d’environnement sont définies en fonction d’une vérification IF NOT, de sorte qu’elles peuvent être remplacées si elles sont définies avant l’exécution. La première variable d’entrée, %1, sert à déterminer la plateforme et la version de Visual Studio. Les valeurs disponibles sont les suivantes :
  • GamingXboxVS2019
  • GamingXboxVS2022
  • GamingXboxScarlettVS2019
  • GamingXboxScarlettVS2022
  • GamingDesktopVS2019
  • GamingDesktopVS2022
Voici un exemple de cette utilisation (depuis la ligne de commande) : GamingXboxVars.cmd GamingXboxVS2022. Cela configure une invite de commandes avec des variables d’environnement définies pour travailler avec XBOX et Visual Studio 2022. Les sections suivantes précisent quelles variables d’environnement doivent être remplacées pour configurer une invite de commandes qui référence les fichiers du kit extraits.
Pour les nouvelles dispositions du GDK, les noms de paramètres sont : GamingXboxGen8VS2019, GamingXboxGen8VS2022, GamingXboxGen9VS2019, GamingXboxGen9VS2022, GamingWindowsVS2019 ou GamingWindowsVS2022.

​
Configuration des variables d’environnement pour Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64

Avant d’appeler GamingXboxVars.cmd dans les invites de commandes du Microsoft Game Development Kit (GDK), les variables d’environnement suivantes doivent être définies pour faire référence aux emplacements extraits et remplacer les vérifications de l’installation locale.
  • GXDKEDITION : numéro d’édition du Gaming XBOX Development Kit (GXDK). Par exemple, 220300 fait référence au Microsoft Game Development Kit (GDK) de mars 2022.
  • GameDK : emplacement racine du Microsoft Game Development Kit (GDK).
  • GameDKLatest : dossier du dernier numéro d’édition sous l’emplacement racine.
  • WindowsSdkDir : emplacement du SDK Windows 10.
  • GamingGRDKBuild : emplacement des fichiers propres au Gaming Runtime Development Kit (GRDK).
  • GamingGXDKBuild : emplacement des fichiers propres au Microsoft Game Development Kit (GDK).
  • VSInstallDir : emplacement de l’installation de Visual Studio.
Voici des exemples de commandes permettant de définir ces variables d’environnement pour qu’elles pointent vers des fichiers extraits donnés à titre d’exemple.
Utilisez la variable d’entrée de GamingXboxVars.cmd, décrite dans la section précédente, pour basculer entre les environnements XBOX One et XBOX Series X|S.

​
Configuration des variables d’environnement pour Gaming.Desktop.x64

Avant d’appeler GamingDesktopVars.cmd dans les invites de commandes du Microsoft Game Development Kit (GDK), les variables d’environnement suivantes doivent être définies pour faire référence aux emplacements extraits et remplacer les vérifications de l’installation locale.
  • GRDKEDITION : numéro d’édition du Gaming Runtime Development Kit (GRDK). Par exemple, 220300 fait référence au Microsoft Game Development Kit (GDK) de mars 2022.
  • GameDK : emplacement racine du Microsoft Game Development Kit (GDK).
  • GameDKLatest : dossier du dernier numéro d’édition sous l’emplacement racine.
  • WindowsSdkDir : emplacement du SDK Windows 10.
  • GamingGRDKBuild : emplacement des fichiers propres au Gaming Runtime Development Kit (GRDK).
  • VSInstallDir : emplacement de l’installation de Visual Studio.
Voici des exemples de commandes permettant de définir ces variables d’environnement pour qu’elles pointent vers des fichiers extraits donnés à titre d’exemple.

​
Configuration de l’invite de commandes

Lorsque le Microsoft Game Development Kit (GDK) est installé, les invites de commandes sont créées sous forme de raccourcis vers le fichier .cmd d’invite de commandes du Microsoft Game Development Kit (GDK) approprié. En voici un exemple. C:\Windows\System32\cmd.exe /k "C:\ExtractedGDK\220300\Microsoft GDK\Command Prompts\GamingXboxVars.cmd" GamingXboxVS2022 La création d’un raccourci avec le contenu précédent fournira la même configuration d’environnement que les scripts d’invite de commandes installés. Il est recommandé d’encapsuler dans un script la définition des variables d’environnement ci-dessus, puis l’exécution de cette commande avec la variable d’entrée appropriée.

​
Références Lib et Include du Microsoft Game Development Kit (GDK)

Le script de variables d’environnement définit les emplacements suivants pour les chemins Lib et Include. Les exemples suivants, pour Gaming.Xbox.Scarlett.x64, sont fournis à titre de référence et ne doivent pas être remplacés (dans cet exemple, la version des outils MSVC est dérivée de la variable d’environnement VCToolsVersion).

​
Références Lib et Include du SDK Windows 10

Le script de variables d’environnement définit les emplacements suivants pour les chemins Lib et Include du SDK Windows 10. Les exemples suivants sont fournis à titre de référence et ne doivent pas être remplacés.

​
Voir aussi

Dernière modification le 6 octobre 2026