> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Utiliser le GDK avec GameMaker > Préparez un jeu GameMaker Studio 2 pour la publication sur le Microsoft Store à l'aide de l'extension GMEXT-GDK, de Visual Studio 2022, de CMake et de la version de juin 2024 du GDK. Cet article explique comment préparer votre jeu GameMaker pour sa publication sur le Microsoft Store. * [Installer les logiciels requis](#install-the-required-software) * [Télécharger et installer GameMaker Studio 2](#download-and-install-gamemaker-studio-2) * [GameMaker Studio 2 - Extension Microsoft Game Development Kit (GDK)](#set-up-gamemaker-studio-2-gdk-extension) * [Générer l'extension GDK](#build-the-gdk-extension) * [Créer un produit dans Microsoft Partner Center](#create-a-product-in-microsoft-partner-center) * [Tester l'extension GDK](#test-the-gdk-extension) * [Mettre à jour MicrosoftGame.config](#update-microsoftgame-config) * [Intégrer l'extension GDK dans votre propre projet](#integrate-the-gdk-extension-into-your-project) * [Tester les services XBOX dans votre jeu](#test-xbox-services-in-your-game) * [Publier](#publish-your-game) ## Installer les logiciels requis Pour utiliser GameMaker Studio 2 avec le Microsoft Game Development Kit (GDK), téléchargez les logiciels suivants : * [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) * [GDK de juin 2024](https://github.com/microsoft/GDK/releases/tag/June_2024_Update_2) ou version ultérieure * [CMake](https://cmake.org/download/) * Assurez-vous que le programme d'installation de CMake met à jour les chemins système. Sinon, le projet d'extension ne peut pas trouver CMake. ## Mettre à jour Gaming Runtime Services (GRTS) et PC Bootstrapper PC Bootstrapper fait partie de l'expérience de lancement des jeux sur PC et a été introduit dans la version de mai 2022 de GRTS. PC Bootstrapper dépend de GRTS pour fonctionner correctement. Si GRTS n'est pas à jour sur votre PC de développement, les tentatives de connexion peuvent échouer et renvoyer une erreur `E_FAIL`. Pour obtenir des conseils détaillés sur PC Bootstrapper, notamment sur son rôle dans le processus de lancement du jeu et sur son interaction avec GRTS, consultez [Vue d'ensemble de PC Bootstrapper](/fr/build/gdk-and-engines/guides/pc-bootstrapper). ## Télécharger et installer GameMaker Studio 2 Si GameMaker Studio 2 n'est pas installé, téléchargez-le depuis [https://www.yoyogames.com](https://www.yoyogames.com/), puis installez-le. ## Configurer l'extension GDK de GameMaker Studio 2 L'extension GDK de GameMaker Studio 2 est nécessaire pour utiliser le GDK avec GameMaker Studio 2. Pour obtenir le code source de l'extension et les instructions de configuration, consultez [https://github.com/YoYoGames/GMEXT-GDK](https://github.com/YoYoGames/GMEXT-GDK). Suivez les étapes du fichier README situé à la racine du dépôt. Ces étapes vous permettent de configurer et de générer l'extension GDK de GameMaker Studio 2, ce qui permet d'intégrer les services et fonctionnalités XBOX dans les projets GameMaker. Lorsque vous clonez le dépôt GDKExtension, utilisez le commutateur `--recurse-submodules` pour inclure les sous-modules. Sinon, des fichiers requis seront manquants lors de la génération de la solution. Pour plus d'informations sur l'extension, consultez [https://github.com/YoYoGames/GMEXT-GDK/wiki](https://github.com/YoYoGames/GMEXT-GDK/wiki). ## Générer l'extension GDK Générez l'extension dans Visual Studio 2022 en suivant les instructions du fichier README situé à la racine du dépôt. Le fichier GDKExtension.sln est requis (\/source/GDKExtension\_gml/extensions/GDKExtension/gdkextension\_windows/GDKExtension.sln). Pour obtenir des instructions de génération détaillées, consultez les étapes de génération dans le fichier README situé à la racine du dépôt. ## Créer un produit dans Microsoft Partner Center Pour créer votre produit compatible avec les services XBOX dans Partner Center, consultez [Configuration d'une application ou d'un jeu dans Partner Center, pour les partenaires gérés](/fr/services/xbox-services/fundamentals/portal-config/live-setup-partner-center-partners). Après avoir créé votre produit, vous pouvez soit tester les services XBOX, soit publier un jeu sur le Microsoft Store. ## Tester l'extension GDK Le dépôt de l'extension GDK inclut un exemple de projet qui montre comment intégrer le plug-in GDK à un projet GameMaker Studio 2. Le fichier de l'exemple de projet se trouve dans `source/GDKExtension_gml/GDKExtension.yyp`. Lorsque vous générez l'exemple de projet dans GameMaker (**Build**>**Create Executable**), sélectionnez **Package as Zip** pour générer le package MSIXVC nécessaire à l'installation de l'application. Si vous sélectionnez **Package as Installer**, la build ne produit pas de package MSIXVC. L'application ne peut alors pas accéder aux services XBOX. Une fois la build terminée, une fenêtre de l'Explorateur de fichiers s'ouvre et affiche le fichier .zip créé ainsi que son sous-répertoire. Le sous-répertoire porte le même nom que le package et contient le fichier MSIXVC. En outre, la fenêtre de sortie de GameMaker Studio 2 affiche une ligne de code contenant le chemin de sortie complet du package MSIXVC, comme dans l'exemple suivant. `C:\Users\your-user-name\XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc-pkg` Pour exécuter l'exemple de projet de sorte qu'il ait accès aux services XBOX, installez le package à l'aide de `wdapp install` avec le nom de votre package, comme dans l'exemple suivant. `wdapp install XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc.msixvc` Une fois le package installé, lancez-le à l'aide du bouton **Démarrer**. ## Mettre à jour MicrosoftGame.config L'exemple de projet utilise un fichier MicrosoftGame.config par défaut. Pour tester l'exemple ou votre propre projet GameMaker Studio 2 avec les informations de configuration Partner Center de votre projet, mettez à jour le fichier MicrosoftGame.config. Le fichier .config de l'exemple se trouve dans source/GDKExtension\_gml/datafiles/MicrosoftGame.config. Pour utiliser les fonctionnalités des services XBOX, mettez à jour le fichier MicrosoftGame.config de votre projet avec les détails d'identité de votre projet Partner Center en procédant comme suit. 1. Accédez au [tableau de bord Partner Center](https://partner.microsoft.com/dashboard/windows/overview). 2. Sélectionnez votre jeu dans la liste des produits. 3. Sélectionnez l'onglet **Game setup**, puis sélectionnez **Identity details**. 4. Sélectionnez **Show Details** pour développer la section **Identity details**. 5. Utilisez les valeurs suivantes du tableau de la section **Identity details**. Copiez ces valeurs depuis Partner Center dans l'élément et le champ correspondants de MicrosoftGame.config. | Nom dans Partner Center | MicrosoftGame.config | | - | - | | XBOX Title ID | TitleId | | Package/Identity/Name | Identity->Name | | Package/Identity/Publisher | Identity->Publisher | | XBOX services > XBOX Settings > MSAAppId | MSAAppId | Les détails d'identité de Partner Center déterminent le contenu de votre fichier MicrosoftGame.config, comme dans l'exemple suivant. | Nom dans Partner Center | Exemple de valeur | | - | - | | XBOX Title ID | 64353034 | | Package/Identity/Name | 41336MicrosoftATG.Achievements2017Redux | | Package/Identity/Publisher | CN=A4954634-DF4B-47C7-AB70-D3215D246AF1 | | XBOX services > XBOX Settings > MSAAppId | 0000000000000000 | ### Exemple d'extrait de fichier MicrosoftGame.config ```xml theme={null} 64353034 0000000000000000 ``` Pour une vue d'ensemble de MicrosoftGame.config et des informations sur ses valeurs, consultez [Vue d'ensemble de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Overview). ## Intégrer l'extension GDK dans votre projet Au minimum, votre projet doit appeler les fonctions suivantes pour s'intégrer au GDK. * Appelez `gdk_init` pour initialiser le GDK. Vous devez appeler `gdk_init` avant d'utiliser toute autre fonctionnalité du GDK. * Appelez `gdk_update` une fois par image tant que le GDK est actif. * Appelez `gdk_quit` pour nettoyer le GDK lorsque votre projet se termine et que vous n'avez plus besoin d'aucune fonctionnalité du GDK. En outre, l'extension GDK comprend les modules suivants qui donnent accès aux fonctionnalités du GDK. * **Module de base :** fournit un ensemble de fonctions qui contrôlent la sélection de l'utilisateur/du compte pour le joueur * **Module de stockage :** fournit un ensemble de fonctions qui contrôlent le chargement et l'enregistrement des données associées à un utilisateur. * **Module des services XBOX :** fournit des fonctions permettant d'utiliser des fonctionnalités des services XBOX, notamment les statistiques, les classements, les succès et la présence enrichie. * **Module des achats in-app :** fournit des fonctions qui intègrent les projets GameMaker aux systèmes de commerce du Microsoft Store via le GDK. Le guide inclus dans le dépôt GDKExtension documente les fonctions GDK dans la section GDK Extension APIs. Le guide, au format .pdf, se trouve dans source/GDKExtension\_gml/datafiles/GDK\_Extension\_Documentation.pdf. ## Tester les services XBOX dans votre jeu Pour tester les fonctionnalités des services XBOX (par exemple, les succès) dans votre jeu, utilisez une sandbox et des comptes de test ayant accès à cette sandbox. ### Créer un compte de test Pour tester les fonctionnalités des services XBOX dans votre jeu, créez des comptes de test ayant accès à votre sandbox de développement. Pour obtenir des instructions, consultez [Création de comptes de test](/fr/services/xbox-services/develop/test-accounts/live-setup-testaccounts). ### Changer de sandbox 1. Accédez à [Partner Center](https://partner.microsoft.com/dashboard/windows/overview). 2. Pour trouver votre ID de sandbox, sélectionnez **XBOX services**, puis sélectionnez **Gameplay settings**. Votre ID de sandbox apparaît sur le premier onglet de la page **Gameplay settings**. Il se présente sous la forme « ABCDEF.0 ». 3. Sélectionnez le bouton **Démarrer**. 4. Entrez **Microsoft GDK Command Prompts**, puis sélectionnez **Entrée**. 5. Ouvrez la première invite de commandes, puis entrez **XblPCSandbox.exe \**. 6. Une fois que l'invite de commandes a lancé plusieurs applications, connectez-vous à l'application XBOX à l'aide de votre compte de test. Si vous parvenez à vous connecter, vous pouvez commencer les tests dans votre sandbox. Pour plus d'informations sur les sandbox, consultez [Vue d'ensemble des sandbox des services XBOX](/fr/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox). ## Publier votre jeu Pour vous préparer à publier votre jeu, assurez-vous de : * Créer un package MSIXVC à l'aide de **Package as Zip** dans GameMaker Studio 2. * Mettre à jour votre fichier MicrosoftGame.config avec les valeurs correctes du projet que vous avez créé dans Partner Center. * Intégrer l'extension GDK dans votre jeu. Une fois les étapes de cet article terminées, vous êtes prêt à publier votre jeu. Pour le soumettre, accédez à [Partner Center](https://partner.microsoft.com/dashboard/windows/overview) et suivez les instructions de l'interface utilisateur. ## Related topics - [Utiliser le GDK avec Unity, Unreal et d'autres moteurs](/fr/build/gdk-and-engines/gdk-and-engines.md) - [Utiliser le GDK avec Godot](/fr/build/gdk-and-engines/godot.md) - [Utiliser le GDK avec Unity](/fr/build/gdk-and-engines/unity/unity.md) - [Utiliser Clang/LLVM avec le GDK](/fr/tools/tools-pc/visualstudio/gr-vs-clang.md) - [Utiliser le GDK avec Unreal Engine](/fr/build/gdk-and-engines/unreal/unreal.md)