> ## 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 décrit 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 du 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 XBOX services 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 les 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 des GRTS. PC Bootstrapper dépend des GRTS pour fonctionner correctement. Si les GRTS ne sont pas à jour sur votre PC de développement, les tentatives de connexion peuvent échouer et retourner une erreur `E_FAIL`. Pour obtenir des conseils détaillés sur PC Bootstrapper, notamment son rôle dans le processus de lancement des jeux et son interaction avec les GRTS, consultez [Vue d'ensemble de PC Bootstrapper](/fr-CA/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 à partir de [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 requise pour utiliser le GDK avec GameMaker Studio 2. Pour 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 à 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 XBOX services et leurs fonctionnalités 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 lorsque vous générerez 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 à la racine du dépôt. Le fichier GDKExtension.sln est requis (\/source/GDKExtension\_gml/extensions/GDKExtension/gdkextension\_windows/GDKExtension.sln). Pour des instructions de génération détaillées, consultez les étapes de génération dans le fichier README à la racine du dépôt. ## Créer un produit dans Microsoft Partner Center Pour créer votre produit compatible avec les XBOX services dans Partner Center, consultez [Configuration d'une application ou d'un jeu dans Partner Center, pour les partenaires gérés](/fr-CA/services/xbox-services/fundamentals/portal-config/live-setup-partner-center-partners). Après avoir créé votre produit, vous pouvez tester les XBOX services ou publier un jeu sur le Microsoft Store. ## Tester l'extension GDK Le dépôt de l'extension GDK comprend 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 à l'emplacement `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 génération ne produit pas de package MSIXVC. L'application ne peut alors pas accéder aux XBOX services. À la fin de la génération, une fenêtre de l'Explorateur de fichiers s'ouvre et affiche le fichier .zip créé et son sous-répertoire. Le sous-répertoire porte le même nom que le package et contient le fichier MSIXVC. De plus, la fenêtre de sortie de GameMaker Studio 2 affiche une ligne de code avec 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 façon à ce qu'il ait accès aux XBOX services, 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 de votre projet dans Partner Center, 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 XBOX services, mettez à jour le fichier MicrosoftGame.config de votre projet avec les détails d'identité de votre projet dans Partner Center en suivant les étapes ci-dessous. 1. Accédez au [tableau de bord de 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 de 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-CA/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 trame 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. De plus, 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 ou 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 XBOX services :** Fournit des fonctions permettant d'utiliser des fonctionnalités des XBOX services, notamment les statistiques, les classements, les succès et la présence enrichie. * **Module Achats intégrés :** Fournit des fonctions qui intègrent les projets GameMaker aux systèmes commerciaux du Microsoft Store par l'intermédiaire du GDK. Le guide inclus dans le dépôt GDKExtension documente les fonctions du GDK dans la section GDK Extension APIs. Ce guide, au format .pdf, se trouve dans source/GDKExtension\_gml/datafiles/GDK\_Extension\_Documentation.pdf. ## Tester les XBOX services dans votre jeu Pour tester les fonctionnalités des XBOX services (par exemple, les succès) dans votre jeu, utilisez un bac à sable et des comptes de test ayant accès à ce bac à sable. ### Créer un compte de test Pour tester les fonctionnalités des XBOX services dans votre jeu, créez des comptes de test ayant accès à votre bac à sable de développement. Pour obtenir des instructions, consultez [Création de comptes de test](/fr-CA/services/xbox-services/develop/test-accounts/live-setup-testaccounts). ### Changer de bac à sable 1. Accédez à [Partner Center](https://partner.microsoft.com/dashboard/windows/overview). 2. Pour trouver l'ID de votre bac à sable, sélectionnez **XBOX services**, puis **Gameplay settings**. L'ID de votre bac à sable apparaît dans le premier onglet de la page **Gameplay settings**. Il porte un nom comme « 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 bac à sable. Pour plus d'informations sur les bacs à sable, consultez [Vue d'ensemble des bacs à sable des XBOX services](/fr-CA/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-CA/build/gdk-and-engines/gdk-and-engines.md) - [Utiliser le GDK avec Godot](/fr-CA/build/gdk-and-engines/godot.md) - [Utiliser le GDK avec Unity](/fr-CA/build/gdk-and-engines/unity/unity.md) - [Utiliser Clang/LLVM avec le GDK](/fr-CA/tools/tools-pc/visualstudio/gr-vs-clang.md) - [Utiliser le GDK avec Unreal Engine](/fr-CA/build/gdk-and-engines/unreal/unreal.md)