Ce processus ne remplace pas la nécessité d’installer le Microsoft Game Development Kit (GDK) dans la plupart des scénarios. Il permet les scénarios suivants :
- Extraire les en-têtes et les bibliothèques à utiliser dans votre processus de génération.
- 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 l’intégralité de ce Microsoft Game Development Kit (GDK).
Téléchargement du Microsoft Game Development Kit extrait
Le Microsoft Game Development Kit (GDK) extrait, une option destinée aux utilisateurs avancés, permet d’intégrer des fichiers spécifiques dans un système de build sans installer l’intégralité du Microsoft Game Development Kit (GDK). Le Microsoft Game Development Kit (GDK) extrait est disponible en tant qu’option de téléchargement distincte sur le site XBOX Developer Downloads. 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.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 standard du Microsoft Game Development Kit (GDK). Après avoir téléchargé le Microsoft Game Development Kit (GDK) standard, vous pouvez utiliser Windows Installer (msiexec.exe) pour extraire chaque package d’installation et accéder à ses fichiers individuels.Extraction du contenu de tous les MSI du Microsoft Game Development Kit (GDK) (à l’aide d’ExtractXboxOneDKs.ps1)
- Téléchargez le programme d’installation du Microsoft Game Development Kit sur le site XBOX Developer Downloads. Vous pouvez également 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 uniquement). Le fichier téléchargé porte un nom tel que GDK_03_2022.zip. Notez son emplacement sur votre ordinateur.
- Extrayez le contenu du fichier .zip local.
- 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 correspond à l’emplacement où le fichier .zip a été extrait (par exemple, C:\GDKDownload). TargetDirectory correspond à l’emplacement où le contenu extrait sera placé (par exemple, C:\ExtractedGDK\220300)
- Le script ExtractXboxOneDKs.ps1 de ce répertoire peut être utilisé pour extraire le GDK. Son utilisation est la suivante :
- Après l’exécution du script ExtractXboxOneDKs.ps1, les fichiers extraits se trouvent dans le répertoire cible (par exemple, C:\ExtractedGDK\220300)
- Accédez au répertoire cible, puis copiez les fichiers GDK extraits vers l’emplacement requis par votre système de build.
Le répertoire cible contient un ensemble de fichiers .msi et un dossier Windows Kits issus 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)
- Après avoir décompressé le GDK (étapes 1-2 de la section précédente), vous pouvez utiliser Windows Installer (msiexec.exe) pour extraire chaque package d’installation et accéder à ses fichiers individuels.
-
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 spécifie le dossier dans lequel vous souhaitez extraire les fichiers Windows Installer (.msi). Par exemple :
Si cet exemple de code est utilisé dans un script plutôt que directement depuis la ligne de commande, %G doit être remplacé par %%G. - Accédez à msi_extraction_path, puis copiez les fichiers GDK extraits vers l’emplacement requis par votre système de build.
Extraction du Kit de développement logiciel (SDK) Windows
L’extraction manuelle de la charge utile d’installation du Kit de développement logiciel (SDK) Windows, une option destinée aux utilisateurs avancés, permet d’intégrer des fichiers spécifiques dans un système de build sans installer l’intégralité du Kit de développement logiciel (SDK) Windows. Cette étape n’est pas nécessaire pour utiliser un Microsoft Game Development Kit (GDK) extrait, tant que le Kit de développement logiciel (SDK) Windows est installé sur le système.Extraction du contenu de tous les MSI du Kit de développement logiciel (SDK) Windows (à l’aide d’ExtractXboxOneDKs.ps1)
Depuis le GDK d’octobre 2023, le GDK nécessite le Kit de développement logiciel (SDK) Windows 11 (version 10.0.22000.0) ou une version ultérieure.
- Téléchargez le programme d’installation du Kit de développement logiciel (SDK) Windows depuis le Centre de développement Windows. Le fichier téléchargé porte un nom tel que winsdksetup.exe. Notez son emplacement sur votre ordinateur.
- Ouvrez une invite de commandes et exécutez winsdksetup.exe /layout C:\WinSDKDownload dans le répertoire où l’exe a été téléchargé (cela extrait les fichiers msi de l’exe).
- Parcourez l’interface utilisateur, laissez toutes les cases cochées et laissez-la télécharger tous les fichiers.
- Accédez à C:\WinSDKDownload pour vérifier que les fichiers .msi sont présents.
-
À 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, indiquez le dossier msi (par exemple, C:\WinSDKDownload) pour SourcePath et 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 uniquement) à 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.
- Après l’exécution du script ExtractXboxOneDKs.ps1, les fichiers extraits se trouvent dans le répertoire cible (par exemple, C:\ExtractedWinSDK)
-
Accédez au répertoire cible, puis copiez les fichiers extraits du Kit de développement logiciel (SDK) Windows vers l’emplacement requis par votre système de build.
De nombreux fichiers et dossiers se trouvent dans le répertoire cible après cette extraction. Le dossier Windows Kits\10 est celui utilisé dans cet exemple comme référence pour le système de build. D’autres dossiers peuvent être nécessaires selon l’action souhaitée.
Extraction du contenu de tous les MSI du Kit de développement logiciel (SDK) Windows (manuelle)
- 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 et accéder à ses fichiers individuels.
-
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 Kit de développement logiciel (SDK) Windows, et msi_extraction_path spécifie le dossier dans lequel vous souhaitez extraire les fichiers Windows Installer (.msi). Par exemple :
Si cet exemple de code est utilisé dans un script plutôt que directement depuis la ligne de commande, %G doit être remplacé par %%G. - Accédez à msi_extraction_path, puis copiez les fichiers extraits du Kit de développement logiciel (SDK) Windows vers l’emplacement requis par votre système de build.
Structure recommandée pour prendre en charge plusieurs versions extraites du Microsoft Game Development Kit (GDK)
Lors de l’extraction du Microsoft Game Development Kit, on suppose que ce dossier sera placé 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 structure suivante pour plusieurs versions extraites du Microsoft Game Development Kit (GDK) :- …\ExtractedGDK\211000\Microsoft GDK…
- …\ExtractedGDK\220300\Microsoft GDK…
