> ## 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 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é](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 obtenir plus de détails ou pour des scénarios qui ne sont pas couverts 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 dans lequel les ressources de chaînes sont référencées dans un fichier manifeste de la façon suivante :</Note>

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

<Note>La référence réelle fonctionne plutôt comme suit (notez l'omission de `Resources/`) :</Note>

```
    ms-resource:ApplicationDisplayName  
```

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

```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 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](https://tools.ietf.org/html/bcp47) 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.

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

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

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

Ensuite, utilisez la commande [makepkg localize](/fr-CA/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 ce qui suit :

```
    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 à 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 :

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

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