Ужасы локализации и как с ними бороться на пошаговом примере: от «Эврика, нам нужно перевести проект на язык Х!» до «Как не прострелить себе ногу, когда у вас есть Xcode, разработчики, переводчики и дедлайн». Рассматриваются все базовые инструменты локализации (genstrings, ibtool) в целях понимания, как их использовать с наименьшими телодвижениями. Отдельно рассказывается про то, как мы подружили весь этот «зоопарк» в Яндексе и чем готовы поделиться.

1. Локализации
iOS-приложений
Андрей Субботин
Разработчик, Мобильные Яндекс.Карты (iOS)
Я.Субботник, Минск, 2 июня 2012 года

2. Can't read,
won't buy.
2

3. 52,4% не покупают продукт на чужом языке.
60% — для Франции, Японии и России.
89,3% — если английский знают плохо.
3

4. 4

5. http://bit.ly/whylocalize
5

6. Интернационализация i18n
= подготовка продукта к
локализации
6

7. Локализация L10n
= адаптация продукта к
конкретному языку и
местности
7

8. Локализация L10n
Понятный язык интерфейса.
Дата и время в привычном формате.
Корректная сортировка списков.
Поддержка местных единиц измерения.
Правильное форматирование чисел.
8

9. Что локализуется
в приложении?
Текстовые строки.
XIB-файлы.
Изображения, аудио.
9

10. Подготовка строк
к локализации
10

11. NSLocalizedString
= ваш друг!
11

