Localisation des ressources empaquetées

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.

​

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

<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

​

Déclarer les langues dans MicrosoftGame.config

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
</Resources>

​

Localiser les images

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.

​

Disposition des blocs

<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

<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
• Intelligent Delivery

​

Documentation des API associées

• Référence de l’API XPackage : monter/énumérer les blocs de package localisés
• Référence des éléments MicrosoftGame.config : déclarations de ressources + de blocs