Автоматизация локализации iOS-приложений

Deck для моего выступления на MBLT'12 в рамках Yandex Mobile Camp. Текст изначального анонса ниже:

Я расскажу про ужасы локализации и как с ними бороться на пошаговом примере: от «Эврика, нам нужно перевести проект на язык Х!» до «Как не прострелить себе ногу, когда у вас есть Xcode, разработчики, переводчики и дедлайн».

Мы пройдемся по всем базовым инструментам локализации (genstrings, ibtool) и поймем, как их использовать с наименьшими телодвижениями. Отдельно поговорим про то, как мы подружили весь этот «зоопарк» в Яндексе и чем готовы поделиться.

Transcript

1. 1 Автоматизация локализации iOS-приложений Андрей Субботин eploko@yandex-team.ru @eploko
2. 2 Зачем? Как это? Кто? Что это? Яндекс. Страшное Полезное Забавное
3. 3 Зачем нужна локализация?
4. 4 Can't read, won't buy.
5. 52,4% не покупают продукт на чужом языке. 60% — для Франции, Японии и России. 89,3% — если английский знают плохо. 5
6. http://bit.ly/whylocalize 6
7. 7 Интернационализация i18n = подготовка продукта к локализации
8. 8 Локализация L10n = адаптация продукта к конкретному языку и местности
9. Понятный язык интерфейса. 9
10. Дата и время в привычном формате. 10
11. Корректная сортировка списков. 11
12. Поддержка местных единиц измерения. 12
13. Правильное форматирование чисел. 13
14. Что локализуется в приложении? 14
15. Текстовые строки. 15
16. XIB-файлы. 16
17. Изображения, аудио. 17
18. Как приложение подгружает ресурсы? 18
20. en.lproj 20
21. ru.lproj 21
22. Подготовка строк к локализации 22
23. = ваш друг! 23 NSLocalizedString
24. NSLocalizedString(@"key", @"translator comment") 24
25. NSLog(NSLocalizedString(@"Some sample text", @"A text string to be output to the logs.")); 25
26. 2012-03-06 08:10:05.433 L10nSample[15433:f803] Some sample text 2012-03-06 08:11:02.117 L10nSample[15438:f903] Некий примерный текст 26
27. = тоже ваш друг! 27 NSFormatter → Data Formatting Guide
28. Выделение строк 28
29. *.m → Localizable.strings $ genstrings *.m -o Resources/en.lproj 29
30. en.lproj/Localizable.strings /* A text string to be output to the logs. */ "Some sample text" = "Some sample text"; /* A text string to be output to the logs. */ "Some sample text" = "Некий примерный текст"; 30 ru.lproj/Localizable.strings
31. Выделение строк из XIB 31
32. $ ibtool --export-strings-file \ en.lproj/ViewController.strings \ en.lproj/ViewController.xib 32 *.xib → *.strings
33. /* Class = "IBUIButton"; normalTitle = "Welcome!"; ObjectID = "8"; */ "8.normalTitle" = "Welcome!"; 33 en.lproj/ViewController.strings
34. Вмерживание переводов обратно 34
35. $ ibtool --import-strings-file \ en.lproj/ViewController.strings \ en.lproj/ViewController.xib \ --write en.lproj/ViewController.xib 35 *.strings → *.xib
36. Инкрементальное обновление XIB'ов 36
37. Создали en.XIB. 37 А теперь что?! Локализовали en.XIB → ru.XIB. Добавили новую кнопку в en.XIB.
38. $ 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 38 en.xib → ru.xib
39. $ 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 39 en.xib → ru.xib
40. $ 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 40 en.xib → ru.xib
41. $ 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 41 en.xib → ru.xib
42. $ 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 42 en.xib → ru.xib
43. $ 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 43 en.xib → ru.xib
44. $ 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 44 en.xib → ru.xib
45. Храните предыдущие версии XIB файлов. 45
46. Не правьте руками локализованные XIB файлы. 46
47. Переводчики 47
48. понимают английский. 48 Переводчики
49. не всегда понимают русский. 49 Переводчики
50. не используют Xcode и не редактируют XIB. 50 Переводчики
51. Не знают контекста перевода без вашей помощи. 51 Переводчики
52. Как они работают? 52
53. но редко. 53 Вместе с вами,
54. Очень часто 54 по e-mail.
55. +1 к карме 55 translations.launchpad.net
56. 56 Tanker = web-сервис = API для загрузки и выгрузки переводов
57. Yoda 57 Babelfish
58. Babelyoda 58 избавляет от рутинной ручной работы сводит количество багов при локализации к минимуму
59. генерирует .strings из кода и XIB’ов загружает .strings в Tanker забирает из Tanker’а свежие переводы обновляет XIB файлы аккуратно все коммитит в git PROFIT!!
60. Babelyoda 60 = библиотека для работы с .strings, genstrings и ibtool
61. Babelfile 61 ...по аналогии с Makefile, Gemfile, Rakefile и т.п. = единое место конфигурации.
62. 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 62
63. 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 63
64. 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 64
65. 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 65
66. 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 66
67. One command to rule them all! 67 $ rake babelyoda
68. $ 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 68
69. #!/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 69 yxbuildkit-prebuild.sh
70. https://github.com/eploko/babelyoda 70 Available on GitHub!
71. Плюрализация 71 хоррор стори
72. I scanned 12 directories. 72
73. NSLog(@"I scanned %g directories.", directoryCount); 73
74. I scanned 1 directories. 74
75. NSLog(@"I scanned %g %@.", directoryCount, directoryCount == 1 ? @"directory" : @"directories", ); 75
76. I scanned 1 directory. 76
77. NSLog( NSLocalizedString(@"I scanned %g %@.", @”Text to show the number of directories scanned”), dirScanCount, dirScanCount == 1 ? NSLocalizedString(@"directory", @”Single directory”) : NSLocalizedString(@"directories", @”Plural directories”) ); 77
78. 78 Как это видит переводчик?
79. 79 "I scanned %g %@." "directory" "directories"
80. 80 "Я просканировал %g %@." "папка" "каталоги"
81. Я отсканировал 1 папка. 81
82. Я отсканировал 5 каталоги. 82
83. NSLog( dirScanCount == 1 ? NSLocalizedString("I scanned %g directory.", @”Blah”) : NSLocalizedString("I scanned %g directories.", @”Blah”), dirScanCount ); 83
84. “It is more complicated than you think.” — The Eighth Networking Truth, from RFC 1925 84
85. NSString *pluralTransfers = NSLocalizedString(@"%d changes", @"The number of changes shown in the route description"); 85
86. 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]; 86
87. 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; } } 87
88. 88 Как это видит переводчик?
89. 89 "%d change" "%d changes" "%d changes" "%d changes"
90. 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]; 90
91. 91 Как это видит переводчик?
92. 92 "NumberChanges0" "NumberChanges3" "NumberChanges2" "NumberChanges1"
93. genstrings “магия” 93
94. NSLocalizedString(@"%[one, some, many, none]d changes", @"The number of changes shown in the route description"); 94
95. /* 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"; 95 Localizable.strings
96. /* The number of changes shown in the route description */ "%[one]d changes" = "%d остановка"; "%[some]d changes" = "%d остановки"; "%[many]d changes" = "%d остановок"; "%[none]d changes" = ""; 96 Localizable.strings
97. NSString *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 @”[one]”; } else if ((n10 > 1) && (n10 < 5) && ((n > 20) || (n < 10))) { return @”[some]”; } else { return @”[many]”; } } 97
98. NSString *pluralKey = NSLocalizedString( @"%[one, some, many, none]d changes", @"The number of changes shown in the route description"); NSString *pluralTransfers = YXLocalizedStringN(pluralKey, self.transfersCount); 98
99. "%[one, some, many, none]d changes" "%[some]d changes"
100. “Хитрости” 100
101. 101 Английский текст в качестве ключа NSLocalizedString(@"Tap Here", @"Action button title"); NSLocalizedString(@"TapButtonTitle", @"Action button title");
102. 102 Английский текст в качестве ключа WelcomeButtonTitle WelcomeTitle ButtonTitleWelcome WelcomeTITLE WelcomeBtnTitle
103. 103 Различные контексты Edit = Править Edit = Изменить Edit = Переименовать
104. 104 Различные контексты NSLocalizedStringFromTable (<#key#>, <#tbl#>, <#comment#>) NSLocalizedStringFromTable (@”Edit”,@”Common”,@”Blah”) NSLocalizedStringFromTable (@”Edit”,@”Buttons”,@”Blah”)
105. 105 Склеивание строк 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]; ΁΍΁ɿ̑ਓ
106. 106 Склеивание строк NSLocalizedString( @"People in the room: %[one, some, many, none]d", @"Blah blah"); ΁΍΁ɿ̑ਓ
107. 107 Полезные проекты
108. 108 Linguan
109. 109 Wincent Strings Utility “Merges, extracts and combines .string files (for incremental localization)” — http://wincent.com/a/products/wincent-strings-util/
110. 110 genstrings2 “40x faster than genstrings” — http://www.cocoanetics.com/2012/01/genstrings2/
111. 111 Twine “String Management for iOS, Mac OS X, and Android Development” — http://www.mobiata.com/blog/2012/02/08/twine-string-management-ios-mac-os-x
112. 112 WTF!?
113. 113 WTF!?
114. 114 WTF!?
115. 115 WTF!?
116. 116 WTF!?
117. 117 WTF!? WTF!? WTF!?
118. 118 WTF!?
119. 119 WTF!? WTF!? WTF!? WTF!? WTF!?
120. 120 WTF!? WTF!?
121. Andrey Subbotin eploko@yandex-team.ru @eploko Вопросы? :-)