Доклад Ярослава Зубца на конференции Application Developer Days-4. г.Минск 13 декабря 2013

1. Современный подход к локализации
на примере одного проекта
Зубец Ярослав
Softengi, Киев

2. О докладчике
Зубец Ярослав
Team Lead, Softengi,
Украина, Киев
7 лет опыта разработки .NET приложений
MCPD Web Developer

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

4. I18n
ция (internationalization)
технологические приѐмы разработки, упрощающие адаптацию
продукта (такого как программное или аппаратное обеспечение) к
языковым и культурным особенностям региона (регионов), отличного
от того, в котором разрабатывался продукт.
L10n
ция (localization)
процесс адаптации программного обеспечения к культуре какой-либо
страны. Как частность — перевод пользовательского интерфейса,
документации и сопутствующих файлов программного обеспечения с
одного языка на другой.

5. Исходные данные
Проект:
21 подсистема
Основные технологии:
ASP.Net (C#), XML/HTML/JavaScript, DB MS SQL Server
Файлы:
C# (*.cs) ~ 6000
SQL (stored procedures and functions) ~2500
Pages (aspx, html) ~ 600
JavaScript ~300
Срок выполнения: ~ 12 месяцев

6. Что предстоит сделать
1.
2.
3.
4.
5.
Интернационализировать БД
Интернационализировать Business уровнь (.NET)
Интернационализировать UI
Сформировать материалы для переводчиков
Локализировать

7. Ручной подход
 Разделение кода по разработчикам и выполнение ручного
вынесения ресурсов
 Доступные ресурсы на проекте:
5 разработчиков, 2 архитектора, 5-7 тестировщиков

8. Проблемы подхода
• Огромное количество багов
- человеческий фактор
• Наличие дубликатов
- отсутствие анализа при вынесении ресурсов
• Трудности с отслеживанием объема работ
• Проблемы «долокализации» новой функциональности

9. Результаты
 Срок выполнения – 1.5 года (estimate – 1год)
 Большой объем тестирования
 Перенос релиза на неопределенный срок

10. Второй шанс
Автоматизированный подход
Основные цели:
- качественный анализ с целью определения литералов, которые
необходимо локализировать
- максимальное уменьшение ручной работы
- сокращение временных затрат

11. Шаг 1. Нахождение всех
литералов для локализации
Использование парсеров
Тип файла
3rd party library
JS
AjaxMin
CS
NRefactory
HTML
Html Agility Pack
SQL
Microsoft ScriptDom
Покрывают 97% литералов приложения

12. Объем локализации
Литералы, неотображаемые на UI
Литералы, подлежащие локализации
9%
91%
Всего литералов ~ 200.000

13. Проблемы
 Механизм отделения строк без дополнительной обработки
не работает!
 Нужно найти способ определения ненужных литералов

14. Шаг 2. Фильтрация по
простым правилам
•
По файлу
- автогенерируемые (*.design.cs)
- 3rd party libraries
•
По содержимому
- только цифры
- пустые строки
- символы не из алфавита
- идентификаторы
Примеры:
item.SetAttribute(ATTRIBUTE_NAME, field.IsPredefined ? "1" : "0");
_defaultSeparator = ",";
var EMPTY_GUID = '00000000-0000-0000-0000-000000000000';

15. Результат применения
простых правил
Объем локализации
Оставшиеся
литералы
40%
60%
Отсеянные
литералы по
простым правилам

16. Шаг 3. Фильтрация на основе
контекста использования
Семантическое дерево:

17. Анализируемые значения
Функция в которую передается литерал
Порядковый номер аргумента

18. Анализируемые значения
Оператор присваивания
Название тэга и аттрибут (для HTML)
<a href="www.softengi.com">Узнать больше о компании</a>

19. Результат применения
правил на основе контекста
Объем локализации
25%
40%
35%
Оставшиеся
литералы
Отсеянные
литералы по
простым правилам
Отсеянные
литералы по
контексту

20. Итоги
 Количество литералов для пересмотра ~ 50.000 (25%)

21. Хранение ресурсов
Варианты:
 в одном файле
 разбивать по сборкам
 по подсистемам
Плохо разложенные
по ресурсам строки мешают
переводам.

22. Категоризация литералов по
области использования
Область
Описание
Пример
Global
общие тексты кнопок
общие тексты сообщений
общие строки для всего сообщения
общие валидационные сообщения
Save, Cancel
Help
"Value is required"
Module
Литералы, общие для всех страниц и
контролов в рамках одного модуля
Dashboard
Task
Local
Специфичные литералы для одной
страниц или контрола или
вспомагательного класс и т.д.
"Auto Fill" (on one of
Tasks pages)

23. Категоризация литералов
по смысловому значению
 Exceptions
 Validations
 Pages
 Javascripts
 Xmls
 Entities
 Enums

24. Структура приложения
Root /
Resources / (global scope)
Exceptions.resx
Validations.resx
Pages.resx
Citations /
Resources / (module scope)
Pages.resx
Validations.resx
JavaScripts.resx
Xstls.resx
CitationEdit.aspx
CitationContextMenu.xml
MainForm.aspx

25. Локализация объектов
(entities)
 Около 15% литералов для локализации – имена сущностей
или их свойств.

26. Результаты категоризации
 Именование ключей
•
•
•
•
•
Resources.Pages.Command_Delete
Resources.Exceptions.InvalidCastException.NameNotValid
Citations.Resources.Validations.NameRequired
Security.Resources.Pages.ExpireUser.aspx.cs.Command_Revoke
Task.DueDate
 У каждого литерала своя область действия

27. Локализация динамических
страниц (aspx, ascx)
Стандартный подход ASP.NET не подошел 
Свой собственный ASP.NET Expression:

28. Локализация статических
файлов
Типы файлов: Html, JavaScript, Xslt, Xml
 Универсальный подход - сделать статические файлы
динамическими.
 Производительность благодаря кэшированию не
пострадала!

29. Синтаксис вставки
 Аналогично динамическим страницам!

31. Localization Studio
Назначение
Работа со строками, выводимыми на интерфейс приложения:
 Оценка состояния интернационализации
 Обработка строк, создание ресурсных файлов
 Управление правилами фильтрации литералов
 Подготовка материалов для переводчиков
 Управление переводами для разных культур.

32. Localization Studio

33. Дополнительные
возможности
Для разработчиков
• поиск литералов
• нахождение дубликатов (для уменьшения стоимости переводов)
• статистика по литералам
Для переводчиков
• Импорт, экспорт ресурсов в Excel
• Получение информации о контексте ресурса

34. Автоматизированный подход
(результаты)








Срок выполнения – 6 месяцев
Уменьшение дублирования ресурсов
Повышение согласованности переводов
Прозрачная поддержка циклов будущих релизов
Улучшение прозрачности кода
Сокращение циклов тестирования
Уменьшение количества багов
Организация взаимодействия с переводчиками

35. Идеи развития




Подключение к continuous integration
Поддержка других типов проектов
Адаптация под Agile
Оказание услуг локализации другим проектам/компаниям

36. О компании
Intecracy Group
Международный консорциум, работающий в сфере высоких
технологий. Консорциум Intecracy Group объединяет 10 ITкомпаний, каждая из которых достигла наивысшего уровня
компетенции в своем виде деятельности.
Localization Service




Экспертиза готовности продукта к локализации
Интернационализация и локализация корпоративных приложений
Обеспечение работ по переводу
Тестирование локализации приложений

37. Вопросы?