MUI (локализация)

MUI встроена в Windows и используется приложениями путем хранения локализуемых ресурсов в языковом файле и загрузки их через MUI API во время выполнения^[1].

Один из простейших способов интеграции MUI — размещение строк каждого языка в ресурсе string-table исполняемого файла программы с использованием Win32-функции LoadString для загрузки строк в ходе работы. Для этого не требуется дополнительная конфигурация, другие возможности MUI по желанию:

• Хранить ресурсы каждого языка в отдельной DLL — для гибкости установки
• Управлять потреблением локализуемых данных, например использовать язык, отличный от системного, через MUI API
• Хранить локализуемые данные не как ресурсы, а в других форматах.

Дизайн MUI предоставляет стандартный способ хранения данных локализации и преодолевает ограничения традиционных монолитных подходов (все языки в файлах ресурсов). С использованием MUI возможны такие сценарии развертывания:

• Добавление поддержки нового языка только установкой языкового пакета — без правки логики приложения и других языковых файлов
• Добавление функций и исправлений — обновлением только кода приложения, без необходимости вносить изменения в переводы.

Термины, связанные с MUI, используются и определяются в документации Microsoft:^[2]

• Языково-независимый (LN): элемент, смысл которого не зависит от языка, например изображение без текста или иных локализуемых компонентов.
• LN-ресурс: ресурс, общий для всех языковых версий приложения.
• LN-файл: Windows-бинарник, содержащий логику приложения и языково-независимые ресурсы.
• Языково-специфичный (LS): компонент, различающийся для разных языков. Обычно это строки интерфейса или изображения с текстом.
• LS-файл ресурсов: набор ресурсов для одного языка (файл MUI).

Языковой выбор сохраняется отдельно для системы в целом (он применяется для всех пользователей и становится дефолтным для новых), а также индивидуально для каждого пользователя. Пользователь может изменить эти предпочтения через Панель управления, но сами приложения этого сделать не могут.

Языковые предпочтения определяют язык интерфейса ОС и могут учитываться приложениями, особенно при использовании функций Windows с поддержкой MUI (например, LoadString) — тогда язык подбирается автоматически, без MUI-специфичного кода. Использование этих предпочтений опционально: приложение может их игнорировать или обрабатывать самостоятельно.

Приложение может использовать MUI-функции^[3] для получения списка языков (обычно — предпочтения пользователя) на разных уровнях: системном, пользовательском, для процесса и отдельного потока (приоритет уровней — от общего к частному).

Приложение может изменять язык текущего потока (например, через SetThreadPreferredUILanguages):

LPCWSTR languageIdSpec = L"en-US\0";
ULONG langCount = 1;
if (!SetThreadPreferredUILanguages(MUI_LANGUAGE_NAME, languageIdSpec, &langCount))
    MessageBoxW(NULL, L"Unable to set thread preferred UI language.", NULL, MB_ICONERROR);

MUI поддерживает хранение локализованных ресурсов в форматах бинарных файлов Windows (EXE, DLL, SYS), как правило — в DLL.

Ресурсы для каждого языка могут храниться как в основном файле приложения, так и в отдельном MUI-файле (LS) — для каждого языка свой файл. Чтобы MUI смогла их найти, MUI-файл должен лежать в той же папке, что и связанный LN-файл, и называться по шаблону <имя LN-файла>.<LCID>.mui (например: my-lib.dll.0409.mui для en-US).

Строковые ресурсы определяются как таблицы строк:

LANGUAGE LANG_ENGLISH, SUBLANG_NEUTRAL
STRINGTABLE
BEGIN
1 L"текст сообщения"
END

Чтение локализованных ресурсов поддерживается несколькими функциями Win32, в том числе LoadString, FormatMessage и LoadImage^[4].

При вызове эти функции поочередно пытаются загрузить ресурс на выбранном языке (согласно глобальным языковым предпочтениям) из ресурсов приложения либо из соответствующих MUI-файлов (LN+LCID.mui). Если по каким-то причинам невозможно получить ресурс на первом языке из списка (нет файла или отсутствует сам ресурс), пробуются следующие предпочтения, пока не будет либо найден ресурс, либо исчерпан список. Если ничего не найдено — обращение к LN-файлу.

Наиболее часто используется функция LoadString, возвращающая указатель на строку из string-table:

wchar_t *resourceCharArray;
int resourceLength = LoadStringW(moduleHandle, resourceId, (LPWSTR)&resourceCharArray, 0);
if (!resourceLength)
{
    MessageBoxW(NULL, L"Unable to find resource.", NULL, MB_ICONERROR);
    return -1;
}

wchar_t *text = (LPWSTR)malloc((resourceLength + 1) * sizeof(wchar_t));
wcsncpy(text, resourceCharArray, resourceLength);
text[resourceLength] = L'\0'; // завершение строкового буфера нулём

Загрузка ресурса может возвращать указатель на массив символов без автоматического добавления нулевого символа-окончания. Для «безопасного» копирования в новый буфер требуется добавить завершающий нуль вручную.

FormatMessage также поддерживает MUI: если параметр dwLanguageId равен 0, выбирается язык пользователя. Однако функция работает с message-table, которая редко используется на практике^[5].

Microsoft рекомендует хранить UI-ресурсы в виде ресурсов, так как MUI полностью поддерживает их извлечение. Однако поддерживаются и другие форматы — XML, JSON, текстовые файлы. Это означает, что фреймворк загрузки ресурсов MUI не обязателен: приложение может реализовывать собственную логику поиска и извлечения UI-данных, при этом считаться MUI-совместимым, если оно использует системные языковые предпочтения. Также возможно использовать функцию GetFileMUIPath для поиска MUI-файлов по стандарту имени/расположения^[6].

