> ## 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.

# Localisation de MicrosoftGame.config

> Localisation de MicrosoftGame.config

Cette rubrique explique 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é](https://learn.microsoft.com/windows/uwp/app-resources/using-mrt-for-converted-desktop-apps-and-games) sur Microsoft Docs. Vous pouvez vous y référer pour plus de détails ou pour des scénarios qui ne sont pas abordés dans cette rubrique.

<Note>L'[article mentionné précédemment](https://learn.microsoft.com/windows/uwp/app-resources/using-mrt-for-converted-desktop-apps-and-games) décrit un bogue : les ressources de chaîne y sont référencées dans un fichier manifeste de la manière suivante :</Note>

```
    ms-resource:Resources/ApplicationDisplayName  
```

<Note>La référence réelle fonctionne ainsi (notez l'omission de `Resources/`) :</Note>

```
    ms-resource:ApplicationDisplayName  
```

## Inclure des éléments visuels de 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 spécifient le contenu textuel à afficher, contenu dans des attributs :
`OverrideDisplayName="My Game's Display Name"`.

```xml theme={null}

  <ExecutableList>
    <Executable Name="MyGame.exe"
                OverrideDisplayName="My Game's Display Name"
                Id="Game"/>
  </ExecutableList>

  <ShellVisuals DefaultDisplayName="PackageName"
                PublisherDisplayName="Publisher Display name"
                StoreLogo="Storelogo.png"
                Square150x150Logo="Logo.png"
                Square44x44Logo="SmallLogo.png"
                Description="My App Description"
                BackgroundColor="#000040"
                SplashScreenImage="SplashScreen.png"/>  
```

Si vous souhaitez proposer 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 parlé au Mexique. Veillez à utiliser le code [BCP-47](https://tools.ietf.org/html/bcp47) approprié pour chaque langue.
3. Dans chaque fichier XML, ajoutez le contenu suivant, en remplaçant le texte mis en évidence par le texte approprié pour votre application, dans la langue appropriée. L'exemple suivant illustre l'utilisation de `(English)` comme simple suffixe.

```xml theme={null}
    <?xml version="1.0" encoding="utf-8"?>
    <root>
        <data name="ApplicationDescription">
            <value>Contoso Demo app with localized resources (English)</value>
        </data>
        <data name="ApplicationDisplayName">
            <value>Contoso Demo Sample (English)</value>
        </data>
    </root>
```

Ensuite, mettez à jour votre fichier *MicrosoftGame.config* pour qu'il référence ces chaînes de ressources à l'aide de la syntaxe `ms-resource:ResourceStringName`, comme illustré ci-dessous dans les propriétés `OverrideDisplayName` et `Description`.

```xml theme={null}
<ExecutableList>
    <Executable Name="MyGame.exe"
              OverrideDisplayName="ms-resource:ApplicationDisplayName"
              Id="Game"/>
</ExecutableList>

<ShellVisuals DefaultDisplayName="PackageName"
              PublisherDisplayName="Publisher Display name"
              StoreLogo="Storelogo.png"
              Square150x150Logo="Logo.png"
              Square44x44Logo="SmallLogo.png"
              Description="ms-resource:ApplicationDescription"
              BackgroundColor="#000040"
              SplashScreenImage="SplashScreen.png"/>
```

Ensuite, assurez-vous que votre fichier *MicrosoftGame.config* contient la liste des cibles de localisation prises en charge par votre application. Si, par exemple, votre application prend en charge l'anglais des États-Unis et l'espagnol du Mexique, votre fichier .config contiendra l'élément suivant comme enfant de l'élément `Game`.

```xml theme={null}
<Resources>
    <Resource Language="en-US" />
    <Resource Language="es-MX" />
</Resources>
```

Ensuite, utilisez la commande [makepkg localize](/fr/build/core-features/common/packaging/deployment/makepkg) 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 la commande suivante :

```
    makepkg localize /d . /resw Strings
```

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 dans 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 d'exportation des ressources vers un fichier XML, que vous pouvez vérifier manuellement afin de vous assurer qu'il contient les ressources appropriées.

Par exemple :

```
    makepkg localize /d . /resw Resources /pd ..\FinalLooseFolder /t ..\TempOutput
```

Maintenant que vous disposez d'un fichier *resources.pri* dans le répertoire de contenu racine de votre jeu, vous pouvez créer votre package comme vous le feriez habituellement.

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 de l'application Microsoft Store proviennent des données chargées dans Partner Center, et non des informations contenues dans le package de votre application.

## Voir aussi

[MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-toc)
[Vue d'ensemble de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
[Éditeur MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Editor)
[Référence de MicrosoftGame.config (exemple de MicrosoftGame.config et schéma)](/fr/reference/system/microsoftgameconfig/microsoftgameconfig-schema)
[Vue d'ensemble de l'empaquetage](/fr/build/core-features/common/packaging/overviews/packaging)


## Related topics

- [MicrosoftGame.config](/es/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)
- [Referencia de MicrosoftGame.config](/es/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md)
- [Localización de MicrosoftGame.config](/es/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Editor de MicrosoftGame.config](/es/build/core-features/common/game-config/MicrosoftGameConfig-Editor.md)
- [Elemento de MicrosoftGame.config - Game](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-game.md)