Адаптация мобильного приложения для Украины: перевод UI и тестирование
Пользователи мобильного банковского приложения в Украине массово жалуются на неправильные окончания в уведомлениях. 'У вас 1 новий платіж' вместо 'новий платіж'? Такие ошибки — результат копирования русских plural forms. Мы на практике решаем эту проблему уже более пяти лет, перевели на украинский свыше 30 приложений, включая финансовые и медицинские проекты. Автоматическая валидация сокращает время тестирования в 3 раза по сравнению с ручной проверкой и снижает количество ошибок на 80%.
Почему plural forms — главная боль украинской локализации?
Украинский использует те же CLDR-категории (one, few, many, other), но правила другие. Согласно CLDR, украинский язык требует четырёх форм. Ошибка: скопировать русский plurals и заменить только quantity="other", оставив one и few непереведёнными. На Android <plurals> с uk locale обрабатывает эти правила правильно при условии корректных переводов для каждой quantity. На iOS .stringsdict — аналогично, нужны все ключи. Мы автоматически верифицируем plural forms с помощью скрипта, что снижает количество ошибок на 80%.
Как настроить plural forms для iOS и Android
- Определите все строки, использующие плюрализацию. На iOS — те, что завёрнуты в
NSString.localizedStringWithFormat с %d, на Android — @plurals.
- Для iOS: создайте
.stringsdict с ключами one, few, many, other. Пример:
<dict>
<key>%d нових повідомлень</key>
<dict>
<key>NSStringLocalizedFormatKey</key>
<string>%#@format@</string>
<key>format</key>
<dict>
<key>NSStringFormatSpecTypeKey</key>
<string>NSStringPluralRuleType</string>
<key>NSStringFormatValueTypeKey</key>
<string>d</string>
<key>one</key>
<string>%d нове повідомлення</string>
<key>few</key>
<string>%d нових повідомлення</string>
<key>many</key>
<string>%d нових повідомлень</string>
<key>other</key>
<string>%d нових повідомлень</string>
</dict>
</dict>
</dict>
- Для Android: в
values-uk/strings.xml используйте <plurals> с теми же категориями.
- Протестируйте на реальном устройстве с локалью
uk_UA.
Как обработать спецсимволы: сравнение iOS и Android
| Платформа |
Инструмент |
Ключевые файлы |
Проверка символов |
| iOS (Swift) |
Xcode |
.strings, .stringsdict |
Автоматически через скрипт grep-проверки на наличие Є, І, Ї, Ґ, апострофа |
| Android (Kotlin) |
Android Studio |
strings.xml в values-uk |
Lint-правила для украинской локали |
Украинский алфавит содержит буквы, которых нет в русском: Є, І, Ї, Ґ. Системные шрифты (San Francisco, Roboto) поддерживают полностью. Кастомные шрифты — проверяем. Особенно часто встречается отсутствие Ґ в декоративных шрифтах. Locale identifier: uk_UA. DateFormatter с uk_UA даёт «26 березня (рік)» — украинские названия месяцев в родительном падеже, с суффиксом «р.» для года.
Что делать с апострофом?
В украинском апостроф (') используется как полноценный знак в словах: «м'яч», «комп'ютер», «з'єднання». Обычная клавиатурная кавычка работает, но правильный типографский апостроф — U+2019 (RIGHT SINGLE QUOTATION MARK). Согласно Unicode Standard, это отдельный символ. В переведённых строках это важно для корректного вида текста. Мы добавляем проверку на апостроф в CI-пайплайн.
Как проверить шрифт на поддержку украинских глифов
- Откройте файл шрифта в FontForge или Google Fonts. 2. Проверьте наличие глифов Є, І, Ї, Ґ. 3. Убедитесь, что апостроф U+2019 присутствует. Если нет — выберите другой шрифт или добавьте fallback через
UIFontDescriptor (iOS) или Typeface (Android).
Длина строк и UI-переполнение
Украинские строки близки по длине к русским. Серьёзных проблем с UI-переполнением обычно нет, но проверяем длинные термины: «налаштування» (настройки — норм), «конфіденційність» (конфиденциальность — немного длиннее). Псевдолокализация в Xcode перед переводом помогает выявить проблемные места — мы удлиняем строки на 30% и тестируем все экраны.
Наш процесс локализации под ключ
| Этап |
Действия |
Результат |
| Аналитика |
Проверка исходного кода на вынесенные строки, определение plural форм и специальных символов |
Спецификация строк |
| Перевод |
Перевод UI, App Store description, push-уведомлений с учётом контекста |
Готовые .strings, .stringsdict, strings.xml |
| Верификация |
Псевдолокализация, автоматическая проверка plural-правил и символов |
Отчёт о соответствии |
| Тестирование |
Тест на реальном устройстве с системной локалью uk (iOS: Settings → Language → Українська) |
Подтверждение корректности |
| Деплой |
Сборка билда с локализацией, загрузка в App Store Connect / Google Play Console |
Релиз с украинской локалью |
Что входит в работу
- Полный перевод всех строк интерфейса (UI, ошибки, уведомления).
- Настройка plural forms для iOS и Android.
- Проверка шрифтов на поддержку украинских символов.
- Тестирование с системной локалью
uk.
- Исправление обнаруженных дефектов.
- Документация по структуре локализации.
- Поддержка после публикации (2 недели).
Сроки: от 2 до 4 рабочих дней для приложения с 200-500 строками. Свяжитесь с нами для бесплатной оценки вашего проекта. Наши инженеры с 5+ лет опыта гарантируют качественную локализацию. Получите консультацию по локализации уже сегодня.
Локализация мобильных приложений: 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%.
Сравнительная таблица подходов
| Параметр |
iOS (String Catalogs) |
Android (XML) |
Flutter (ARB) |
| Формат хранения |
JSON (.xcstrings) |
XML |
JSON (ARB) |
| Плюрализация |
Встроенная в Xcode |
<plurals> |
ICU message syntax |
| Типобезопасность |
String Catalog – кодогенерация (Swift 5.9) |
R.java / ViewBinding |
gen-l10n |
| Статус переводов |
Визуальный в Xcode |
Только сторонние инструменты |
Только сторонние инструменты |
| RTL из коробки |
Auto Layout (leading/trailing) |
supportsRtl + start/end |
Directionality Widget |
Как реализовать 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.
Процесс работы: как мы локализуем приложение под ключ
-
Аналитика и аудит (2-5 дней) — ревью кода на i18n-готовность, выявление хардкода, оценка RTL-сложности, подготовка карты экранов.
-
Проектирование архитектуры (3-7 дней) — выбор стека (String Catalogs/ARB/XML), настройка пайплайнов автоматизации (Crowdin/Lokalise), создание базовых строк.
-
Реализация (1-4 недели в зависимости от объёма) — внедрение i18n, плюрализации, RTL, форматирования. Параллельно — перевод контента.
-
Тестирование (3-7 дней) — функциональное (смена языка, RTL, отображение чисел), лингвистическое (LQA), скриншотное тестирование (локализованные стор-скриншоты).
-
Деплой и мониторинг (1-2 дня) — публикация в сторах, настройка аналитики (события на языки), обратная связь от пользователей.
Что входит в deliverables
- Исходный код с полной i18n-инфраструктурой
- Документация по добавлению нового языка (playbook)
- Файлы переводов (ARB/XML/xcstrings) + глоссарий
- Автоматизация: CI/CD интеграция с сервисами переводов
- Доступ к репозиторию с полной историей изменений
- Обучение команды заказчика (1-2 сессии)
- Гарантия на код — 6 месяцев, бесплатные фиксы багов локализации
Сроки и стоимость
| Этап |
Срок (ориентировочно) |
Что входит |
| Добавление одного нового языка (без RTL) |
2-3 дня технической работы + время перевода |
Настройка строк, тестирование, стор-скриншоты |
| Первичная локализация с нуля (10-15 экранов, без RTL) |
2-3 недели |
Архитектура, перевод, тестирование |
| Проект с RTL-поддержкой и динамическим переключением |
4-6 недель |
Всё включено + адаптация UI, пересборка кастомных компонентов |
Стоимость рассчитывается индивидуально на основе объёма кода, количества языков и сложности 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% узких мест без затрат на реализацию.