Passer au contenu principal

​
Configuration de projets sans installer le Microsoft Game Development Kit

Cette rubrique traite de la configuration de projets pour les générer avec MSBuild tout en référençant des fichiers extraits du Microsoft Game Development Kit (GDK). Pour télécharger des exemples de projets qui utilisent MSBuild et CMake, consultez la section Exemples de configuration de projet.

​
Fichiers de propriétés et de cibles de plateforme

Les fichiers extraits du GDK comprennent un ensemble de fichiers de propriétés et de cibles utilisés lors de la génération pour les plateformes Gaming.Xbox.XboxOne.x64, Gaming.Xbox.Scarlett.x64 ou Gaming.Desktop.x64. Ces plateformes sont importées à partir de la recherche Microsoft.Cpp.Default.props lors de la génération avec notre plateforme définie. L’examen de ces fichiers vous aidera à mieux comprendre le fonctionnement des composants MSBuild de la plateforme et la meilleure façon de les intégrer à votre système de génération. Seize instances de ces fichiers existent, selon la version de Visual Studio, la version de l’ensemble d’outils de plateforme et la plateforme cible. Voici des exemples de chemins à partir d’un dossier GDK extrait.
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\Gaming.Xbox.XboxOne.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\Gaming.Xbox.Scarlett.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\Gaming.Xbox.XboxOne.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\Gaming.Xbox.Scarlett.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v170\Platforms\Gaming.Xbox.XboxOne.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GXDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v170\Platforms\Gaming.Xbox.Scarlett.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\gaming.desktop.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms\gaming.desktop.x64
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v170\Platforms\gaming.desktop.x64
La différence entre les dossiers v160 et v170 pour Visual Studio 2019 et Visual Studio 2022 réside dans l’utilisation de la version v142 (v160) ou v143 (v170) de l’ensemble d’outils de plateforme (définie dans la propriété $(PlatformToolset)).
Pour la nouvelle disposition du GDK, ces fichiers se trouvent dans C:\ExtractedGDK\251000\Microsoft GDK\251000\xbox\build avec des chemins raccourcis. Les chemins INCLUDE/LIB indiqués ci-dessous supposent également que vous utilisez les anciennes dispositions plutôt que la nouvelle intégration simplifiée.
Retour au début de cette rubrique.

​
Remplacement des propriétés MSBuild

Il existe plusieurs façons de remplacer les propriétés MSBuild dans vos projets. Une méthode pratique consiste à créer un fichier Directory.Build.props dans le même répertoire que le fichier de projet. Les propriétés définies dans ce fichier sont automatiquement appliquées lors de la génération du projet. Si le fichier n’est pas présent, les remplacements ne sont pas appliqués. Vous pouvez donc utiliser le même fichier de projet, que le Microsoft Game Development Kit (GDK) soit installé ou non. Si le Microsoft Game Development Kit (GDK) est installé, supprimez ou renommez le fichier Directory.Build.props pour utiliser le processus de génération normal. L’exemple MSBuild illustre l’utilisation d’un fichier Directory.Build.props. Les sections suivantes décrivent les propriétés que nous vous recommandons de remplacer pour pointer vers votre Microsoft Game Development Kit (GDK) extrait, et où trouver plus de détails sur les chemins de bibliothèques et d’inclusions. Retour au début de cette rubrique.

​
Personnalisation de projets Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64

Une personnalisation du projet est requise pour générer un projet Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64 avec MSBuild à partir d’un GDK extrait. Pour les propriétés à remplacer, la différence la plus importante entre Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64 est la définition de la propriété Platform.

​
Remplacements de propriétés Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64 pour le GDK

Les propriétés suivantes doivent être définies pour permettre la génération réussie d’un projet configuré pour les plateformes Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64. Elles doivent être importées avant l’importation de Microsoft.Cpp.Default.props définie dans votre fichier de projet.

