MicrosoftGame.config 中引用的字符串与图片可以根据用户区域设置进行本地化。Visual Studio 2019+ 会自动生成一个 resources.pri 文件,操作系统会在运行时读取它。
在 GDK 命令行提示符中导出该文件:
本地化应用名称与描述
添加默认字符串
- 在解决方案资源管理器中右键单击你的项目,添加一个名为
Strings的新筛选器。 - 右键单击
Strings,添加一个新建项 > 程序集资源文件 (.resx)。VS 会在包根目录下创建resources.resx。
GDK 要求使用
.resw。将 resources.resx 重命名为 resources.resw。在 MicrosoftGame.config 中引用字符串
为每种语言添加字符串
为每种受支持的语言创建一个Strings/<lang> 筛选器,在每个筛选器下添加一个程序集资源文件,将项类型设置为 PRI Resource,并将其重命名为 .resw。
在 MicrosoftGame.config 中声明语言
zh-SG 和 zh-CN 作为回退。
添加可本地化的图片
Logo、SmallLogo、SplashScreen、StoreLogo 都可以本地化:
- 在一个共享文件夹(如
Images)下按语言创建子文件夹。 - 添加图片,项类型 = Image,内容 = Yes。
- 在根目录下提供默认图片作为回退。
至少包含一个图片资源。否则本地化字符串将无法解析,游戏名称会显示为
ms-resource:AppName。区块布局
Intelligent Delivery
使用Languages 标记区块:
安装行为
- 主机为
en-US→ 安装 1005 和 1008。 - 主机为
en-GB→ 回退到en-US→ 安装 1005 和 1008。 - 未标记的区块始终会安装。
使用 xbapp 测试
/Languages—— 无论主机设置如何,都为列出的语言进行安装。/AllChunks—— 安装整个包。/w—— 安装完成后保持连接。
另请参阅
相关 API 文档
- XPackage API reference —— 挂载/枚举本地化的包区块
- MicrosoftGame.config elements reference —— 资源 + 区块声明
