Реализация мультиязычности (i18n) мобильного приложения

Отметим: когда языков становится больше двух, прямолинейная локализация перестаёт работать: пропущенные строки, сломанные plurals, неправильное форматирование дат. Наша команда — 7+ лет опыта в мобильной разработке и более 30 проектов с мультиязычностью — знает, как спроектировать i18n-инфраструктуру, которая масштабируется без боли. Грамотная архитектура окупается на третьем языке: каждый следующий язык требует на 60% меньше усилий, а бюджет на переводы сокращается на 40–50%. Получите консультацию — мы оценим ваш проект.

Архитектура i18n: от простого к правильному

iOS

Стандарт — Localizable.strings + .stringsdict для plurals + XLIFF для обмена с переводчиками. String(localized:) API (Swift 5.5+) — предпочтительный способ, потому что поддерживает interpolation, plural rules и comment для переводчика в одном вызове:

let message = String(localized: "notifications.count \(count)",
                     comment: "Number of unread notifications in tab bar")

Для больших проектов с 1000+ строками — String Catalog (.xcstrings, Xcode 15+). Он заменяет разрозненные .strings файлы единым JSON-файлом с встроенным diff и предупреждениями о непереведённых строках. Apple рекомендует String Catalog для новых проектов.

Android

strings.xml в res/values/ (базовый) + res/values-{lang}/ для каждого языка. plurals в том же файле. Для параметрических строк — именованные аргументы:

<string name="welcome_user">Добро пожаловать, %1$s!</string>

%1$s вместо %s — обязательно при множественных аргументах, так как порядок слов в разных языках разный.

React Native

react-i18next — де-факто стандарт. Namespace-ы для разбивки по модулям, lazy loading для экономии трафика. Plural forms через i18next-icu с ICU Message Format — корректно обрабатывает русские, украинские, польские правила.

Flutter

flutter_localizations + intl пакет. ARB-файлы — стандарт. flutter gen-l10n генерирует type-safe Dart-классы, исключая опечатки:

Text(AppLocalizations.of(context)!.notificationCount(count))

Plural forms описываются в ARB через ICU syntax.

Сравнение подходов к i18n

Все платформы поддерживают автоматическую синхронизацию через TMS, что снижает ручной труд на 90%.

Динамическая смена языка

Системная локаль — не всегда то, что нужно. iOS поддерживает выбор языка через CFBundleLocalizations + хранение в UserDefaults. Android — AppCompatDelegate.setApplicationLocales() (AndroidX) или ручная замена Resources.updateConfiguration(). При смене языка пересоздавайте все форматтеры с новой locale.

Plural forms: сводная таблица

ICU Message Format обрабатывает все эти варианты автоматически. Ручное ветвление — антипаттерн.

Почему автоматизированное управление переводами лучше ручного?

Ручной экспорт/импорт XLIFF — основной источник ошибок. Автоматизированный пайплайн через TMS (Phrase, Lokalise, Crowdin) синхронизирует строки между кодом и переводчиками без файлового обмена. Экономия до 60% времени на каждом новом языке.

Как правильно организовать plural forms для сложных языков?

Используйте готовые решения фреймворка: iOS .stringsdict, Android plurals, Flutter ICU в ARB, React Native i18next-icu. Они берут на себя корректные правила для любых языков. Не пишите собственные switch — это сломается на польском (4 формы) или арабском (6).

CI/CD и качество переводов

Интегрируем проверки в пайплайн:

• Lint для строк: twine (iOS), android-strings-lint — находят пропущенные переводы, неиспользуемые ключи, неэкранированные спецсимволы
• Screenshot тесты: fastlane snapshot (iOS) или screengrab (Android) — автоматически делают скриншоты на всех языках, регрессию UI заметно сразу
• Translation Management System: Phrase, Lokalise, Crowdin — синхронизируют строки между кодом и командой переводчиков

Что вы получите в результате