Документация по MUI описывает также:

• Файл конфигурации ресурсов^[7]
• Редирект строк реестра^[8]

Базовая поддержка MUI в приложении включает:

• Использование LoadString и аналогичных функций для загрузки локализованных ресурсов с учётом языковых настроек системы/пользователя
• Создание исходных файлов ресурсов для каждого языка (рекомендуется отдельный ресурсный файл для каждого)

После этого приложение считается совместимым с MUI. Для получения дополнительных преимуществ MUI:

• Локализованные строки выносятся из логики программы
• Локализация хранится в языковых пакетах по отдельным языкам или в LIP/LXP, размещённых в одной папке с бинарными файлами приложения

Если данные хранятся не как ресурсы, приложение самостоятельно реализует механизм загрузки UI на основе языковых предпочтений (например, через GetThreadUILanguage). Можно использовать стандартные пути/имена MUI-файлов при помощи GetFileMUIPath.

MUI создавалась как развитие и альтернатива технологии статической локализации — устаревшего подхода к интернационализации и распространению программ.

Локализация через языковой пакет (Language Pack) и статическая локализация достигают одинаковой цели — отображение интерфейса на целевом языке. Однако только «локализованная версия» ОС предоставляет переводы имён системных папок (например, «Документы», «Загрузки»), а не пользовательских файлов и папок^[9].

Языковой пакет в Windows переводит базовую ОС и все приложения с поддержкой MUI на выбранный язык. В классических локализованных версиях Windows пользовательский интерфейс полностью переведён и обновляется при апгрейде, чего не всегда достигают MUI-пакеты^[9].

Языковые пакеты не переводят административные данные, например содержимое реестра и элементы Microsoft Management Console.

Одно из преимуществ MUI — каждый пользователь Windows может установить свой язык интерфейса системы и программ, чего нельзя добиться с помощью статической локализации. Также ОС, локализованная через Language Pack, поддерживает использование приложений, локализованных с помощью других языковых пакетов.

Технология MUI появилась в Windows 2000 и поддерживается во всех последующих версиях Windows.

В этих версиях языковые пакеты и MUI распространялись корпорацией Microsoft только по корпоративным лицензиям. В рознице они не продавались, однако некоторые OEM-производители комплектовали свою продукцию MUI^[9].

В Windows 2000 и Windows XP языковые пакеты заменяют встроенные строки интерфейса (обычно на американском английском). Всего для данных ОС доступно 5 наборов языков:

Набор 1

Набор 2

Набор 3

Набор 4

Набор 5

В Windows Vista протокол MUI был обновлён: языковые ресурсы вынесены из логики приложения (LN-файл), что позволило совершать полноценное переключение языков интерфейса. Языковые пакеты стали распространяться как Language Packs, устанавливаемые независимо от кода приложения.

Языковые пакеты доступны для редакций Windows Vista Enterprise и как дополнительный компонент для Windows Vista Ultimate.

Начиная с Vista, MUI-API стали доступны сторонним разработчикам для создания программ с поддержкой MUI.

Изначально были доступны 16 языковых пакетов:

23 октября 2007 года вышли ещё 19 языковых пакетов:

Языковые пакеты доступны для Windows 7 Enterprise и Windows 7 Ultimate, а также Windows Phone 7.

Впервые введён формат Language Interface Pack (LIP), обеспечивающий частичные переводы на языки, для которых нет полных Language Pack^[10].

На запуске доступны следующие 15 языковых пакетов^[11] (китайский для Гонконга отсутствует на мобильных):

31 октября 2009 года вышли ещё 22 языковых пакета (многие недоступны для мобильных версий):

При запуске только 6 языков поддерживались системой:

С выходом Windows Phone 7.5 (27 сентября 2011 года) добавлены ещё 20 языков (турецкий и украинский поддерживаются только с Windows Phone 8)^[12]. Первые LIP для Windows Phone 7 — индонезийский и малайский (Tango-обновление)^[13].

Начиная с Windows 8/RT почти все редакции Windows позволяют скачивать и устанавливать языковые пакеты и LIP^[14], за некоторыми исключениями:

• В редакциях типа Single Language разрешена установка только одного Language Pack^[15], как и в обычных версиях Windows 7 и ранее.
• В OEM-версиях Windows перечень предустановленных и загружаемых LIP зависит от производителя оборудования и страны (или мобильного оператора, для устройств с SIM-картой). Возможна предустановка нескольких языков на устройстве, при этом фактические ограничения задаются производителем. С Windows 8 (и Phone 8) эта модель применяется к ПК и телефонам, позже она была изменена в Windows 10 версии 1803 и возвращена в 1809. Пользователь может выполнить «чистую» установку через Media Creation Tool и обойти привязку по региону, установив любой язык.

• • Обновления Windows не затрагивают текущие языки системы, но при крупном обновлении система может сбросить язык по умолчанию.
  • Некоторые языки поддерживаются только на Xbox/Surface Duo.
  • Часть LIP требует наличия соответствующего Language Pack^[16].

В Windows 10 начиная с версии 1803 LIP постепенно заменяются на Local Experience Pack (LXP)^[17]. Помимо установки через настройки Windows, LXPs доступны и через Microsoft Store^[18], что позволяет удалённую установку языков для домашних версий^[19].

Список поддерживаемых языков зависит от версии операционной системы. (См. оригинальную таблицу MUI и LIP с отметками поддерживаемости по версиям Windows.)

Технология MUI защищена международным патентом «Multilingual User Interface for an Operating System». Изобретатели: Бьёрн С. Реттиг, Эдвард С. Миллер, Грегори Вилсон и Шан Сюй^[20].