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

# Localización de recursos empaquetados

> Localice cadenas, imágenes y recursos del paquete de GDK mediante MicrosoftGame.config, el diseño de fragmentos e Intelligent Delivery para descargas por configuración regional.

Las cadenas y las imágenes a las que se hace referencia en `MicrosoftGame.config` se pueden localizar según la configuración regional del usuario. Visual Studio 2019+ genera automáticamente un archivo `resources.pri` que el sistema operativo consulta en tiempo de ejecución.

Vuelque el archivo desde el símbolo del sistema del GDK:

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

## Localización del nombre y la descripción de la aplicación

### Adición de cadenas predeterminadas

1. Haga clic con el botón derecho en el proyecto en el Explorador de soluciones y agregue un **New Filter** denominado `Strings`.
2. Haga clic con el botón derecho en `Strings` y agregue **New Item > Assembly Resource File (.resx)**. VS crea `resources.resx` en la raíz del paquete.

<Note>
  El GDK requiere `.resw`. Cambie el nombre de `resources.resx` a `resources.resw`.
</Note>

### Referencia a las cadenas en 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"/>
```

### Adición de cadenas por idioma

Cree un filtro `Strings/<lang>` por cada idioma admitido, agregue un archivo de recursos de ensamblado en cada uno, establezca **Item Type** = **PRI Resource** y cambie el nombre a `.resw`.

### Declaración de los idiomas en MicrosoftGame.config

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

Para la compatibilidad con chino tradicional, incluya también `zh-SG` y `zh-CN` como reserva.

## Localización de imágenes

`Logo`, `SmallLogo`, `SplashScreen` y `StoreLogo` se pueden localizar:

1. Agregue subcarpetas por idioma dentro de una carpeta compartida (por ejemplo, `Images`).
2. Agregue imágenes con **Item Type** = **Image** y **Content** = **Yes**.
3. Proporcione imágenes predeterminadas en la raíz como reserva.

<Note>
  Incluya al menos un recurso de imagen. De lo contrario, las cadenas localizadas no se resolverán y el nombre del título se mostrará como `ms-resource:AppName`.
</Note>

## Diseño de fragmentos

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

Etiquete los fragmentos con `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>
```

### Comportamiento de instalación

* Consola en `en-US` → instala 1005 y 1008.
* Consola en `en-GB` → recurre a `en-US` → instala 1005 y 1008.
* Los fragmentos sin etiquetar se instalan siempre.

### Pruebas con xbapp

* `/Languages`: instala para los idiomas enumerados, independientemente de la configuración de la consola.
* `/AllChunks`: instala el paquete completo.
* `/w`: mantiene la conexión abierta después de la instalación.

## Consulte también

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

## Documentación de API relacionada

* [Referencia de la API XPackage](/reference/system/xpackage/xpackage_members): montar y enumerar fragmentos de paquete localizados
* [Referencia de elementos de MicrosoftGame.config](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc): declaraciones de recursos + fragmentos


## Related topics

- [Uso del GDK con Unity](/es/build/gdk-and-engines/unity/unity.md)
- [Creación e implementación de compilaciones de Linux](/es/services/playfab/multiplayer/servers/deploying-linux-based-builds.md)
- [Intelligent Delivery: especificadores de dispositivo](/es/build/core-features/common/packaging/intelligentdelivery-device.md)
- [Localización de MicrosoftGame.config](/es/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Información general sobre localización y globalización](/es/build/game-principles/localization.md)