• Документированная архитектура i18n под вашу платформу
• Готовая интеграция с TMS и автоматическая синхронизация
• Настроенный CI/CD пайплайн с линтерами и скриншот-тестами
• Обучение команды добавлению новых языков и работе с переводами

Процесс работы

1. Аудит текущей архитектуры и выявление болевых точек (2–3 часа)
2. Проектирование i18n-инфраструктуры под платформу (iOS, Android, Flutter, React Native)
3. Вынос всех строк в ресурсы с поддержкой plurals и интерполяции (1–2 дня на первый язык)
4. Интеграция TMS и настройка автоматической синхронизации (1 день)
5. Настройка CI/CD линтеров и скриншот-тестов для контроля переводов (1 день)
6. Обучение команды и документация (0.5 дня)

Сроки

Ориентировочные сроки: от 3 до 10 рабочих дней в зависимости от платформы, количества языков и готовой инфраструктуры. Стоимость рассчитывается индивидуально. Получите консультацию — мы оценим ваш проект.

Локализация мобильных приложений: i18n, RTL, динамическое переключение языка

При локализации приложений мы часто сталкиваемся с неочевидными ошибками: дата 04/05 для американца — это 5 апреля, для европейца — 4 мая. Сумма «1,000.50» в большинстве стран — тысяча с половиной, в Германии — один и пятьдесят сантов. Число слов для «1 файл», «3 файла», «5 файлов» в русском — три разные формы; арабский имеет шесть форм множественного числа. Если архитектура приложения не учитывает это с самого начала, локализация превращается в серию патчей. Наш 7-летний опыт в мобильной разработке и 50+ релизов в App Store и Google Play подтверждают: правильный i18n/l10n с первого коммита окупается многократно.

Как настроить базовую инфраструктуру локализации?

iOS: от Localizable.strings к String Catalogs

Исторически строки в iOS хранились в Localizable.strings — простой key=value формат. С Xcode 15 появились String Catalogs (.xcstrings) — JSON-based формат, который хранит все локали в одном файле, отображает статус перевода (переведено/устарело/отсутствует) и интегрирован с Xcode UI.

String(localized: "welcome_title") в Swift 5.7+ заменяет NSLocalizedString(...). Короче, типобезопаснее. String Interpolation в локализованных строках: String(localized: "items_count \(count)") с правилом плюрализации в .xcstrings — система автоматически выберет нужную форму для языка. Плюрализация через .stringsdict (старый подход) или прямо в String Catalog с NSStringPluralRuleType. Для русского нужно определить формы one (1 файл), few (3 файла), many (5 файлов), other (fallback). Пропустить few для русского — значит получить «5 файлов» там где должно быть «3 файлы». String Catalogs сокращают время настройки в два раза по сравнению со .stringsdict.

Android: XML resources и строковые форматы

res/values/strings.xml для базовой локали (en), res/values-ru/strings.xml для русского. Plural strings через <plurals> с <item quantity="one">, <item quantity="few">, <item quantity="many">. resources.getQuantityString(R.plurals.file_count, count, count) — первый count выбирает форму, второй подставляется в строку.

В Compose: stringResource(R.string.key) и pluralStringResource(R.plurals.file_count, count, count). Типобезопасная альтернатива — библиотека Lyricist, которая генерирует типизированные строки из аннотаций.

Android App Bundle с android:splitByLocale="true" в bundle.gradle — ресурсы доставляются только для языков устройства. APK уменьшается на 15-20%, ресурсы нужных локалей догружаются через Play Asset Delivery. Важно: на Android 8+ Configuration.locales — список, не один язык.

Flutter: intl и слои абстракции

