Skip to main content
MicrosoftGame.config에서 참조하는 문자열과 이미지는 사용자 로케일에 맞게 현지화할 수 있습니다. Visual Studio 2019+는 런타임에 OS가 조회하는 resources.pri 파일을 자동 생성합니다. GDK 커맨드 프롬프트에서 파일을 덤프합니다:

앱 이름 및 설명 현지화

기본 문자열 추가

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

MicrosoftGame.config에서 문자열 참조

언어별 문자열 추가

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

MicrosoftGame.config에서 언어 선언

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

현지화 가능한 이미지 추가

Logo, SmallLogo, SplashScreen, StoreLogo는 현지화할 수 있습니다:
  1. 공유 폴더(예: Images) 아래에 언어별 하위 폴더를 추가합니다.
  2. 이미지를 추가하고 Item Type = Image, Content = Yes로 설정합니다.
  3. 폴백용으로 루트에 기본 이미지를 제공합니다.
최소 하나 이상의 이미지 리소스를 포함하세요. 그렇지 않으면 현지화된 문자열이 해석되지 않고, 타이틀 이름이 ms-resource:AppName으로 표시됩니다.

청크 레이아웃

Intelligent Delivery

청크에 Languages를 태그로 지정합니다:

설치 동작

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

xbapp을 이용한 테스트

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

참고

관련 API 문서

마지막 수정일 2026년 8월 6일