​
Descriptions des propriétés remplacées

  • BWOI_GDK_Path: Propriété utilisateur facultative, mais nous vous recommandons de la définir afin de l’utiliser dans les valeurs de propriétés ultérieures pour réduire les chemins codés en dur.
  • Platform : Spécifie la plateforme qui sera utilisée pour compiler le projet. Les options de la famille de consoles XBOX dans le GDK sont Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64. La propriété est définie dans le cadre du nouveau modèle de projet.
  • XdkEditionTarget : Remplace la version du GDK utilisée pour la compilation. Elle est définie dans Platform.default.props et est dérivée de XdkEdition, une propriété interne définie dans xdk.props.
  • DurangoXdkInstallPath : Remplace l’emplacement du dossier Microsoft Game Development Kit (GDK) du GDK extrait. Elle est définie dans Platform.Edition.default.props.
  • DefaultXdkEditionRootVS2019 : Remplace l’emplacement par défaut des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2019. Elle est définie dans Platform.default.props. Cette propriété ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2019.
  • XdkEditionRootVS2019 : Remplace l’emplacement des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2019. Elle est définie dans Platform.props. Cette propriété ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2019.
  • DefaultXdkEditionRootVS2022 : Remplace l’emplacement par défaut des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2022. Elle est définie dans Platform.default.props. Cette propriété ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2022.
  • XdkEditionRootVS2022 : Remplace l’emplacement des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2022. Elle est définie dans Platform.props. Cette propriété ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2022.
  • PlatformToolset : Remplace la version précise des outils de génération à utiliser. v142 est pris en charge dans Visual Studio 2019. v142 et v143 sont pris en charge dans Visual Studio 2022 (v143 est défini par défaut). Elle est définie dans Microsoft.Cpp.Defaults.props.
Exemples de valeurs de propriétés Gaming.Xbox.Scarlett.x64, basés sur l’exemple de dossier extrait précédent, à titre de référence :
Pour remplacer le dossier Platform afin de détecter les fichiers .props et de cibles propres à Gaming.Xbox.XboxOne.x64 et à Gaming.Xbox.Scarlett.x64, consultez la section suivante sur les remplacements de plateforme Visual Studio. Retour au début de cette rubrique.

​
Remplacements de propriétés Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64 pour le SDK Windows 10

Les propriétés suivantes doivent être définies uniquement lorsque vous utilisez un SDK Windows 10 extrait. Si vous utilisez un SDK Windows 10 installé, vous pouvez ignorer cette section.
  • BWOI_Win10SDK_Path : Propriété utilisateur facultative, mais nous vous recommandons de la définir afin de l’utiliser dans les valeurs de propriétés ultérieures pour réduire les chemins codés en dur.
  • WindowsSdkDir : Remplace l’emplacement du SDK Windows 10.
  • WindowsSdkDir_10: Remplace l’emplacement du SDK Windows 10 (Windows 10). Elle est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • UCRTContentRoot : Remplace l’emplacement de la racine de contenu de la bibliothèque Universal C Runtime. Elle est définie dans uCRT.props.
  • UniversalCRTSdkDir : Remplace l’emplacement du SDK de la bibliothèque Universal C Runtime (Visual C++ C Runtime). Cette propriété est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • UniversalCRTSdkDir_10 : Remplace l’emplacement du SDK de la bibliothèque Universal C Runtime (Visual C++ C Runtime pour Windows 10). Cette propriété est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • WindowsSDK_ExecutablePath_x86 : Remplace l’emplacement des outils x86 inclus dans le SDK Windows 10. Des outils comme rc.exe se trouvent à cet emplacement. Cette propriété est définie dans Microsoft.Cpp.WindowsSDK.props.
  • WindowsSDK_ExecutablePath_x64 : Remplace l’emplacement des outils x64 inclus dans le SDK Windows 10. Des outils comme rc.exe se trouvent à cet emplacement. Cette propriété est définie dans Microsoft.Cpp.WindowsSDK.props.
  • WindowsTargetPlatformVersion : Remplace la version du SDK Windows 10 utilisée. Cette propriété est définie dans le fichier Platform.Edition.default.props (parcourt un chemin local si elle n’est pas définie).
  • TargetPlatformVersion : Remplace la version du SDK Windows 10 utilisée. Cette propriété est définie dans Microsoft.Cpp.WindowsSDK.props.
