Skip to main content
Cette rubrique décrit comment localiser les chaînes d’affichage des jeux empaquetés afin que les versions localisées appropriées de vos chaînes s’affichent dans l’interpréteur de commandes (shell). Ces étapes se rapportent à l’article Utiliser le système de gestion des ressources Windows 10 dans une application ou un jeu hérité sur Microsoft Docs. Vous pouvez vous y référer pour obtenir plus de détails ou pour des scénarios qui ne sont pas couverts dans cette rubrique.
L’article mentionné précédemment décrit un bogue dans lequel les ressources de chaînes sont référencées dans un fichier manifeste de la façon suivante :
La référence réelle fonctionne plutôt comme suit (notez l’omission de Resources/) :

Inclusion d’éléments visuels du shell localisés dans votre jeu

Lorsque vous commencez l’empaquetage, vous disposez d’un fichier MicrosoftGame.config comportant des sections comme les suivantes, qui précisent le contenu textuel à afficher, contenu dans des attributs : OverrideDisplayName="My Game's Display Name".
Si vous souhaitez permettre différentes versions localisées de ces chaînes, vous pouvez le faire en créant des fichiers .resw dans des sous-dossiers individuels de votre application associés aux langues que vous souhaitez prendre en charge.
  1. Créez un fichier XML nommé resources.resw et placez-le dans le sous-dossier Strings de votre projet. Il servira de solution de repli indépendante de la langue pour votre projet.
  2. Pour chaque langue, créez un nouveau sous-dossier Strings pour votre projet. Par exemple, Strings\en-us pour l’anglais ou Strings\es-mx pour l’espagnol tel que parlé au Mexique. Assurez-vous d’utiliser le code BCP-47 approprié pour chaque langue.
  3. Dans chaque fichier XML, ajoutez le contenu suivant, en remplaçant le texte en surbrillance par le texte approprié pour votre application, dans la langue appropriée. L’exemple suivant illustre l’utilisation de (English) comme simple suffixe.
Ensuite, mettez à jour votre fichier MicrosoftGame.config pour référencer ces chaînes de ressources à l’aide de la syntaxe ms-resource:ResourceStringName, illustrée ci-dessous dans les propriétés OverrideDisplayName et Description.
Ensuite, assurez-vous que votre fichier MicrosoftGame.config contient la liste des cibles de localisation que votre application prend en charge. Par exemple, si votre application prend en charge l’anglais des États-Unis et l’espagnol du Mexique, votre fichier .config contiendrait ce qui suit comme élément enfant de Game.
Ensuite, utilisez la commande makepkg localize pour générer un fichier Resource.pri, qui contiendra ces chaînes de ressources localisées. Placez le fichier Resources.pri obtenu dans le répertoire de contenu racine de votre jeu.
  1. Ouvrez une invite de commandes de jeu du Microsoft Game Development Kit (GDK) dans le répertoire de contenu racine de votre jeu.
  2. Exécutez ce qui suit :
Vous pouvez exécuter makepkg localize avec des paramètres supplémentaires si votre structure de répertoires ne correspond pas à cet exemple ou si une vérification supplémentaire est nécessaire.
  • Utilisez /resw pour spécifier un chemin relatif à la racine permettant de trouver les fichiers .resw.
  • Utilisez /pd avec un répertoire pour stocker le fichier Resources.pri obtenu à un emplacement autre que le répertoire racine par défaut. Le répertoire cible doit déjà exister.
  • Utilisez /t avec un nom de répertoire pour spécifier un emplacement où exporter les ressources dans un fichier XML, qui peut être vérifié manuellement afin de s’assurer qu’il contient les ressources appropriées.
Par exemple :
Maintenant que vous avez un fichier resources.pri dans le répertoire de contenu racine de votre jeu, vous pouvez créer votre package comme d’habitude. Enfin, vérifiez que, lors d’une installation avec le système réglé sur l’anglais ou l’espagnol du Mexique, vos chaînes localisées s’affichent dans le menu Démarrer et dans les autres pages système qui affichent les chaînes de votre application. Notez que les icônes dans l’application Microsoft Store proviennent des données téléversées dans Partner Center, et non des informations contenues dans votre package d’application.

Voir aussi

MicrosoftGame.config Vue d’ensemble de MicrosoftGame.config Éditeur MicrosoftGame.config Référence de MicrosoftGame.config (exemple de MicrosoftGame.config et schéma) Vue d’ensemble de l’empaquetage
Last modified on October 6, 2026