Passer au contenu principal
Ce document décrit le processus d’obtention d’un Microsoft Game Development Kit (GDK) extrait à utiliser sans installation. Cette section fournit des instructions pour effectuer cette opération pour le GDK et le SDK Windows. Ce processus est destiné aux utilisateurs avancés.
Ce processus ne remplace pas la nécessité d’installer le Microsoft Game Development Kit (GDK) dans la plupart des scénarios. Le processus permet les scénarios suivants :
  1. Extraire les en-têtes et les bibliothèques à utiliser dans votre processus de génération.
  2. Extraire le dossier Sideload afin que xbprovision (rubrique sous NDA) puisse être exécuté à partir d’un Microsoft Game Development Kit (GDK) donné sans installer ce Microsoft Game Development Kit (GDK) complet.
Il est possible d’exécuter certains outils du Microsoft Game Development Kit (GDK) après avoir extrait la charge utile d’installation de cette façon. Toutefois, cette pratique n’est pas officiellement prise en charge et vous pourriez rencontrer des problèmes.

Téléchargement du Microsoft Game Development Kit extrait

Le Microsoft Game Development Kit (GDK) extrait, une option offerte aux utilisateurs avancés, permet d’intégrer des fichiers précis dans un système de génération sans installer le Microsoft Game Development Kit (GDK) complet. Le Microsoft Game Development Kit (GDK) extrait est offert comme option de téléchargement distincte sur le site Téléchargements pour développeurs XBOX. Cette option de téléchargement comporte le mot Extracted dans son titre pour la distinguer de l’option de téléchargement du programme d’installation du GDK.
L’utilisation de cette option de téléchargement vous permet d’éviter le processus d’extraction manuelle du Microsoft Game Development Kit. Il s’agit de l’option recommandée.

Extraction manuelle du Microsoft Game Development Kit

Au lieu de télécharger le Microsoft Game Development Kit (GDK) extrait, vous pouvez extraire manuellement les fichiers du programme d’installation habituel du Microsoft Game Development Kit (GDK). Après avoir téléchargé le Microsoft Game Development Kit (GDK) habituel, vous pouvez utiliser Windows Installer (msiexec.exe) pour extraire chaque package d’installation afin d’accéder à ses fichiers individuels.
Les procédures suivantes illustrent une utilisation précise de Windows Installer (msiexec.exe). Pour plus d’informations sur msiexec.exe, consultez Windows Installer.

Extraction du contenu de tous les MSI du Microsoft Game Development Kit (GDK) (à l’aide d’ExtractXboxOneDKs.ps1)

  1. Téléchargez le programme d’installation du Microsoft Game Development Kit sur le site Téléchargements pour développeurs XBOX. Vous pouvez aussi télécharger le programme d’installation public du Microsoft Game Development Kit (GDK) à partir du dépôt GitHub (prend en charge le développement PC seulement). Le fichier que vous téléchargez aura un nom comme GDK_03_2022.zip. Notez son emplacement sur votre ordinateur.
  2. Extrayez le contenu du fichier .zip local.
  3. Ouvrez une invite PowerShell et accédez au répertoire SetupScripts dans le dossier où le contenu a été extrait (par exemple, C:\GDKDownload\SetupScripts)
    • Le script ExtractXboxOneDKs.ps1 de ce répertoire peut être utilisé pour extraire le GDK. Son utilisation est la suivante :
      • .\ExtractXboxOneDKs.ps1 -SourcePath <MSI_Source_Folder> -TargetDirectory <Target_Directory>
      • Par exemple, SourcePath est l’emplacement où le fichier .zip a été extrait (par exemple, C:\GDKDownload). TargetDirectory est l’emplacement où le contenu extrait sera placé (par exemple, C:\ExtractedGDK\220300)
  4. Après l’exécution du script ExtractXboxOneDKs.ps1, les fichiers extraits se trouveront dans le répertoire cible (par exemple, C:\ExtractedGDK\220300)
  5. Accédez au répertoire cible, puis copiez les fichiers extraits du GDK à l’emplacement requis par votre système de génération.
Le répertoire cible comprend un ensemble de fichiers .msi et un dossier Windows Kits dans le cadre de l’extraction. Ceux-ci doivent être ignorés et peuvent être supprimés. Le dossier Microsoft GDK est le seul dossier du répertoire cible de l’extraction qu’il est nécessaire de conserver.

Extraction du contenu de tous les MSI du Microsoft Game Development Kit (GDK) (manuelle)

  1. Après avoir décompressé le GDK (étapes 1 et 2 de la section précédente), vous pouvez utiliser Windows Installer (msiexec.exe) pour extraire chaque package d’installation afin d’accéder à ses fichiers individuels.
  2. Dans une fenêtre d’invite de commandes, accédez au dossier contenant les fichiers extraits du fichier .zip, puis exécutez la ligne de commande suivante :
    où installation_folder est le chemin d’accès aux fichiers téléchargés du GDK, et msi_extraction_path indique le dossier dans lequel vous voulez extraire les fichiers Windows Installer (.msi). Par exemple :
    Si cet exemple de code est utilisé dans un script plutôt que directement à partir de la ligne de commande, %G doit être remplacé par %%G.
  3. Accédez à msi_extraction_path, puis copiez les fichiers extraits du GDK à l’emplacement requis par votre système de génération.