Exemples de valeurs de propriétés, basés sur l’exemple de dossier extrait précédent, à titre de référence :
Le Microsoft GDK nécessite le SDK Windows 10 (19041) ou une version ultérieure. Vous pouvez utiliser le SDK Windows (20348, 22000 ou 22621) si vous le souhaitez, mais ce n’est pas obligatoire.
Depuis la version d’octobre 2023, le SDK Windows 11 (22000) ou une version ultérieure est requis. Vous pouvez utiliser le SDK Windows 11, version 22H2 (22621) si vous le souhaitez, mais ce n’est pas obligatoire. Remplacez toutes les occurrences de “10.0.19041.0” par “10.0.22000.0”.
Retour au début de cette rubrique.

​
Références de bibliothèques et d’inclusions Gaming.Xbox.XboxOne.x64

Les références de bibliothèques et d’inclusions n’ont pas besoin d’être remplacées directement, car elles découlent des chemins remplacés mentionnés précédemment. Cette section est fournie à titre de référence seulement. Ces références sont définies dans Platform.Edition.props dans le dossier Platform de Gaming.Xbox.XboxOne.x64. Les propriétés sont construites comme suit.
Exemples de définitions de propriétés de bibliothèques et d’inclusions dans les journaux MSBuild :
Retour au début de cette rubrique.

​
Références de bibliothèques et d’inclusions Gaming.Xbox.Scarlett.x64

Les références de bibliothèques et d’inclusions n’ont pas besoin d’être remplacées directement, car elles découlent des chemins remplacés mentionnés précédemment. Cette section est fournie à titre de référence seulement. Ces références sont définies dans Platform.Edition.props dans le dossier Platform de Gaming.Xbox.Scarlett.x64. Les propriétés sont construites comme suit.
Exemples de définitions de propriétés de bibliothèques et d’inclusions dans les journaux MSBuild :
Retour au début de cette rubrique.

​
Bibliothèques d’extension Gaming.Xbox.XboxOne.x64 et Gaming.Xbox.Scarlett.x64

Des bibliothèques d’extension existent pour Xbox.Services.API.C, Xbox.Game.Chat.2.Cpp.API, Xbox.XCurl.API, Xbox.LibHttpClient, PlayFab.Party.Cpp et PlayFab.PartyXboxLive.Cpp. Si vous utilisez ces fonctionnalités, elles doivent être importées dans votre projet et les propriétés associées doivent être remplacées, en fonction de ce qui est défini dans les fichiers .props suivants. Microsoft GDK (octobre 2024) ou version ultérieure :
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Game.Chat.2.Cpp.API\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\PlayFab.PartyXboxLive.Cpp\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\220600\GRDK\ExtensionLibraries\PlayFab.Services.C\ExtensionLibrary.props
Microsoft GDK (juin 2024) ou version antérieure :
  • C:\ExtractedGDK\241000\Microsoft GDK\230600\GRDK\ExtensionLibraries\Xbox.Services.API.C\DesignTime\CommonConfiguration\Neutral\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\230600\GRDK\ExtensionLibraries\Xbox.Game.Chat.2.Cpp.API\DesignTime\CommonConfiguration\neutral\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\230600\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\DesignTime\CommonConfiguration\neutral\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\230600\GRDK\ExtensionLibraries\PlayFab.PartyXboxLive.Cpp\DesignTime\CommonConfiguration\neutral\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\230600\GRDK\ExtensionLibraries\PlayFab.Services.C\DesignTime\CommonConfiguration\neutral\ExtensionLibrary.props
Remarque : Le fichier .props de Xbox.Services.API.C a ajouté Appnotify.lib, crypt32.lib et winhttp.lib comme dépendances supplémentaires.
Les propriétés des bibliothèques d’extension sont définies dans Platform.Edition.props dans le dossier de la plateforme cible. Voici un exemple de construction de ces propriétés.
GDKExtLibNames permet de définir jusqu’à cinq bibliothèques. Si la propriété n’est pas définie, sa valeur par défaut est Xbox.Services.API.C. Retour au début de cette rubrique.

