> ## 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 지역화

> MicrosoftGame.config 지역화

이 항목에서는 패키지된 게임의 표시 문자열을 지역화하여 셸에서 문자열의 적절한 지역화 버전이 표시되도록 하는 방법을 설명합니다. 이러한 단계는 Microsoft Docs의 [Windows 10 리소스 관리 시스템을 레거시 앱 또는 게임에서 사용](https://learn.microsoft.com/windows/uwp/app-resources/using-mrt-for-converted-desktop-apps-and-games) 문서와 관련이 있습니다. 이 항목에서 다루지 않는 시나리오나 자세한 내용은 해당 문서를 참조할 수 있습니다.

<Note>[앞서 언급한 문서](https://learn.microsoft.com/windows/uwp/app-resources/using-mrt-for-converted-desktop-apps-and-games)에는 매니페스트 파일 내에서 문자열 자산이 다음과 같이 참조되는 것으로 설명된 버그가 하나 있습니다.</Note>

```
    ms-resource:Resources/ApplicationDisplayName  
```

<Note>실제 참조는 다음과 같이 작동합니다(`Resources/`가 생략된 점에 유의).</Note>

```
    ms-resource:ApplicationDisplayName  
```

## 게임에 지역화된 셸 비주얼 포함

패키징을 시작하면 다음과 같은 섹션이 있는 *MicrosoftGame.config* 파일이 있으며, 이는 특성에 포함된 표시할 텍스트 콘텐츠를 지정합니다.
`OverrideDisplayName="My Game's Display Name"`.

```xml theme={null}

  <ExecutableList>
    <Executable Name="MyGame.exe"
                OverrideDisplayName="My Game's Display Name"
                Id="Game"/>
  </ExecutableList>

  <ShellVisuals DefaultDisplayName="PackageName"
                PublisherDisplayName="Publisher Display name"
                StoreLogo="Storelogo.png"
                Square150x150Logo="Logo.png"
                Square44x44Logo="SmallLogo.png"
                Description="My App Description"
                BackgroundColor="#000040"
                SplashScreenImage="SplashScreen.png"/>  
```

이러한 문자열의 여러 지역화 버전을 허용하려면, 지원할 언어와 연결된 애플리케이션의 개별 하위 폴더에 .resw 파일을 만들어 그렇게 할 수 있습니다.

1. *resources.resw*라는 XML 파일을 만들어 프로젝트의 *Strings* 하위 폴더에 배치합니다. 이는 프로젝트에 대한 언어 중립적 폴백이 됩니다.
2. 각 언어에 대해 프로젝트에 새 *Strings* 하위 폴더를 만듭니다. 예를 들어 영어의 경우 *Strings\en-us*, 멕시코에서 사용되는 스페인어의 경우 *Strings\es-mx*입니다. 언어별로 적절한 [BCP-47](https://tools.ietf.org/html/bcp47) 코드를 사용해야 합니다.
3. 각 XML 파일에 다음 콘텐츠를 추가합니다. 강조 표시된 텍스트는 앱에 적절한 언어로 대체되어야 합니다. 다음 예에서는 간단한 접미사로 `(English)`를 사용하는 것을 보여 줍니다.

```xml theme={null}
    <?xml version="1.0" encoding="utf-8"?>
    <root>
        <data name="ApplicationDescription">
            <value>Contoso Demo app with localized resources (English)</value>
        </data>
        <data name="ApplicationDisplayName">
            <value>Contoso Demo Sample (English)</value>
        </data>
    </root>
```

다음으로, `OverrideDisplayName` 및 `Description` 속성에 다음과 같이 표시된 대로 `ms-resource:ResourceStringName` 구문을 사용하여 이러한 리소스 문자열을 참조하도록 *MicrosoftGame.config* 파일을 업데이트해야 합니다.

```xml theme={null}
<ExecutableList>
    <Executable Name="MyGame.exe"
              OverrideDisplayName="ms-resource:ApplicationDisplayName"
              Id="Game"/>
</ExecutableList>

<ShellVisuals DefaultDisplayName="PackageName"
              PublisherDisplayName="Publisher Display name"
              StoreLogo="Storelogo.png"
              Square150x150Logo="Logo.png"
              Square44x44Logo="SmallLogo.png"
              Description="ms-resource:ApplicationDescription"
              BackgroundColor="#000040"
              SplashScreenImage="SplashScreen.png"/>
```

다음으로, *MicrosoftGame.config* 파일에 애플리케이션이 지원하는 지역화 대상 목록이 포함되어 있는지 확인합니다. 예를 들어, 앱이 미국 영어와 멕시코 스페인어를 지원하는 경우 .config 파일에는 `Game`의 자식 요소로 다음이 있습니다.

```xml theme={null}
<Resources>
    <Resource Language="en-US" />
    <Resource Language="es-MX" />
</Resources>
```

다음으로, [makepkg localize](/build/core-features/common/packaging/deployment/makepkg) 명령을 사용하여 이러한 지역화된 자산 문자열을 포함하는 *Resource.pri* 파일을 생성합니다. 결과 *Resources.pri* 파일을 게임의 루트 콘텐츠 디렉터리에 배치합니다.

1. 게임의 루트 콘텐츠 디렉터리에서 Microsoft Game Development Kit(GDK) 게이밍 명령 프롬프트를 엽니다.
2. 다음을 실행합니다.

```
    makepkg localize /d . /resw Strings
```

디렉터리 구조가 이 예제와 일치하지 않거나 추가 확인이 필요한 경우 추가 매개 변수와 함께 `makepkg localize`를 실행할 수 있습니다.

* `/resw`를 사용하여 .resw 파일을 찾기 위한 루트에 대한 상대 경로를 지정합니다.
* 기본 루트 디렉터리가 아닌 위치에 결과 *Resources.pri* 파일을 저장하려면 디렉터리와 함께 `/pd`를 사용합니다. 대상 디렉터리가 이미 존재해야 합니다.
* 리소스를 XML 파일로 내보내기 위한 위치를 지정하려면 디렉터리 이름과 함께 `/t`를 사용합니다. 이 파일은 수동으로 확인하여 적절한 리소스가 포함되어 있는지 확인할 수 있습니다.

예:

```
    makepkg localize /d . /resw Resources /pd ..\FinalLooseFolder /t ..\TempOutput
```

이제 게임의 루트 콘텐츠 디렉터리에 *resources.pri* 파일이 있으므로 평소대로 패키지를 만들 수 있습니다.

마지막으로, 시스템이 영어 또는 멕시코 스페인어로 설정된 상태에서 설치할 때 지역화된 문자열이 시작 메뉴 및 앱의 문자열을 표시하는 다른 시스템 페이지에 표시되는지 확인합니다. Microsoft Store 앱 내의 아이콘은 앱 패키지의 정보가 아니라 파트너 센터에 업로드된 데이터에서 제공된다는 점에 유의하세요.

## 참고 항목

[MicrosoftGame.config](/build/core-features/common/game-config/MicrosoftGameConfig-toc)
[MicrosoftGame.config 개요](/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
[MicrosoftGame.config 편집기](/build/core-features/common/game-config/MicrosoftGameConfig-Editor)
[MicrosoftGame.config 참조(샘플 MicrosoftGame.config 및 스키마)](/reference/system/microsoftgameconfig/microsoftgameconfig-schema)
[패키징 개요](/build/core-features/common/packaging/overviews/packaging)


## Related topics

- [MicrosoftGame.config](/ko/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)
- [MicrosoftGame.config 개요](/ko/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
- [MicrosoftGame.config 편집기 및 참조](/ko/build/core-features/common/game-config/index.md)
- [Intelligent Delivery: features와 recipes](/ko/build/core-features/common/packaging/intelligentdelivery-features-recipes.md)
- [Make package (makepkg.exe)](/ko/build/core-features/common/packaging/deployment/makepkg.md)