WinUI 3 полностью поддерживает интернационализацию. Тем не менее, самый надежный способ на данный момент — перезапустить приложение после смены языка, чтобы обеспечить корректное отображение. Хотя технически можно динамически обновлять язык интерфейса без перезапуска, его реализация становится крайне сложной. Я потратил много времени на устранение неполадок и неоднократно сталкивался с искаженным текстом или аварийным завершением приложения при смене языка. После многочисленных проб и исправлений я разработал стабильный рабочий процесс интернационализации для WinUI 3, который подробно опишу ниже.
Сначала добавьте логику инициализации языка в код позади файла App.xaml.cs. Если пользователь не выбрал собственный язык, приложение использует язык операционной системы. Если системный язык отсутствует в списке поддерживаемых, приложение переключается на английский.
protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
const string LangSettingKey = "AppLanguageCode";
// All supported language tags of project
List<string> supportLangs = new() { "zh-CN", "en-US", "th-TH" };
string finalLang = "en-US"; // Default language
try
{
var localSetting = ApplicationData.Current.LocalSettings;
// ① Use saved language if local configuration exists
if (localSetting.Values.TryGetValue(LangSettingKey, out var savedVal))
{
finalLang = NormalizeLang(savedVal?.ToString() ?? "");
}
else
{
// ② No saved config: read system primary preferred language
string sysLang = ApplicationLanguages.Languages.FirstOrDefault() ?? "";
sysLang = NormalizeLang(sysLang);
// ③ Use system language if supported, otherwise fall back to English
finalLang = supportLangs.Contains(sysLang) ? sysLang : "en-US";
}
}
catch
{
// Ignore exception when running unpackaged, ApplicationData unavailable
}
ApplicationLanguages.PrimaryLanguageOverride = finalLang;
_window = new MainWindow();
_window.Activate();
}
/// <summary>
/// Standardize culture code: map system returned zh-Hans-CN to zh-CN
/// </summary>
private static string NormalizeLang(string lang)
{
if (string.IsNullOrEmpty(lang)) return lang;
return lang switch
{
"zh-Hans-CN" => "zh-CN",
"zh-Hant-TW" => "zh-TW", // For future Traditional Chinese support
_ => lang
};
}Code language: PHP (php)Эту конфигурацию можно дополнительно оптимизировать. Чтобы код оставался чистым, не прописывайте список поддерживаемых языков напрямую здесь. Поместите его в статический вспомогательный класс, чтобы повторно использовать этот список во всех местах, где требуется управление языковыми параметрами.
public class Languages
{
public static List<string> supportLangs = new() { "zh-CN", "en-US", "th-TH" };
}Code language: PHP (php)Основная задача приведенного блока кода — настроить язык при запуске приложения: сначала загружается сохраненная языковая настройка пользователя, при отсутствии пользовательских параметров используется системный язык, а английский выступает в качестве последнего запасного варианта.
Создание отдельной страницы для смены языка
Нам нужен отдельный интерфейс, чтобы пользователи могли изменять язык отображения, поэтому я создал независимую страницу исключительно для настроек языка.
<?xml version="1.0" encoding="utf-8"?>
<Page
x:Class="ThaiTong.Pages.LanguageSettingPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:ThaiTong.Pages"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"
mc:Ignorable="d">
<StackPanel Padding="20" Spacing="24">
<TextBlock x:Uid="Txt_LangTip" FontSize="22"/>
<ComboBox x:Name="cbLangSelect" Width="320" Height="40" CornerRadius="6">
<ComboBoxItem Tag="zh-CN" Content="简体中文"/>
<ComboBoxItem Tag="en-US" Content="English"/>
<ComboBoxItem Tag="th-TH" Content="ภาษาไทย"/>
</ComboBox>
<StackPanel Orientation="Horizontal" Spacing="12">
<Button x:Name="btnSave" x:Uid="Btn_Save" Content="Save" Click="BtnSave_Click" Width="120" Height="38" CornerRadius="5"/>
</StackPanel>
<TextBlock Foreground="Gray" Text="Note: After saving, page will refresh to apply language."/>
</StackPanel>
</Page>
Соответствующий код C# на стороне сервера приведен ниже:
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using Microsoft.UI.Xaml.Controls.Primitives;
using Microsoft.UI.Xaml.Data;
using Microsoft.UI.Xaml.Input;
using Microsoft.UI.Xaml.Media;
using Microsoft.UI.Xaml.Navigation;
using Microsoft.Windows.ApplicationModel.Resources;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Runtime.InteropServices.WindowsRuntime;
using ThaiTong.Common;
using Windows.Foundation;
using Windows.Foundation.Collections;
using Windows.Globalization;
using Windows.Storage;
// To learn more about WinUI, the WinUI project structure,
// and more about our project templates, see: http://aka.ms/winui-project-info.
namespace ThaiTong.Pages
{
/// <summary>
/// An empty page that can be used on its own or navigated to within a Frame.
/// </summary>
public sealed partial class LanguageSettingPage : Page
{
private const string LangSettingKey = "AppLanguageCode";
private string _currentLang;
private readonly ResourceLoader _resLoader;
public LanguageSettingPage()
{
InitializeComponent();
_resLoader = new ResourceLoader();
var setting = ApplicationData.Current.LocalSettings;
if (setting.Values.TryGetValue(LangSettingKey, out var saveLang))
{
_currentLang = saveLang.ToString();
}
else
{
string sysLang = ApplicationLanguages.Languages.FirstOrDefault() ?? "";
_currentLang = Languages.supportLangs.Contains(sysLang) ? sysLang : "en-US";
}
// Pre-select matched language in dropdown list
foreach (var item in cbLangSelect.Items)
{
if (item is ComboBoxItem cbi && cbi.Tag.ToString() == _currentLang)
{
cbLangSelect.SelectedItem = item;
break;
}
}
}
// Save selected language setting
private async void BtnSave_Click(object sender, RoutedEventArgs e)
{
if (cbLangSelect.SelectedItem is not ComboBoxItem selectItem) return;
string newLang = selectItem.Tag.ToString();
if (_currentLang == newLang) return;
ApplicationData.Current.LocalSettings.Values[LangSettingKey] = newLang;
_currentLang = newLang;
ApplicationLanguages.PrimaryLanguageOverride = newLang;
// Load localized text from resw resource file
ContentDialog tipDialog = new ContentDialog()
{
XamlRoot = this.XamlRoot,
Title = _resLoader.GetString("Dlg_LangChange_Title"),
Content = _resLoader.GetString("Dlg_LangChange_Content"),
CloseButtonText = _resLoader.GetString("Dlg_LangChange_BtnOk")
};
await tipDialog.ShowAsync();
}
}
}
Каждый раз, когда пользователь сохраняет новые языковые настройки, мы предлагаем перезапустить приложение, чтобы весь текст интерфейса обновился полностью.
Локализация в WinUI 3 разделена на две части: разметка в файлах XAML и чтение текста из серверного кода C#.
Для элементов XAML используйте атрибут x:Uid, как показано в примере:
<TextBlock x:Uid="Txt_LangTip" FontSize="22"/>Далее настроите структуру папок ресурсов локализации: создайте корневую папку Strings в проекте, затем добавьте вложенные папки с кодами культур, например en-US для американского английского. В каждой языковой папке разместите файл Resources.resw с парами «ключ-значение» для переводов.
<data name="Btn_Save.Content" xml:space="preserve">
<value>Сохранить</value>
</data>Поле name служит поисковым ключом. Суффикс .Content указывает на целевой свойство элемента управления. Ранее упомянутый элемент Txt_LangTip определяется следующим образом:
<data name="Txt_LangTip.Text" xml:space="preserve"><value>Выбрать язык приложения</value></data>Здесь мы добавляем .Text, так как обращаемся именно к свойству Text элемента TextBlock.
Для динамического текста в коде C# сначала инициализируйте экземпляр ResourceLoader:
private readonly ResourceLoader _resLoader;
public LanguageSettingPage()
{
InitializeComponent();
_resLoader = new ResourceLoader();После инициализации вы можете получать локализованные строки в любом месте кода с помощью метода GetString:
Title = _resLoader.GetString("Dlg_LangChange_Title"),