​
Personnalisation de projets Gaming.Desktop.x64

Une personnalisation du projet est requise pour générer un projet Gaming.Desktop.x64 avec MSBuild à partir d’un Microsoft Game Development Kit (GDK) extrait.
Les différences principales entre les remplacements de propriétés Gaming.Desktop.x64, Gaming.Xbox.Scarlett.x64 et Gaming.Xbox.XboxOne.x64 sont minimes. Le point le plus important à noter est que les fichiers Gaming.Desktop.x64 se trouvent dans le chemin GRDK. Les fichiers Gaming.Xbox.Scarlett.x64 et Gaming.Xbox.XboxOne.x64 se trouvent dans le chemin GXDK (à l’exception des bibliothèques d’extension).

​
Remplacements de propriétés Gaming.Desktop.x64 pour le GDK

Les propriétés suivantes doivent être définies pour permettre la génération réussie d’un projet configuré pour la plateforme Gaming.Desktop.x64. Ces propriétés doivent être importées avant que vous importiez Microsoft.Cpp.Default.props, comme défini dans votre fichier de projet.

​
Descriptions des propriétés remplacées

  • BWOI_GDK_Path : Propriété utilisateur facultative, mais nous vous recommandons de la définir afin de l’utiliser dans les valeurs de propriétés ultérieures pour réduire les chemins codés en dur.
  • Platform : Spécifie la plateforme qui sera utilisée pour compiler le projet. La plateforme dans le Microsoft Game Development Kit (GDK) est Gaming.Desktop.x64.
  • XdkEditionTarget : Remplace la version du GDK utilisée pour la compilation. Cette propriété est définie dans Platform.default.props et est dérivée de XdkEdition, une propriété interne définie dans xdk.props.
  • DurangoXdkInstallPath : Remplace l’emplacement du dossier Microsoft Game Development Kit (GDK) du GDK extrait. Elle est définie dans Platform.Edition.default.props.
  • DefaultXdkEditionRootVS2019 : Remplace l’emplacement par défaut des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2019. Elle est définie dans Platform.default.props. DefaultXdkEditionRootVS2019 ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2019.
  • XdkEditionRootVS2019 : Remplace l’emplacement des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2019. Elle est définie dans Platform.default.props. XdkEditionRootVS2019 ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2019.
  • DefaultXdkEditionRootVS2022 : Remplace l’emplacement par défaut des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2022. Elle est définie dans Platform.default.props. DefaultXdkEditionRootVS2022 ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2022.
  • XdkEditionRootVS2022 : Remplace l’emplacement des fichiers de propriétés et de cibles Platform compatibles avec Visual Studio 2022. Elle est définie dans Platform.default.props. XdkEditionRootVS2022 ne doit être définie que lorsque vous utilisez un projet avec Visual Studio 2022.
  • PlatformToolset : Remplace la version précise des outils de génération à utiliser. v142 est pris en charge dans Visual Studio 2019. v142 et v143 sont pris en charge dans Visual Studio 2022 (v143 est défini par défaut). Elle est définie dans Microsoft.Cpp.Defaults.props.
Exemples de valeurs de propriétés Gaming.Desktop.x64, basés sur l’exemple de dossier extrait précédent, à titre de référence :
Pour remplacer le dossier Platform afin de détecter les fichiers .props et de cibles propres à Gaming.Desktop.x64, consultez la section suivante sur les remplacements de plateforme Visual Studio. Retour au début de cette rubrique.

​
Remplacements de propriétés Gaming.Desktop.x64 pour le SDK Windows 10

