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

# 패키지된 리소스의 현지화

> MicrosoftGame.config, 청크 레이아웃, 로케일별 다운로드를 위한 Intelligent Delivery를 사용하여 GDK 패키지의 문자열, 이미지, 에셋을 현지화합니다.

`MicrosoftGame.config`에서 참조하는 문자열과 이미지는 사용자 로케일에 맞게 현지화할 수 있습니다. Visual Studio 2019+는 런타임에 OS가 조회하는 `resources.pri` 파일을 자동 생성합니다.

GDK 커맨드 프롬프트에서 파일을 덤프합니다:

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

## 앱 이름 및 설명 현지화

### 기본 문자열 추가

1. Solution Explorer에서 프로젝트를 우클릭하고 `Strings`라는 이름의 **New Filter**를 추가합니다.
2. `Strings`를 우클릭하고 **New Item > Assembly Resource File (.resx)** 를 추가합니다. Visual Studio가 패키지 루트에 `resources.resx`를 생성합니다.

<Note>
  GDK는 `.resw`를 요구합니다. `resources.resx`의 이름을 `resources.resw`로 변경하세요.
</Note>

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

### 언어별 문자열 추가

지원하는 각 언어마다 `Strings/<lang>` 필터를 만들고, 그 아래에 Assembly Resource File을 추가한 뒤 **Item Type** = **PRI Resource**로 설정하고, 이름을 `.resw`로 변경합니다.

### MicrosoftGame.config에서 언어 선언

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

번체 중국어(Traditional Chinese)를 지원하려면 폴백을 위해 `zh-SG`와 `zh-CN`도 함께 나열합니다.

## 현지화 가능한 이미지 추가

`Logo`, `SmallLogo`, `SplashScreen`, `StoreLogo`는 현지화할 수 있습니다:

1. 공유 폴더(예: `Images`) 아래에 언어별 하위 폴더를 추가합니다.
2. 이미지를 추가하고 **Item Type** = **Image**, **Content** = **Yes**로 설정합니다.
3. 폴백용으로 루트에 기본 이미지를 제공합니다.

<Note>
  최소 하나 이상의 이미지 리소스를 포함하세요. 그렇지 않으면 현지화된 문자열이 해석되지 않고, 타이틀 이름이 `ms-resource:AppName`으로 표시됩니다.
</Note>

## 청크 레이아웃

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

청크에 `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>
```

### 설치 동작

* 콘솔이 `en-US` → 1005 및 1008을 설치합니다.
* 콘솔이 `en-GB` → `en-US`로 폴백하여 1005 및 1008을 설치합니다.
* 태그가 없는 청크는 항상 설치됩니다.

### xbapp을 이용한 테스트

* `/Languages` — 콘솔 설정과 무관하게 나열된 언어에 대해 설치합니다.
* `/AllChunks` — 전체 패키지를 설치합니다.
* `/w` — 설치 후 연결을 유지합니다.

## 참고

* [MicrosoftGame.config 현지화](/build/core-features/common/game-config/MicrosoftGameConfig-Localization)
* [Intelligent Delivery](/build/core-features/common/packaging/intelligentdelivery-features-recipes)

## 관련 API 문서

* [XPackage API 레퍼런스](/reference/system/xpackage/xpackage_members) — 현지화된 패키지 청크 마운트/열거
* [MicrosoftGame.config 요소 레퍼런스](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc) — 리소스 + 청크 선언


## Related topics

- [현지화 및 국제화 개요](/ko/build/game-principles/localization.md)
- [플레이어에게 추가 기능 콘텐츠 액세스 부여](/ko/publishing/xstore-commerce/xstore-granting-access.md)
- [게임에서 지원 및 지원하지 않는 로케일](/ko/build/game-principles/localization/game-supported-and-unsupported-locales.md)
- [패키징 개요](/ko/build/core-features/common/packaging/overviews/packaging.md)
- [콘솔 로케일 및 언어 확인](/ko/build/game-principles/localization/determining-console-locale.md)