12. NSLog(NSLocalizedString(@"Some sample
text", @"A text string to be output to the
logs."));
12

13. NSLog(NSLocalizedString(@"Some sample
text", @"A text string to be output to the
logs."));
2012-03-06 08:10:05.433
L10nSample[15433:f803] Some sample
text
2012-03-06 08:11:02.117
L10nSample[15438:f903] Некий
примерный текст
13

14. NSFormatter
= тоже ваш друг!
→ Data Formatting Guide
14

15. Выделение строк
15

16. *.m → Localizable.strings
$ genstrings *.m -o Resources/en.lproj
16

17. en.lproj/Localizable.strings
/* A text string to be output to the logs. */
"Some sample text" = "Some sample text";
ru.lproj/Localizable.strings
/* A text string to be output to the logs. */
"Some sample text" = "Некий примерный текст";
17

18. Выделение строк
из XIB
18

19. *.xib → *.strings
$ ibtool --export-strings-file
en.lproj/ViewController.strings
en.lproj/ViewController.xib
19

20. en.lproj/ViewController.strings
/* Class = "IBUIButton"; normalTitle = "Welcome!";
ObjectID = "8"; */
"8.normalTitle" = "Welcome!";
20

21. Вмерживание
переводов
обратно
21

22. *.strings → *.xib
$ ibtool --import-strings-file
en.lproj/ViewController.strings
en.lproj/ViewController.xib
--write en.lproj/ViewController.xib
22

23. Инкрементальное
обновление XIB'ов
23

24. Создали en.XIB.
Локализовали en.XIB → ru.XIB.
Добавили новую кнопку в en.XIB.
А теперь что?!
24

25. en.xib → ru.xib
$ ibtool
--previous-file en.lproj/Window.old.xib
--incremental-file ru.lproj/Window.old.xib
--strings-file ru.lproj/Window.strings
--localize-incremental
--write ru.lproj/Window.xib
en.lproj/Window.new.xib
25

26. Храните предыдущие
версии XIB файлов.
Не правьте руками
локализованные XIB файлы.
26

27. Переводчики
Понимают английский.
Не всегда понимают русский.
Не используют Xcode
и не редактируют XIB.
Не знают контекста перевода
без вашей помощи.
27

28. Tanker
= web-сервис
= API для загрузки и
выгрузки переводов
28

29. Babelfish
Yoda
29

30. Babelyoda
избавляет от
рутинной ручной работы
сводит количество багов при
локализации к минимуму
30

31. генерирует .strings
из кода и XIB’ов загружает .strings
в Tanker
забирает из Tanker’а
свежие переводы
обновляет
XIB файлы
аккуратно все
коммитит в git
PROFIT!!
31

32. Babelyoda
= библиотека для работы с .strings,
genstrings и ibtool
32

33. Babelfile
...по аналогии с
Makefile, Gemfile, Rakefile и т.п.
= единое место конфигурации.
33

34. Babelyoda::Specification.new do |s|
s.name = 'YandexMaps'
s.development_language = :en
s.localization_languages = [:ru, :uk, :tr]
s.engine = Babelyoda::Tanker.new do |t|
t.token = ENV['TANKER_TOKEN']
t.project_id = 'myak_iphone'
t.endpoint = ENV['TANKER_HOST']
end
s.scm = Babelyoda::Git.new
s.source_files = FileList['{Classes,Shared}/**/*.{m,mm,h}']
s.resources_folder = 'Resources'
s.xib_files = FileList['Resources/**/en.lproj/*.xib']
s.strings_files = FileList['Resources/**/en.lproj/*.strings']
end
34

35. rake babel yoda
$
One command to rule
them all!
35

36. $ rake -T
rake babelyoda
rake babelyoda:create_keysets
rake babelyoda:drop_empty_strings
rake babelyoda:drop_orphan_keys
rake babelyoda:drop_orphan_keysets
rake babelyoda:extract
rake babelyoda:extract_strings
rake babelyoda:extract_xib_strings
rake babelyoda:fetch_strings
rake babelyoda:initBabelfile
rake babelyoda:localize_xibs
rake babelyoda:pull
rake babelyoda:push
rake babelyoda:remote:drop_keysets
rake babelyoda:remote:list
rake babelyoda:verify
36

37. yxbuildkit-prebuild.sh
#!/bin/bash
function verify {
if [ $CONFIGURATION == 'AppStore' ] ; then
rvm rvmrc trust . && rvm rvmrc load . && bundle
&& bundle exec rake babelyoda:verify
return $?
fi
return 0
}
git submodule update --init --recursive && verify
37

38. Available on GitHub!
http://bit.ly/yandextool
38

39. Плюрализация
х орр ор стори
39

40. I scanned 12
directories.
40

41. NSLog(@"I scanned %g directories.",
directoryCount);
41

42. I scanned 1
directories.
42

43. NSLog(@"I scanned %g %@.",
directoryCount,
directoryCount == 1 ?
@"directory" : @"directories",
);
43

44. I scanned 1
directory.
44

45. NSLog(
NSLocalizedString(@"I scanned %g %@.", @”Text to show the number of
directories scanned”),
dirScanCount,
dirScanCount == 1 ?
NSLocalizedString(@"directory", @”Single directory”) :
NSLocalizedString(@"directories", @”Plural directories”)
);
45

46. Как это видит
переводчик?
46

47. "I scanned %g %@." "Я просканировал
%g %@."
"directories" "каталоги"
"directory" "папка"
47

48. Я отсканировал 1
папка.
48

49. Я отсканировал 5
каталоги.
49

50. NSLog(
dirScanCount == 1 ?
NSLocalizedString("I scanned %g directory.", @”Blah”) :
NSLocalizedString("I scanned %g directories.", @”Blah”),
dirScanCount );
50

51. NSString *pluralTransfers =
NSLocalizedString(@"%d changes",
@"The number of changes shown in the route description");
51

52. NSString *forms[4] = {0};
forms[0] = NSLocalizedString(@"%d change", @"Blah");
forms[1] = NSLocalizedString(@"%d changes", @"Blah");
forms[2] = NSLocalizedString(@"%d changes", @"Blah");
forms[3] = NSLocalizedString(@"%d changes", @"Blah");
int form = YXPluralFormForN(self.transfersCount);
NSString *pluralTransfers = forms[i];
52

53. int YXPluralFormForRU(NSInteger n)
{
// One - 1, 21, 31, ...
// Some - 2-4, 22-24, 32-34 ...
// Many - 5-20, 25-30, ...
NSInteger n10 = n % 10;
if ((n10 == 1) && ((n == 1) || (n > 20))) {
return 0;
} else if ((n10 > 1) && (n10 < 5) && ((n > 20) || (n < 10))) {
return 1;
} else {
return 2;
}
}
53

54. Как это видит
переводчик?
54

55. "%d change"
"%d changes"
"%d changes"
"%d changes"
55

56. NSString *forms[4] = {0};
forms[0] = NSLocalizedString(@"NumberChanges0", @"Blah");
forms[1] = NSLocalizedString(@"NumberChanges1", @"Blah");
forms[2] = NSLocalizedString(@"NumberChanges2", @"Blah");
forms[3] = NSLocalizedString(@"NumberChanges3", @"Blah");
int form = YXPluralFormForN(self.transfersCount);
NSString *pluralTransfers = forms[i];
56

57. Как это видит
переводчик?
57

58. "NumberChanges0"
"NumberChanges1"
"NumberChanges2"
"NumberChanges3"
58

59. genstrings “магия”
59

60. NSLocalizedString(@"%[one, some, many, none]d changes",
@"The number of changes shown in the route description");
60

61. Localizable.strings
/* The number of changes shown in the route description */
"%[one]d changes" = "%d changes";
"%[some]d changes" = "%d changes";
"%[many]d changes" = "%d changes";
"%[none]d changes" = "%d changes";
/* The number of changes shown in the route description */
"%[one]d changes" = "%d остановка";
"%[some]d changes" = "%d остановки";
"%[many]d changes" = "%d остановок";
"%[none]d changes" = "";
61

62. "%[one, some, many, none]d changes"
"%[some]d changes"
62

63. “Хитрости”
63

64. Английский текст в качестве ключа
NSLocalizedString(@"Tap Here", @"Action button title");
NSLocalizedString(@"TapButtonTitle", @"Action button title");
64

65. Английский текст в качестве ключа
WelcomeButtonTitle
WelcomeTitle
ButtonTitleWelcome
WelcomeTITLE
WelcomeBtnTitle
65

66. Различные контексты
Edit = Править
Edit = Изменить
Edit = Переименовать
66

67. Различные контексты
NSLocalizedStringFromTable
(<#key#>, <#tbl#>, <#comment#>)
NSLocalizedStringFromTable
(@”Edit”,@”Common”,@”Blah”)
NSLocalizedStringFromTable
(@”Edit”,@”Buttons”,@”Blah”)
67

68. Склеивание строк
NSString *part1 = NSLocalizedString(@"People in the room",
@"Part 1");
NSString *part2 = NSLocalizedString(@"%d", @"Part 2");
NSString *halfResult = [NSString stringWithFormat:@"%@: %@",
part1, part2];
NSString *result = [NSString stringWithFormat:halfResult, 5];
へやへ：５人
68

69. Склеивание строк
NSLocalizedString(
@"People in the room: %[one, some, many, none]d",
@"Blah blah");
へやへ：５人
69

70. WTF!?
70

71. WTF!?
71

72. WTF!?
72

73. WTF!?
73

74. WTF!?
74

75. WTF!?
WTF!?
WTF!?
75

76. WTF!?
76

77. WTF!? WTF!?
77

78. Андрей Субботин
Разработчик,
Мобильные Яндекс.Карты (iOS)
eploko@yandex-team.ru
@eploko