Les propriétés suivantes doivent être définies uniquement lorsque vous utilisez un SDK Windows 10 extrait. Si vous utilisez un SDK Windows 10 installé, vous pouvez ignorer cette section.
  • BWOI_Win10SDK_Path : Propriété utilisateur facultative, mais nous vous recommandons de la définir afin de l’utiliser dans les valeurs de propriétés ultérieures pour réduire les chemins codés en dur.
  • WindowsSdkDir : Remplace l’emplacement du SDK Windows 10.
  • WindowsSdkDir_10 : Remplace l’emplacement du SDK Windows 10 (Windows 10). Cette propriété est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • UCRTContentRoot : Remplace l’emplacement de la racine de contenu Universal CRT. Cette propriété est définie dans uCRT.props.
  • UniversalCRTSdkDir : Remplace l’emplacement du SDK Universal CRT (Visual C++ C Runtime). Elle est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • UniversalCRTSdkDir_10 : Remplace l’emplacement du SDK Universal CRT (Visual C++ C Runtime pour Windows 10). Elle est vérifiée au moyen d’une clé de registre dans Microsoft.Cpp.WindowsSDK.props, qui est importé lors de la compilation.
  • WindowsSDK_ExecutablePath_x86 : Remplace l’emplacement des outils x86 inclus dans le SDK Windows 10. Des outils comme rc.exe se trouvent à cet emplacement. Elle est définie dans Microsoft.Cpp.WindowsSDK.props.
  • WindowsSDK_ExecutablePath_x64 : Remplace l’emplacement des outils x64 inclus dans le SDK Windows 10. Des outils comme rc.exe se trouvent à cet emplacement. Elle est définie dans Microsoft.Cpp.WindowsSDK.props.
  • WindowsTargetPlatformVersion : Remplace la version du SDK Windows 10 utilisée. Elle est définie dans le dossier Platform.Edition.default.props (parcourt un chemin local si elle n’est pas définie).
  • TargetPlatformVersion : Remplace la version du SDK Windows 10 utilisée. Elle est définie dans Microsoft.Cpp.WindowsSDK.props.
Exemples de valeurs de propriétés, basés sur l’exemple de dossier extrait précédent, à titre de référence :
Le Microsoft GDK nécessite le SDK Windows 10 (19041) ou une version ultérieure. Vous pouvez utiliser le SDK Windows 10 (20348) si vous le souhaitez, mais ce n’est pas obligatoire.
Retour au début de cette rubrique.

​
Références de bibliothèques et d’inclusions Gaming.Desktop.x64

Les références de bibliothèques et d’inclusions n’ont pas besoin d’être remplacées directement, car elles découlent des chemins remplacés mentionnés précédemment. Cette section est fournie à titre de référence seulement. Ces références sont définies dans Platform.Edition.props dans le dossier Platform de Gaming.Desktop.x64. Les propriétés sont construites comme suit.
Exemples de définitions de propriétés de bibliothèques et d’inclusions dans les journaux MSBuild :
Retour au début de cette rubrique.

​
Bibliothèques d’extension Gaming.Desktop.x64

Des bibliothèques d’extension existent pour Xbox.Services.API.C, Xbox.Game.Chat.2.Cpp.API, Xbox.XCurl.API, PlayFab.Party.Cpp et PlayFab.PartyXboxLive.Cpp. Si vous utilisez ces fonctionnalités, elles doivent être importées dans votre projet et les propriétés appropriées doivent être remplacées, en fonction de ce qui est défini dans les fichiers .props suivants.
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Services.API.C\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\Xbox.Game.Chat.2.Cpp.API\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\ExtensionLibrary.props
  • C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\ExtensionLibraries\PlayFab.PartyXboxLive.Cpp\ExtensionLibrary.props
Remarque : Le fichier .props de Xbox.Services.API.C a ajouté Appnotify.lib comme dépendance supplémentaire, et vous devrez importer cette bibliothèque dans votre projet.
Les propriétés des bibliothèques d’extension sont définies dans Platform.Edition.props dans le dossier de la plateforme cible. Voici un exemple de construction de ces propriétés.
GDKExtLibNames permet de définir jusqu’à cinq bibliothèques. Si elle n’est pas définie, sa valeur par défaut est Xbox.Services.API.C. Retour au début de cette rubrique.

​
Remplacements de propriétés pour les outils côté PC

Lorsque vous utilisez le Microsoft Game Development Kit (GDK) sous forme de déploiement à plat extrait, nous vous recommandons de définir ces propriétés si vous utilisez également des outils côté PC.

