> ## 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 du package

> Localisez les chaînes, les images et les ressources de votre package GDK à l'aide de MicrosoftGame.config, de la disposition des segments 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 à l'exécution.

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

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

## Localisation du nom et de la description de l'application

### Ajouter des 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 exige le format `.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 dans chacun, définissez **Type d'élément** = **Ressource PRI**, puis 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, indiquez aussi `zh-SG` et `zh-CN` à des fins de repli.

## Localisation des images

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

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

<Note>
  Incluez au moins une ressource 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 segments

```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 segments 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 segments non étiquetés sont toujours installés.

### Test avec xbapp

* `/Languages` : installe pour les langues indiquées, quel que soit le paramètre de la console.
* `/AllChunks` : installe le package complet.
* `/w` : garde la connexion ouverte après l'installation.

## Voir aussi

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

## Documentation des API connexes

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


## Related topics

- [Créer un index des ressources de package (MakePRI.exe)](/fr-CA/build/core-features/common/packaging/deployment/makepri.md)
- [Localisation de MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Vue d'ensemble de la localisation et de la mondialisation](/fr-CA/build/game-principles/localization.md)
- [Packages](/fr-CA/publishing/game-publishing/concepts/game-package-management.md)
- [Propriétés Visual Studio pour le développement de jeux sur PC](/fr-CA/tools/tools-pc/visualstudio/gr-vs-property-pages.md)