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

# Localização de recursos empacotados

> Localize strings, imagens e ativos no seu pacote do GDK usando o MicrosoftGame.config, o layout de partes e o Intelligent Delivery para downloads por localidade.

As strings e imagens referenciadas no `MicrosoftGame.config` podem ser localizadas para a localidade do usuário. O Visual Studio 2019+ gera automaticamente um arquivo `resources.pri` que o sistema operacional consulta em tempo de execução.

Despeje o conteúdo do arquivo a partir do prompt de comando do GDK:

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

## Localização do nome e da descrição do aplicativo

### Adicionar strings padrão

1. Clique com o botão direito do mouse no seu projeto no Gerenciador de Soluções e adicione um **Novo Filtro** chamado `Strings`.
2. Clique com o botão direito do mouse em `Strings` e adicione um **Novo Item > Arquivo de Recurso de Assembly (.resx)**. O VS cria `resources.resx` na raiz do pacote.

<Note>
  O GDK exige `.resw`. Renomeie `resources.resx` para `resources.resw`.
</Note>

### Referenciar strings no 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"/>
```

### Adicionar strings por idioma

Crie um filtro `Strings/<lang>` para cada idioma compatível, adicione um Arquivo de Recurso de Assembly em cada um, defina **Tipo de Item** = **PRI Resource** e renomeie para `.resw`.

### Declarar idiomas no MicrosoftGame.config

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

Para oferecer suporte a chinês tradicional, liste também `zh-SG` e `zh-CN` como fallback.

## Localização de imagens

`Logo`, `SmallLogo`, `SplashScreen` e `StoreLogo` podem ser localizados:

1. Adicione subpastas por idioma em uma pasta compartilhada (por exemplo, `Images`).
2. Adicione imagens com **Tipo de Item** = **Imagem** e **Conteúdo** = **Sim**.
3. Forneça imagens padrão na raiz como fallback.

<Note>
  Inclua pelo menos um recurso de imagem. Caso contrário, as strings localizadas não serão resolvidas e o nome do título será exibido como `ms-resource:AppName`.
</Note>

## Layout de partes

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

Marque as partes com `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>
```

### Comportamento de instalação

* Console em `en-US` → instala 1005 e 1008.
* Console em `en-GB` → faz fallback para `en-US` → instala 1005 e 1008.
* Partes sem marcação são sempre instaladas.

### Teste com xbapp

* `/Languages` — instala para os idiomas listados, independentemente da configuração do console.
* `/AllChunks` — instala o pacote inteiro.
* `/w` — mantém a conexão aberta após a instalação.

## Veja também

* [Localização do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Localization)
* [Intelligent Delivery](/pt-BR/build/core-features/common/packaging/intelligentdelivery-features-recipes)

## Documentação de API relacionada

* [Referência da API XPackage](/pt-BR/reference/system/xpackage/xpackage_members) — montar/enumerar partes localizadas do pacote
* [Referência de elementos do MicrosoftGame.config](/pt-BR/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) — declarações de recursos + partes


## Related topics

- [Localização do MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Visão geral de localização e globalização](/pt-BR/build/game-principles/localization.md)
- [Determinação da localização do console](/pt-BR/build/game-principles/localization/determining-console-geolocation.md)
- [Intelligent Delivery: recursos e receitas](/pt-BR/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)
- [D3D12_TILED_RESOURCE_COORDINATE](/pt-BR/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public.md)