Extraction du SDK Windows

L’extraction manuelle de la charge utile d’installation du SDK Windows, une option offerte aux utilisateurs avancés, permet d’intégrer des fichiers précis dans un système de génération sans installer le SDK Windows complet. Cette étape n’est pas requise pour utiliser un Microsoft Game Development Kit (GDK) extrait, tant que le SDK Windows est installé sur le système.

Extraction du contenu de tous les MSI du SDK Windows (à l’aide d’ExtractXboxOneDKs.ps1)

Depuis le GDK d’octobre 2023, le GDK nécessite le SDK Windows 11 (version 10.0.22000.0) ou une version ultérieure.
  1. Téléchargez le programme d’installation du SDK Windows à partir du Centre de développement Windows. Le fichier que vous téléchargez aura un nom comme winsdksetup.exe. Notez son emplacement sur votre ordinateur.
  2. Ouvrez une invite de commandes et exécutez winsdksetup.exe /layout C:\WinSDKDownload dans le répertoire où le fichier .exe a été téléchargé (cela extraira les fichiers .msi du fichier .exe).
  3. Parcourez l’interface utilisateur, laissez toutes les cases cochées et laissez-la télécharger tous les fichiers.
  4. Accédez à C:\WinSDKDownload pour confirmer la présence des fichiers .msi.
    Vous pouvez aussi télécharger le fichier .ISO du SDK Windows et le monter. Il contient les mêmes fichiers .msi que ceux produits par les étapes 1 à 4.
  5. À l’aide du script mentionné dans la section Extraction du contenu de tous les MSI du Microsoft Game Development Kit (GDK) (à l’aide d’ExtractXboxOneDKs.ps1) ci-dessus, pointez vers le dossier msi (par exemple, C:\WinSDKDownload) pour SourcePath et vers un autre dossier (par exemple, C:\ExtractedWinSDK) pour TargetDirectory, où le contenu extrait sera placé.
    En raison de la longueur des chemins des fichiers inclus, il est recommandé de limiter les répertoires source et cible (pour l’extraction seulement) à 45 caractères (lettre de lecteur comprise). Ils peuvent ensuite être déplacés une fois l’extraction terminée. Un chemin de dossier de plus de 45 caractères entraînera des échecs d’extraction en raison du dépassement de la longueur maximale du chemin de fichier.
  6. Après l’exécution du script ExtractXboxOneDKs.ps1, les fichiers extraits se trouveront dans le répertoire cible (par exemple, C:\ExtractedWinSDK)
  7. Accédez au répertoire cible, puis copiez les fichiers extraits du SDK Windows à l’emplacement requis par votre système de génération.
    De nombreux fichiers et dossiers se trouveront dans le répertoire cible après cette extraction. Le dossier Windows Kits\10 est le dossier utilisé dans cet exemple comme référence pour le système de génération. D’autres dossiers peuvent être requis selon l’action souhaitée.

Extraction du contenu de tous les MSI du SDK Windows (manuelle)

  1. Après avoir obtenu un ensemble de fichiers .msi à partir de winsdksetup.exe (étapes 1 à 4 de la section précédente), vous pouvez utiliser Windows Installer (msiexec.exe) pour extraire chaque package d’installation afin d’accéder à ses fichiers individuels.
  2. Dans une fenêtre d’invite de commandes, accédez au dossier contenant les fichiers extraits du fichier .zip, puis exécutez la ligne de commande suivante :
    où installation_folder est le chemin d’accès aux fichiers téléchargés du SDK Windows, et msi_extraction_path indique le dossier dans lequel vous voulez extraire les fichiers Windows Installer (.msi). Par exemple :
    Si cet exemple de code est utilisé dans un script plutôt que directement à partir de la ligne de commande, %G doit être remplacé par %%G.
  3. Accédez à msi_extraction_path, puis copiez les fichiers extraits du SDK Windows à l’emplacement requis par votre système de génération.
Lors de l’extraction du Microsoft Game Development Kit, on suppose que ce dossier résidera dans un emplacement partagé ou dans un système de contrôle de code source afin d’être accessible lors de la génération de votre titre. Il peut arriver que plusieurs versions du Microsoft Game Development Kit (GDK) soient souhaitées. Dans ce scénario, nous recommandons la disposition suivante pour plusieurs versions extraites du Microsoft Game Development Kit (GDK) :
  • …\ExtractedGDK\211000\Microsoft GDK…
  • …\ExtractedGDK\220300\Microsoft GDK…
Cela permet que la charge utile complète soit présente pour chaque version. Nous vous recommandons d’utiliser une variable d’environnement de génération pour passer d’une version à l’autre afin de définir ce qui est utilisé pendant votre processus de compilation.

Voir aussi

Configuration de l’environnement de génération sans installer le Microsoft Game Development Kit (GDK) Utilisation du Microsoft Game Development Kit (GDK) sans installation
Dernière modification le 6 novembre 2026