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

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

Андрей Субботин

eploko@yandex-team.ru
@eploko
1

Зачем? Что это?

Как это? Кто?

Яндекс. Страшное

Полезное Забавное

2

Зачем нужна
локализация?

3

Can't read,
won't buy.

4

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

5

http://bit.ly/whylocalize

6

Интернационализация i18n

= подготовка продукта к
локализации

7

Локализация L10n

= адаптация продукта к
конкретному языку и
местности

8

Понятный язык интерфейса.

9

Дата и время в привычном формате.

10

Корректная сортировка списков.

11

Поддержка местных единиц измерения.

12

Правильное форматирование чисел.

13

Что локализуется
в приложении?

14

Текстовые строки.

15

Изображения, аудио.

17

Как приложение
подгружает
ресурсы?

18

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

22

NSLocalizedString

= ваш друг!

23

NSLocalizedString(@"key",
@"translator comment")

24

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

25

2012-03-06 08:10:05.433
L10nSample[15433:f803] Some sample
text

2012-03-06 08:11:02.117
L10nSample[15438:f903] Некий
примерный текст

26

NSFormatter

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

27

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

28

*.m → Localizable.strings

$ genstrings *.m -o Resources/en.lproj

29

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" = "Некий примерный текст";

30

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

31

*.xib → *.strings

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

32


/* Class = "IBUIButton"; normalTitle = "Welcome!";
ObjectID = "8"; */

"8.normalTitle" = "Welcome!";

33

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

34

*.strings → *.xib

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

35

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

36

Создали en.XIB.
Локализовали en.XIB → ru.XIB.
Добавили новую кнопку в en.XIB.

А теперь что?!

37

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

38

en.xib → ru.xib
$ ibtool

39

en.xib → ru.xib
$ ibtool

40

en.xib → ru.xib
$ ibtool

41

en.xib → ru.xib
$ ibtool

42

en.xib → ru.xib
$ ibtool

43

en.xib → ru.xib
$ ibtool

44

Храните предыдущие
версии XIB файлов.

45

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

46

Переводчики

47


понимают английский.

48


не всегда понимают русский.

49

не используют Xcode
и не редактируют XIB.

50

Не знают контекста перевода
без вашей помощи.

51

Как они
работают?

52

Вместе с вами,
но редко.

53

Очень часто

по e-mail.

54

translations.launchpad.net
+1 к карме

55

Tanker

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

56

Babelyoda

избавляет от
рутинной ручной работы

сводит количество багов
при локализации к
минимуму

58

генерирует .strings
из кода и XIB’ов загружает .strings
в Tanker

забирает из Tanker’а
свежие переводы

обновляет
XIB файлы
аккуратно все
коммитит в git
PROFIT!!

Babelyoda

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

60

Babelfile
...по аналогии с
Makefile, Gemfile, Rakefile и т.п.

= единое место конфигурации.

61

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

end
end

63

end
end

64

end
end

65

end
end

66

rake babel yoda
$

One command to rule
them all!

67

$ 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:initBabelﬁle
rake babelyoda:localize_xibs
rake babelyoda:pull
rake babelyoda:push
rake babelyoda:remote:drop_keysets
rake babelyoda:remote:list
rake babelyoda:verify

68

yxbuildkit-prebuild.sh

#!/bin/bash

function verify {
if [ $CONFIGURATION == 'AppStore' ] ; then
rvm rvmrc trust . && rvm rvmrc load . && bundle
&& bundle exec rake babelyoda:verify
return $?
ﬁ
return 0
}

git submodule update --init --recursive && verify

69

Available on GitHub!

https://github.com/eploko/babelyoda

70

Плюрализация

х орр ор стори

71

I scanned 12
directories.

72

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

73

I scanned 1
directories.

74

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

75

I scanned 1
directory.

76

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

"I scanned %g %@."
"directories"
"directory"

79

"Я просканировал %g %@."
"каталоги"
"папка"

80

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

81

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

82

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

83

“It is more complicated than
you think.”
— The Eighth Networking Truth, from RFC 1925

84

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

85

NSString *forms[4] = {0};
forms[0] = NSLocalizedString(@"%d change", @"Blah");
forms[1] = NSLocalizedString(@"%d changes", @"Blah");

int form = YXPluralFormForN(self.transfersCount);
NSString *pluralTransfers = forms[i];

86

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

"%d change"
"%d changes"
"%d changes"
"%d changes"

89

NSString *forms[4] = {0};
forms[0] = NSLocalizedString(@"NumberChanges0", @"Blah");

int form = YXPluralFormForN(self.transfersCount);
NSString *pluralTransfers = forms[i];

90


91

"NumberChanges0"
"NumberChanges1"
"NumberChanges2"
"NumberChanges3"

92

genstrings “магия”

93

NSLocalizedString(@"%[one, some, many, none]d changes",

94

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";

95

Localizable.strings

/* 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

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

NSString *pluralKey = NSLocalizedString(
@"%[one, some, many, none]d changes",

NSString *pluralTransfers = YXLocalizedStringN(pluralKey,
self.transfersCount);

98

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

"%[some]d changes"

“Хитрости”

100

Английский текст в качестве ключа

NSLocalizedString(@"Tap Here", @"Action button title");

NSLocalizedString(@"TapButtonTitle", @"Action button title");

101

Английский текст в качестве ключа

WelcomeButtonTitle
WelcomeTitle
ButtonTitleWelcome
WelcomeTITLE
WelcomeBtnTitle

102

Различные контексты

Edit = Править
Edit = Изменить
Edit = Переименовать

103

Различные контексты

NSLocalizedStringFromTable
(<#key#>, <#tbl#>, <#comment#>)

(@”Edit”,@”Common”,@”Blah”)

(@”Edit”,@”Buttons”,@”Blah”)

104

Склеивание строк

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];

へやへ：５人
105

Склеивание строк

NSLocalizedString(
@"People in the room: %[one, some, many, none]d",
@"Blah blah");

へやへ：５人
106

Полезные проекты

107

Wincent Strings Utility

“Merges, extracts and
combines .string ﬁles (for
incremental localization)”
— http://wincent.com/a/products/wincent-strings-util/

109

genstrings2

“40x faster than genstrings”
— http://www.cocoanetics.com/2012/01/genstrings2/

110

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

111

WTF!?
WTF!?

WTF!?

117

WTF!?
WTF!?

WTF!?

WTF!?

WTF!?
119

Andrey Subbotin
Вопросы? :-) eploko@yandex-team.ru
@eploko

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

Recommended

Recommended

More Related Content

What's hot

What's hot (6)

Similar to Андрей Субботин "Автоматизация локализации iOS-приложений"

Similar to Андрей Субботин "Автоматизация локализации iOS-приложений" (20)

More from Yandex

More from Yandex (20)

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