MicrosoftGame.config에서 참조하는 문자열과 이미지는 사용자 로케일에 맞게 현지화할 수 있습니다. Visual Studio 2019+는 런타임에 OS가 조회하는 resources.pri 파일을 자동 생성합니다.
GDK 커맨드 프롬프트에서 파일을 덤프합니다:
앱 이름 및 설명 현지화
기본 문자열 추가
- Solution Explorer에서 프로젝트를 우클릭하고
Strings라는 이름의 New Filter를 추가합니다. 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에서 언어 선언
zh-SG와 zh-CN도 함께 나열합니다.
현지화 가능한 이미지 추가
Logo, SmallLogo, SplashScreen, StoreLogo는 현지화할 수 있습니다:
- 공유 폴더(예:
Images) 아래에 언어별 하위 폴더를 추가합니다. - 이미지를 추가하고 Item Type = Image, Content = Yes로 설정합니다.
- 폴백용으로 루트에 기본 이미지를 제공합니다.
최소 하나 이상의 이미지 리소스를 포함하세요. 그렇지 않으면 현지화된 문자열이 해석되지 않고, 타이틀 이름이
ms-resource:AppName으로 표시됩니다.청크 레이아웃
Intelligent Delivery
청크에Languages를 태그로 지정합니다:
설치 동작
- 콘솔이
en-US→ 1005 및 1008을 설치합니다. - 콘솔이
en-GB→en-US로 폴백하여 1005 및 1008을 설치합니다. - 태그가 없는 청크는 항상 설치됩니다.
xbapp을 이용한 테스트
/Languages— 콘솔 설정과 무관하게 나열된 언어에 대해 설치합니다./AllChunks— 전체 패키지를 설치합니다./w— 설치 후 연결을 유지합니다.
참고
관련 API 문서
- XPackage API 레퍼런스 — 현지화된 패키지 청크 마운트/열거
- MicrosoftGame.config 요소 레퍼런스 — 리소스 + 청크 선언