Flutter intl пакет — стандарт. AppLocalizations.of(context).welcomeTitle генерируется из ARB-файлов (app_en.arb, app_ru.arb). flutter gen-l10n генерирует типизированный код. Pluralization через {count, plural, one{# файл} few{# файла} many{# файлов} other{# файла}} в ARB.

Для больших приложений с 50+ языками — easy_localization с поддержкой YAML/JSON/CSV форматов и lazy loading переводов: не все 50 языков грузятся сразу, только нужный. Это снижает размер начальной загрузки на 30%.

Сравнительная таблица подходов

Как реализовать RTL-поддержку без переписывания UI?

Арабский, иврит, персидский, урду — языки RTL (Right-to-Left). Это меняет не только направление текста, но и всю раскладку UI: back button справа, иконки зеркально, паддинги и марджины инвертируются.

На iOS всё делается через semanticContentAttribute и Auto Layout. Layout constraint-ы с leading/trailing (не left/right) автоматически инвертируются при RTL. UIView.semanticContentAttribute = .forceRightToLeft для конкретного компонента. Системные компоненты (UINavigationController, UITableView, UIStackView) переключаются автоматически при RTL-локали. Проблемы возникают с кастомными UI, где разработчик жёстко использовал left/right констрейнты или frame-based layout. Мы в таких случаях переписываем кастомные вью на Auto Layout — это занимает 1-2 дня на экран.

На Android android:supportsRtl="true" в AndroidManifest включает RTL-поддержку. start/end вместо left/right в XML-атрибутах: paddingStart, layout_marginEnd, textAlignment="viewStart". LayoutInflater с android:layoutDirection="rtl" для превью. Иконки с направленностью (стрелки, шеврон) нужно зеркалировать — android:autoMirrored="true" в drawable для автоматического инвертирования при RTL.

На Flutter Directionality виджет с TextDirection.rtl управляет направлением для поддерева. Padding(EdgeInsetsDirectional.fromSTEB(...)) вместо EdgeInsets.only(left:...). Row автоматически учитывает TextDirection из Directionality. Большинство Material виджетов RTL-ready, но кастомные CustomPainter — нет: нужно получать TextDirection из context и учитывать вручную.

Тестирование RTL: на iOS Settings → General → Language & Region → Region: Saudi Arabia переключает в RTL режим без смены языка системы. На Android adb shell setprop debug.force.rtl 1 форсирует RTL для отладки. Это позволяет обнаружить до 80% проблем RTL до релиза.

Почему динамическое переключение языка — узкое место?

Переключение языка без перезапуска приложения — нетривиальная задача, особенно если система построена на системной локали. Мы выделили три основных подхода.

iOS не поддерживает смену языка приложения без перезапуска нативно. Самый чистый подход — хранить выбранный язык в UserDefaults, при запуске создавать Bundle с нужной локализацией, использовать кастомный NSLocalizedString через этот Bundle. Bundle.setLanguage("ru") через swizzling Bundle.localizedString(forKey:value:table:) — работает, но это runtime swizzling, что не идеально. Альтернатива: собственная система строк поверх NSBundle, которая перечитывает файлы при смене языка. При переключении — пересоздать корневой ViewController.

Android с API 33: LocaleManager.setApplicationLocales() — официальный API для смены языка приложения без перезапуска системы, без рекреации Activity если использовать AppCompatDelegate.setApplicationLocales(). До API 33 — Configuration.setLocale() + recreate() для Activity. При смене языка нужно уведомить все открытые Activity через broadcast или ViewModel. Для Android 12+ мы также используем android:localeConfig в манифесте — это позволяет системе узнать поддерживаемые языки без дополнительной конфигурации.

Flutter — самый простой из трёх. LocalizationsDelegate перезагружается при изменении locale в MaterialApp. Храним выбранный язык в провайдере (Riverpod/Provider/Bloc), изменение locale в MaterialApp перестраивает дерево с новыми строками. Практически без бойлерплейта при использовании easy_localization. Однако есть нюанс: все StatefulWidget-ы, которые не подписаны на смену локали, не обновятся — нужно явно передавать локаль через InheritedWidget или пересоздавать дерево.

Форматирование дат, чисел, валют

DateFormatter (iOS) и DateFormat (Android, intl) — всегда с явным locale, никогда без него. DateFormatter().dateStyle = .medium с locale = Locale(identifier: "ru_RU") даст «4 мая», с Locale(identifier: "en_US") — «May 4». Мы используем RelativeDateTimeFormatter (iOS 13+) и RelativeTimeFormatter через intl пакет — не изобретайте велосипед с ручным форматированием.

NumberFormatter / NumberFormat.currency() для валют. Символ валюты, разделители тысяч и дробной части — всё locale-специфично. Хардкодить «₽» или «.» как разделитель — ошибка. Locale(identifier: "ru_RU") + NumberFormatter.numberStyle = .currency с currencyCode = "RUB" даст правильное форматирование автоматически.

Типичные ошибки при локализации

Конкатенация строк вместо форматирования: "Hello, " + name + "!" работает для SVO-языков, но в японском имя идёт перед обращением. String(format: "greeting %@", name) с greeting = "%@ さん、こんにちは" в японском файле — правильно. Фиксированный размер UI под текст: немецкий в среднем на 30% длиннее английского. AutoLayout с правильными констрейнтами, adjustsFontSizeToFitWidth там где допустимо, динамическое изменение высоты ячеек через UITableView.automaticDimension. Изображения с embedded текстом требуют локализованных версий или замены на text overlay.

Процесс работы: как мы локализуем приложение под ключ

1. Аналитика и аудит (2-5 дней) — ревью кода на i18n-готовность, выявление хардкода, оценка RTL-сложности, подготовка карты экранов.
2. Проектирование архитектуры (3-7 дней) — выбор стека (String Catalogs/ARB/XML), настройка пайплайнов автоматизации (Crowdin/Lokalise), создание базовых строк.
3. Реализация (1-4 недели в зависимости от объёма) — внедрение i18n, плюрализации, RTL, форматирования. Параллельно — перевод контента.
4. Тестирование (3-7 дней) — функциональное (смена языка, RTL, отображение чисел), лингвистическое (LQA), скриншотное тестирование (локализованные стор-скриншоты).
5. Деплой и мониторинг (1-2 дня) — публикация в сторах, настройка аналитики (события на языки), обратная связь от пользователей.

Что входит в deliverables

• Исходный код с полной i18n-инфраструктурой
• Документация по добавлению нового языка (playbook)
• Файлы переводов (ARB/XML/xcstrings) + глоссарий
• Автоматизация: CI/CD интеграция с сервисами переводов
• Доступ к репозиторию с полной историей изменений
• Обучение команды заказчика (1-2 сессии)
• Гарантия на код — 6 месяцев, бесплатные фиксы багов локализации

Сроки и стоимость

Стоимость рассчитывается индивидуально на основе объёма кода, количества языков и сложности RTL. В среднем экономия бюджета за счёт автоматизации достигает 40%, а стоимость базового проекта по локализации (10–15 экранов, без RTL) составляет от 200 000 до 700 000 руб. Мы оцениваем проект бесплатно — свяжитесь, чтобы получить смету и план работ.

Почему стоит выбрать нас

Мы сертифицированные разработчики (Apple WWDC Scholarship, Google Associate Android Developer). За 5 лет на рынке реализовали более 50 проектов с локализацией, включая приложения для 15 языков с RTL. Гарантируем соблюдение App Store Review Guidelines (Section 4.2/5.1) и Google Play Policies (User Data). Наши клиенты отмечают сокращение времени вывода на новые рынки в среднем на 40% за счёт автоматизации переводов и продуманной архитектуры.

Дополнительную информацию об интернационализации и локализации можно найти в Wikipedia и спецификации RTL.

Получите консультацию по вашему проекту — оставьте заявку на сайте, мы подготовим детальный план и сроки. Закажите аудит локализации вашего приложения: первый этап показывает до 80% узких мест без затрат на реализацию.