Outils permettant d’installer et de lancer votre titre sur PC
Pour plus de renseignements sur le lancement d’applications et le lancement avec Gaming Runtime, voir Lancement d’un jeu Win32.
- wdapp.exe 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. Si vous voulez activer le flux complet du PC Bootstrapper avec votre package, vous pouvez le faire à l’aide de l’indicateur /bootstrapper.
- wdapp.exe register : permet d’inscrire un dossier de fichiers libres afin de pouvoir le lancer. Pour plus de renseignements, voir Inscription de jeux PC. À 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.
- 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 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, 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 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. -
<ExecutionAlias> [launch args]dans une invite de commandes. - Les arguments de ligne de commande dans les propriétés du projet Visual Studio.
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.- Ouvrez Paramètres.
- Saisissez Développeur dans le champ de recherche.
- Dans la liste des options affichées, sélectionnez Utiliser les fonctionnalités de développeur.
- 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.- Ouvrez une invite de commandes PowerShell en tant qu’administrateur.
-
Exécutez cette commande :
get-appxpackage *gamings* -
Exécutez cette commande :
remove-package <package fullname from step 2 for the gamingservices package> - 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-
Exécutez l’application
wdapp list. - Dans la liste obtenue, recherchez toutes les versions des jeux que vous avez installés.
-
Désinstallez tous les jeux à l’aide de
wdapp uninstall <pfn>. - 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 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) avecwdapp install.
La solution de contournement
Veillez à utiliserwdapp 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, Gaming Runtime perd les autorisations de partage, et vous rencontrez ensuite cette erreur.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.- Avant de partager le dossier, exécutez ‘icacls /save AclFile’ pour enregistrer les ACL du dossier du package.
- Partagez le dossier à l’aide du partage de fichiers Windows.
- Pour restaurer les ACL précédentes, exécutez ‘icacls /restore AclFile’.
wdapp.exe unregister, puis wdapp.exe register. Cela restaure les autorisations tout en conservant le partage du dossier.