MicrosoftGame.config 지역화

이 항목에서는 패키지된 게임의 표시 문자열을 지역화하여 셸에서 문자열의 적절한 지역화 버전이 표시되도록 하는 방법을 설명합니다. 이러한 단계는 Microsoft Docs의 Windows 10 리소스 관리 시스템을 레거시 앱 또는 게임에서 사용 문서와 관련이 있습니다. 이 항목에서 다루지 않는 시나리오나 자세한 내용은 해당 문서를 참조할 수 있습니다.

앞서 언급한 문서에는 매니페스트 파일 내에서 문자열 자산이 다음과 같이 참조되는 것으로 설명된 버그가 하나 있습니다.

    ms-resource:Resources/ApplicationDisplayName

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

    ms-resource:ApplicationDisplayName

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

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

  <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 파일을 만들어 그렇게 할 수 있습니다.

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

    <?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 파일을 업데이트해야 합니다.

<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의 자식 요소로 다음이 있습니다.

<Resources>
    <Resource Language="en-US" />
    <Resource Language="es-MX" />
</Resources>

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

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

    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 MicrosoftGame.config 개요 MicrosoftGame.config 편집기 MicrosoftGame.config 참조(샘플 MicrosoftGame.config 및 스키마) 패키징 개요

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

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

참고 항목

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

​참고 항목

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

참고 항목