> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Utilisation des outils du Microsoft Game Development Kit (GDK) pour installer et lancer votre titre PC > Comment utiliser les outils du Microsoft Game Development Kit (GDK) pour installer, lancer et dépanner des titres PC exécutés sur Microsoft Gaming Runtime. Cette rubrique décrit les outils du Microsoft Game Development Kit (GDK) permettant d'installer et de lancer votre titre PC. Elle explique comment utiliser ces outils et fournit des informations sur le dépannage des problèmes d'installation et de lancement sur PC. ## Outils permettant d'installer et de lancer votre titre sur PC > [!NOTE] > > Pour plus de renseignements sur le lancement d'applications et le lancement avec Gaming Runtime, voir [Lancement d'un jeu Win32](https://docs.xbox.com/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md#MSGC-PCLaunch). Le Microsoft Game Development Kit (GDK) propose les approches suivantes pour installer votre titre. * [wdapp.exe install](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_install) : permet d'installer un package .MSIXVC de votre titre. Pour plus de renseignements sur l'empaquetage de votre titre PC, voir [Prise en main de l'empaquetage de titres pour PC à l'aide des outils d'empaquetage MSIXVC](https://docs.xbox.com/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md). Si vous voulez activer le flux complet du [PC Bootstrapper](https://docs.xbox.com/fr-CA/build/gdk-and-engines/guides/pc-bootstrapper.md) avec votre package, vous pouvez le faire à l'aide de l'indicateur /bootstrapper. * [wdapp.exe register](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register) : permet d'inscrire un dossier de fichiers libres afin de pouvoir le lancer. Pour plus de renseignements, voir [Inscription de jeux PC](https://docs.xbox.com/fr-CA/tools/tools-pc/title-registration-pc.md). À partir du GDK de juin 2022, vous n'avez besoin d'inscrire votre jeu que si vous voulez activer les icônes du shell sur le Bureau et dans le menu Démarrer, par exemple lorsque vous testez votre scénario d'installation commerciale. Le Microsoft Game Development Kit (GDK) propose les approches suivantes pour lancer votre titre : * Une fois votre titre inscrit, il apparaît comme sélectionnable dans le menu Démarrer et peut être recherché dans la zone de recherche. * [wdapp.exe launch](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_launch) permet de lancer un titre à l'aide de son ID de modèle utilisateur d'application (AUMID) ou d'un chemin d'accès à l'exécutable. * Windows Device Portal (WDP) : accédez à **Installed Apps**, puis sélectionnez **Start**. ### Lancement avec le PC Bootstrapper activé Pour lancer le titre avec le flux complet du [PC Bootstrapper](https://docs.xbox.com/fr-CA/build/gdk-and-engines/guides/pc-bootstrapper.md), tel qu'un utilisateur commercial le verrait, vous devez charger un package de façon indépendante par wdapp install et utiliser l'indicateur /bootstrapper. Pour les builds de fichiers libres ou les installations sans cet indicateur, les fonctionnalités du PC Bootstrapper se limitent à l'application du modèle utilisateur simplifié au moment de l'appel à XUserAddAsync. ### Lancement avec et sans identité de titre Depuis le GDK de juin 2022, le runtime doit fonctionner de façon identique quelle que soit la méthode utilisée pour lancer le titre, à condition que votre [MicrosoftGame.config](https://docs.xbox.com/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md) soit correctement configuré. ### Lancement avec des arguments de ligne de commande Depuis le GDK de juin 2022, vous pouvez simplement lancer directement votre exécutable en lui passant directement les \[launch args] souhaités. Vous pouvez aussi utiliser l'une des méthodes suivantes pour lancer votre titre avec des arguments de ligne de commande : * `WdApp Launch [launch args]` depuis une invite de commandes GDK. * ` [launch args]` dans une invite de commandes. * Les arguments de ligne de commande dans les propriétés du projet Visual Studio. Pour plus de renseignements sur l'utilisation d'un alias d'exécution, voir [ExecutionAlias](https://docs.xbox.com/fr-CA/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md#MicrosoftGameConfig-Alias). ## Dépannage des problèmes d'installation et de lancement sur PC ### Code d'erreur 0x80073CFF : Deployment of package failed because no valid license or sideloading policy could be applied. A developer license or enterprise sideloading configuration may be required. #### Le problème Vous avez rencontré un problème lors de la tentative d'installation, d'inscription ou de lancement de votre titre. #### La solution La solution consiste à activer le mode développeur sur votre PC en procédant comme suit. 1. Ouvrez **Paramètres**. 2. Saisissez *Développeur* dans le champ de recherche. 3. Dans la liste des options affichées, sélectionnez **Utiliser les fonctionnalités de développeur**. 4. Sélectionnez **Mode développeur**. Une boîte de dialogue s'affiche pour indiquer que le système ajoute des fonctionnalités. Veillez à attendre la fin de ce processus. ### Code d'erreur 0x80073cfc : The application cannot be started. Try reinstalling the application to fix the problem. #### Le problème Vous avez rencontré un problème lors de l'une des étapes initiales du processus d'installation. #### La solution de contournement Vous pouvez désinstaller et réinstaller Gaming Runtime Services (GRTS). Pour ce faire, procédez comme suit. 1. Ouvrez une invite de commandes PowerShell en tant qu'administrateur. 2. Exécutez cette commande : `get-appxpackage *gamings*` 3. Exécutez cette commande : `remove-package ` 4. Ouvrez l'application XBOX, puis installez un jeu. Cela déclenche l'installation du package gamingservices depuis le Microsoft Store. ### Code d'erreur 0x87e00017 : Install source was found but cannot be reached. Likely internet problem. #### Le problème Ce code d'erreur correspond à `IM_E_UNREACHABLE_INSTALL_SOURCE`. Vous rencontrez cette erreur si le système de déploiement ne parvient pas à accéder à vos fichiers. Toutefois, même si c'est possible, cela peut aussi signifier que le répertoire d'installation est endommagé. La cause la plus fréquente est un déploiement partiellement réussi qui n'a pas été correctement nettoyé par la suite. #### La solution Pour résoudre ces problèmes 1. Exécutez l'application `wdapp list`. 2. Dans la liste obtenue, recherchez toutes les versions des jeux que vous avez installés. 3. Désinstallez tous les jeux à l'aide de `wdapp uninstall `. 4. Réessayez d'installer votre jeu. ### Code d'erreur 0x80080203 : The specified package format is not valid: The file is not a valid app package because it is missing a required footprint file. #### Le problème Ce problème se produit lorsque vous avez un « MSIXVC imbriqué » (ce qui peut facilement arriver). Supposons que votre build pour ordinateur de bureau se trouve dans *C:\MyGame*. Vous décidez de créer un package à l'aide de [makepkg.exe](https://docs.xbox.com/fr-CA/build/core-features/common/packaging/deployment/makepkg.md) dans un sous-dossier de *C:\MyGame* (par exemple, dans *C:\MyGame\Package*). Cela fonctionne la première fois, car aucun package n'a encore été généré, mais vous rencontrez ensuite ce problème lorsque vous essayez de recréer un package. En plus de cet échec (dû à la présence de deux fichiers *AppxManifest.xml* dans le package), l'exécution de *makepkg.exe* sur *C:\MyGame* tenterait d'empaqueter le fichier .msixvc existant dans le nouveau package (à moins que vous ne l'ayez exclu du genmap). #### La solution Pour résoudre ce problème, assurez-vous que votre répertoire de package se trouve en dehors du répertoire qui contient votre *MicrosoftGame.config*. ### Code d'erreur 0x80070490 : Element not found #### Le problème Ce problème se produit si vous tentez d'installer un fichier .XVC (le format d'empaquetage d'un package XBOX) avec `wdapp install`. #### La solution de contournement Veillez à utiliser `wdapp install` uniquement pour les packages .MSIXVC (le format d'empaquetage d'un package PC). ### Erreurs de lancement par wdapp lorsque le dossier du titre est partagé #### Le problème Si vous partagez, avec le partage de fichiers Windows, un dossier que vous avez précédemment inscrit avec [wdapp.exe register](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register), Gaming Runtime perd les autorisations de partage, et vous rencontrez ensuite cette erreur. ``` 'WdApp.exe launch' must be called with an AUMID to activate an application. Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values. Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*, typing the alias name at the command prompt will do an application activation. Failed with 0x80070057. ``` #### La solution de contournement Le problème est lié à la liste de contrôle d'accès (ACL). Le partage du dossier empêche l'accès au modèle d'application. Autrement dit, le conteneur perd l'autorisation de lire les fichiers lors du partage. Pour contourner le problème, procédez comme suit pour enregistrer et restaurer les données ACL. 1. Avant de partager le dossier, exécutez 'icacls /save AclFile' pour enregistrer les ACL du dossier du package. 2. Partagez le dossier à l'aide du partage de fichiers Windows. 3. Pour restaurer les ACL précédentes, exécutez 'icacls /restore AclFile'. En plus de cette solution de contournement, vous pouvez aussi réinscrire le titre en exécutant d'abord `wdapp.exe unregister`, puis `wdapp.exe register`. Cela restaure les autorisations tout en conservant le partage du dossier. ### Code d'erreur 0x80070005 : Access is denied. #### Le problème Vous rencontrez une erreur "0x8007005: Access is Denied" lors de l'exécution de la commande wdapp install. #### La solution Veillez à passer le chemin d'accès complet au fichier .msixvc. Par exemple : Correct : *wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"* Incorrect (chemin d'accès complet au fichier .msixvc manquant) : *wdapp install "c:\MyGame\GDKBuildFolder"* ### Code d'erreur 0x000007b : STATUS\_INVALID\_IMAGE\_FORMAT #### Le problème Vous rencontrez une erreur "0x000007b" lors de l'exécution de la commande wdapp launch. #### La solution Le problème vient du fait que l'exécutable lancé a une architecture de plateforme différente de celle spécifiée dans MicrosoftGame.config. L'élément DesktopRegistration de MicrosoftGame.config possède un élément enfant facultatif appelé ProcessorArchitecture, dont la valeur peut être 'x86' ou 'x64'. Pour résoudre ce problème, assurez-vous que cette spécification correspond à l'architecture de plateforme de l'exécutable défini dans l'élément Executable. ### Code d'erreur 0x800701B1 : A device which does not exist was specified. #### Le problème Vous rencontrez une erreur "0x800701B1" lors de l'exécution de la commande wdapp install /drive. #### La solution Le problème vient du fait que le lecteur cible n'a pas été détecté par le Windows Store. Assurez-vous que le lecteur cible figure dans la liste déroulante "Les nouvelles applications seront enregistrées sur :" dans "Paramètres -> Paramètres de stockage -> Modifier l'emplacement d'enregistrement du nouveau contenu" sur votre PC local. Si le lecteur n'y figure pas, vérifiez l'état du lecteur et assurez-vous que le PC local dispose des dernières mises à jour Windows. ### Code d'erreur 0x80072F78 : WININET\_E\_INVALID\_SERVER\_RESPONSE #### Le problème Vous rencontrez une erreur "0x80072F78" lors de l'exécution de la commande wdapp install. #### La solution Ce problème a été associé à des paramètres de configuration de proxy de pare-feu qui bloquent l'adresse "settings-win.data.microsoft.com". Cette adresse est nécessaire pour que les paramètres d'installation soient correctement mis en cache lors de l'installation de votre titre GDK pour PC. Assurez-vous que cette adresse est autorisée dans votre logiciel de pare-feu. ## Voir aussi [Prise en main du Microsoft Game Development Kit](https://docs.xbox.com/fr-CA/home/setup-install/get-started.md) [Prise en main de l'empaquetage pour PC](https://docs.xbox.com/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md) [PC Bootstrapper](https://docs.xbox.com/fr-CA/build/gdk-and-engines/guides/pc-bootstrapper.md) [MicrosoftGame.config](https://docs.xbox.com/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-toc.md) [Gestion des applications (wdapp.exe)](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-wdapp.md) [Inscription de jeux PC](https://docs.xbox.com/fr-CA/tools/tools-pc/title-registration-pc.md) [Vue d'ensemble de l'installation de fichiers plats](https://docs.xbox.com/fr-CA/build/core-features/common/packaging/packaging-flatfileinstall.md) [Outils en ligne de commande (pour PC)](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md) [Développement de jeux sur PC (environnement et outils)](https://docs.xbox.com/fr-CA/tools/tools-pc/gc-tools-pc-toc.md) ## Related topics - [Inscription de jeux PC](https://docs.xbox.com/fr-CA/tools/tools-pc/title-registration-pc.md) - [Environnement et outils de développement de jeux sur PC](https://docs.xbox.com/fr-CA/tools/tools-pc/gc-tools-pc-toc.md) - [Outils de développement PC pour le GDK XBOX](https://docs.xbox.com/fr-CA/tools/tools-pc/index.md) - [PC Bootstrapper](https://docs.xbox.com/fr-CA/build/gdk-and-engines/guides/pc-bootstrapper.md) - [Outils en ligne de commande pour le développement sur PC](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)