I18N国际化

必要配置

需要以下配置进行启用

• Tools.Config.props文件中<AutoGenerateI18N>为true
• 项目文件中创建Strings文件夹,其中包含各个语言文件

  - 📁Strings
    - 📁zh-cn
      - 🗒️Resources.resw
    - 📁en-us
      - 🗒️Resources.resw

  其中Resources.resw文件与在WinUI3项目中使用方法一致

生成

在必要配置之后,生成一次项目

会自动生成以下类:

• {项目命名空间}.I18n
  • ResourcesHelper 读取本地化的帮助类
  • I18N 直接返回本地化字符串的帮助类
  • ResourceKey 从resw文件自动生成的键值
  • LocaleExtension 用于xaml的本地化帮助类

ResourcesHelper

示例用法

// 使用resw中Download的值
string downloadStr = ResourcesHelper.GetString(ResourceKey.Download);

I18N

示例用法

// 使用resw中Download的值
string downloadStr = I18N.Download;

说明

I18N.Download与ResourcesHelper.GetString(ResourceKey.Download)等效

LocaleExtension

示例用法

xaml文件顶部引用命名空间

xmlns:ex="using:ShadowViewer.I18n"

<TextBlock Text="{ex:Locale Key=Download}" />