​
Remplacements propres à chaque version de Visual Studio

Cette section décrit les propriétés de Visual Studio propres à chaque version qui doivent être remplacées pour fonctionner correctement avec la génération sans installation.

​
Remplacements de plateforme pour Visual Studio 2019

À partir de Visual Studio 2019, la propriété _PlatformFolder est dépréciée. La prise en charge d’une configuration de projet sans installation nécessite des étapes supplémentaires dans Visual Studio 2019. Pour ce faire, copiez les fichiers requis d’une version installée de Visual Studio 2019 vers le chemin de votre GDK extrait. Par exemple :
  • Pour l’ensemble d’outils de plateforme v142 : C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Microsoft\VC\v160
Ces fichiers doivent être copiés de façon à correspondre à la structure de dossiers des chemins suivants.
  • Pour l’ensemble d’outils de plateforme v142 : C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2019\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms
L’exemple précédent consiste à copier les fichiers directement dans votre dossier ExtractedGDK. Si vous préférez garder séparés le GDK extrait et les fichiers VC Targets de Visual Studio à des fins de référence ou de maintenabilité, vous pouvez copier à la fois ExtractedGDK et VC Targets dans un nouveau chemin de dossier combiné, comme mentionné précédemment, pour qu’ils soient référencés par votre système de génération.En voici un exemple.
  • Copiez tous les fichiers de la racine C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\MSBuild\Microsoft\VC\v160 (*.*) vers un chemin similaire dans le dossier C:\ExtractedGDK\241000_CombinedGDK\.
  • Copiez tous les fichiers de C:\ExtractedGDK\241000\Microsoft GDK vers un chemin similaire dans le dossier C:\ExtractedGDK\241000_CombinedGDK\.
  • Modifiez les références/chemins/propriétés pour qu’ils pointent vers les chemins équivalents de C:\ExtractedGDK\241000_CombinedGDK\.
Une fois cette opération terminée, les propriétés suivantes doivent être remplacées lors du lancement de la génération dans Visual Studio 2019 afin de trouver correctement les propriétés Platform et l’emplacement des fichiers de cibles.
  • Définissez DisableInstalledVCTargetsUse sur true
  • VCTargetsPath16 : Remplace le chemin Visual Studio servant à déterminer l’emplacement des fichiers de propriétés et de cibles des outils de génération de Visual Studio 2019 (v160).
Comme la propriété de chemin VC Targets fait partie de la définition de la propriété XdkEditionRootVS2019, vous pouvez choisir de ne pas définir XdkEditionRootVS2019 dans ce cas.
Exemple de valeur de propriété, basé sur l’exemple de dossier extrait précédent, à titre de référence :
Si vous souhaitez garder séparés ExtractedGDK et VC Targets à des fins de référence ou de maintenabilité, vous pouvez spécifier les propriétés VCTargetsPath comme suit (où $(CombinedGDK) est le nouvel emplacement que vous avez créé).
  • Définissez VCTargetsPath16 sur $(CombinedGDK)\v160\

​
Propriété de Visual Studio 2019 (16.5) pour respecter les remplacements du SDK Windows 10

Lorsque vous utilisez Visual Studio 2019 version 16.5 ou ultérieure, une autre propriété doit être définie pour garantir que les remplacements de propriétés du SDK Windows 10 sont correctement respectés, comme suit.
Retour au début de cette rubrique.

​
Remplacements de plateforme pour Visual Studio 2022

À partir de Visual Studio 2019, la propriété _PlatformFolder est dépréciée. La prise en charge d’une configuration de projet sans installation nécessite des étapes supplémentaires dans Visual Studio 2022. Pour ce faire, copiez les fichiers requis d’une version installée de Visual Studio 2022 vers le chemin de votre GDK extrait. Par exemple :
  • Pour l’ensemble d’outils de plateforme v142 : C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Microsoft\VC\v160
  • Pour l’ensemble d’outils de plateforme v143 : C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Microsoft\VC\v170
