> ## 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 des ressources empaquetées

> Localisez les chaînes, les images et les ressources de votre package GDK à l'aide de MicrosoftGame.config, de la disposition des blocs et d'Intelligent Delivery pour les téléchargements par paramètres régionaux.

Les chaînes et les images référencées dans `MicrosoftGame.config` peuvent être localisées selon les paramètres régionaux de l'utilisateur. Visual Studio 2019+ génère automatiquement un fichier `resources.pri` que le système d'exploitation consulte lors de l'exécution.

Videz le contenu du fichier à partir de l'invite de commandes GDK :

```text theme={null}
MakePri.exe dump /if resources.pri /of out.xml
```

## Localiser le nom et la description de l'application

### Ajouter les chaînes par défaut

1. Cliquez avec le bouton droit sur votre projet dans l'Explorateur de solutions et ajoutez un **Nouveau filtre** nommé `Strings`.
2. Cliquez avec le bouton droit sur `Strings` et ajoutez un **Nouvel élément > Fichier de ressources d'assembly (.resx)**. VS crée `resources.resx` à la racine du package.

<Note>
  Le GDK nécessite `.resw`. Renommez `resources.resx` en `resources.resw`.
</Note>

### Référencer les chaînes dans MicrosoftGame.config

```xml theme={null}
<ShellVisuals DefaultDisplayName="ms-resource:AppName"
              PublisherDisplayName="Publisher Display name"
              StoreLogo="StoreLogo.png"
              Square150x150Logo="Logo.png"
              Square44x44Logo="SmallLogo.png"
              Description="ms-resource:AppDescription"
              BackgroundColor="#000040"
              SplashScreenImage="SplashScreen.png"/>
```

### Ajouter des chaînes par langue

Créez un filtre `Strings/<lang>` pour chaque langue prise en charge, ajoutez un fichier de ressources d'assembly sous chacun, définissez **Type d'élément** = **Ressource PRI** et renommez-le en `.resw`.

### Déclarer les langues dans MicrosoftGame.config

```xml theme={null}
<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
</Resources>
```

Pour la prise en charge du chinois traditionnel, répertoriez également `zh-SG` et `zh-CN` pour le repli.

## Localiser les images

`Logo`, `SmallLogo`, `SplashScreen` et `StoreLogo` peuvent être localisés :

1. Ajoutez des sous-dossiers par langue sous un dossier partagé (par exemple, `Images`).
2. Ajoutez les images avec **Type d'élément** = **Image**, **Contenu** = **Oui**.
3. Fournissez des images par défaut à la racine comme solutions de repli.

<Note>
  Incluez au moins une ressource d'image. Sinon, les chaînes localisées ne seront pas résolues et le nom du titre s'affichera sous la forme `ms-resource:AppName`.
</Note>

## Disposition des blocs

```xml theme={null}
<Chunk Id="1000" Marker="Launch">
    <FileGroup DestinationPath="\Images"       SourcePath="Images"       Include="*.*"/>
    <FileGroup DestinationPath="\Images\en-US" SourcePath="Images\en-US" Include="*.*"/>
    <FileGroup DestinationPath="\Images\fr-FR" SourcePath="Images\fr-FR" Include="*.*"/>
    <FileGroup DestinationPath="\" SourcePath="." Include="resources.pri"/>
</Chunk>
```

## Intelligent Delivery

Étiquetez les blocs avec `Languages` :

```xml theme={null}
<Chunk Id="1005" Languages="en-US">
    <FileGroup DestinationPath="\assets\audio" SourcePath="." Include="en_us_commentary.mp3"/>
</Chunk>
<Chunk Id="1008" Languages="es-MX, en-US">
    <FileGroup DestinationPath="\assets" SourcePath="." Include="mixed_content.dat"/>
</Chunk>
```

### Comportement d'installation

* Console en `en-US` → installe 1005 et 1008.
* Console en `en-GB` → repli sur `en-US` → installe 1005 et 1008.
* Les blocs non étiquetés sont toujours installés.

### Tester avec xbapp

* `/Languages` : installe pour les langues répertoriées, quel que soit le paramètre de la console.
* `/AllChunks` : installe l'intégralité du package.
* `/w` : maintient la connexion ouverte après l'installation.

## Voir aussi

* [Localisation de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Localization)
* [Intelligent Delivery](/fr/build/core-features/common/packaging/intelligentdelivery-features-recipes)

## Documentation des API associées

* [Référence de l'API XPackage](/fr/reference/system/xpackage/xpackage_members) : monter/énumérer les blocs de package localisés
* [Référence des éléments MicrosoftGame.config](/fr/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) : déclarations de ressources + de blocs


## Related topics

- [Localisation de MicrosoftGame.config](/fr/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Vue d'ensemble de la localisation et de la globalisation](/fr/build/game-principles/localization.md)
- [Localisation Economy v2](/fr/services/playfab/economy-monetization/economy-v2/catalog/localization.md)
- [CopyTiles](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_copytiles_public.md)
- [Propriétés Visual Studio pour le développement de jeux sur PC](/fr/tools/tools-pc/visualstudio/gr-vs-property-pages.md)