Ces fichiers doivent être copiés de façon à correspondre à la structure de dossiers des chemins suivants.
  • Pour l’ensemble d’outils de plateforme v142 : C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v160\Platforms
  • Pour l’ensemble d’outils de plateforme v143 : C:\ExtractedGDK\241000\Microsoft GDK\241000\GRDK\VS2022\flatDeployment\MSBuild\Microsoft\VC\v170\Platforms
L’exemple précédent consiste à copier les fichiers directement dans votre dossier ExtractedGDK. Si vous préférez garder séparés le GDK extrait et les fichiers VC Targets de Visual Studio à des fins de référence ou de maintenabilité, vous pouvez copier à la fois ExtractedGDK et VC Targets dans un nouveau chemin de dossier combiné, comme mentionné précédemment, pour qu’ils soient référencés par votre système de génération.En voici un exemple.
  • Copiez tous les fichiers de la racine C:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Microsoft\VC\v170 (*.*) vers un chemin similaire dans le dossier C:\ExtractedGDK\241000_CombinedGDK\.
  • Copiez tous les fichiers de C:\ExtractedGDK\241000\Microsoft GDK vers un chemin similaire dans le dossier C:\ExtractedGDK\241000_CombinedGDK\.
  • Modifiez les références/chemins/propriétés pour qu’ils pointent vers les chemins équivalents de C:\ExtractedGDK\241000_CombinedGDK\.
Une fois cette opération terminée, les propriétés suivantes doivent être remplacées lors du lancement de la génération dans Visual Studio 2022 afin de trouver correctement les propriétés Platform et l’emplacement des fichiers de cibles.
  • Définissez DisableInstalledVCTargetsUse sur true
  • VCTargetsPath16 : Remplace le chemin Visual Studio servant à déterminer l’emplacement des fichiers de propriétés et de cibles des outils de génération de Visual Studio 2019 (v160).
  • VCTargetsPath17 : Remplace le chemin Visual Studio servant à déterminer l’emplacement des fichiers de propriétés et de cibles des outils de génération de Visual Studio 2022 (v170).
Comme la propriété de chemin VC Targets fait partie de la définition de la propriété XdkEditionRootVS2022, vous pouvez choisir de ne pas définir XdkEditionRootVS2022 dans ce cas.
Exemple de valeur de propriété, basé sur l’exemple de dossier extrait précédent, à titre de référence :
Si vous souhaitez garder séparés ExtractedGDK et VC Targets à des fins de référence ou de maintenabilité, vous pouvez spécifier les propriétés VCTargetsPath comme suit (où $(CombinedGDK) est le nouvel emplacement que vous avez créé).
  • Définissez VCTargetsPath16 sur $(CombinedGDK)\v160\
  • Définissez VCTargetsPath17 sur $(CombinedGDK)\v170\

​
Propriété de Visual Studio 2022 pour respecter les remplacements du SDK Windows 10

De plus, une autre propriété doit être définie pour garantir que les remplacements de propriétés du SDK Windows 10 sont correctement respectés, comme suit.
Retour au début de cette rubrique.

​
Exemples de configuration de projet

Cette section explique comment obtenir des exemples de code pour les scénarios sans installation.

​
Exemple CMake

L’exemple CMakeExample, y compris les instructions pour être rapidement opérationnel, peut être téléchargé à titre de référence à partir de la page Téléchargements pour développeurs XBOX. Sous « Select file type », choisissez « GDK », et sous « Select build/version number », choisissez le plus récent élément « Samples only ». Retour au début de cette rubrique.

​
Exemple MSBuild

L’exemple BWOIExample, y compris les instructions pour être rapidement opérationnel, peut être téléchargé à titre de référence à partir de la page Téléchargements pour développeurs XBOX. Sous « Select file type », choisissez « GDK », et sous « Select build/version number », choisissez le plus récent élément « Samples only ». Retour au début de cette rubrique.

​
Voir aussi

Configuration de l’environnement de génération sans installer le Microsoft Game Development Kit (GDK) Vue d’ensemble de la génération sans installer le Microsoft Game Development Kit
Dernière modification le 6 octobre 2026