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

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

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

eploko@yandex-team.ru@eploko

Зачем?

Как это? Кто?

Что это?

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

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

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

Can't read,won't buy.

52,4% не покупают продукт на чужом языке.

60% — для Франции, Японии и России.

89,3% — если английский знают плохо.

http://bit.ly/whylocalize

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

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

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

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

местности

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

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

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

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

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

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

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

XIB-файлы.

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

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

en.lproj

ru.lproj

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

= ваш друг!

NSLocalizedString

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

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

= тоже ваш друг!

NSFormatter

→ Data Formatting Guide

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

*.m → Localizable.strings

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

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

ru.lproj/Localizable.strings

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

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

*.xib → *.strings

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

"8.normalTitle" = "Welcome!";

en.lproj/ViewController.strings

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

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

*.strings → *.xib

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

Создали en.XIB.

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

Локализовали en.XIB → ru.XIB.Добавили новую кнопку в en.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

en.xib → ru.xib

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

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

Переводчики

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

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

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

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

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

но редко.

Вместе с вами,

Очень часто

по e-mail.

+1 к карме

translations.launchpad.net

Tanker

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

Babelfish

Babelyoda

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

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

минимуму

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

в Tanker

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

обновляетXIB файлы

аккуратно всекоммитит в git

PROFIT!!

Babelyoda

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

Babelfile

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

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

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

One command to rule them all!

$ rake babelyoda

$ rake -Trake babelyodarake babelyoda:create_keysetsrake babelyoda:drop_empty_stringsrake babelyoda:drop_orphan_keysrake babelyoda:drop_orphan_keysetsrake babelyoda:extractrake babelyoda:extract_stringsrake babelyoda:extract_xib_stringsrake babelyoda:fetch_stringsrake babelyoda:initBabelfilerake babelyoda:localize_xibsrake babelyoda:pullrake babelyoda:pushrake babelyoda:remote:drop_keysetsrake babelyoda:remote:listrake babelyoda:verify

#!/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

yxbuildkit-prebuild.sh

https://github.com/eploko/babelyoda

Available on GitHub!

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

хоррор стори

I scanned 12 directories.

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

I scanned 1 directories.

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

I scanned 1 directory.

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

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

"I scanned %g %@."

"directory"

"directories"

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

"папка"

"каталоги"

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

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

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

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

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

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

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

"%d change"

"%d changes"

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

"NumberChanges0"

"NumberChanges3"

"NumberChanges2"

"NumberChanges1"

genstrings “магия”

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

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

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

Localizable.strings

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

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

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

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

"%[some]d changes"

“Хитрости”

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

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

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

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

WelcomeButtonTitleWelcomeTitleButtonTitleWelcomeWelcomeTITLEWelcomeBtnTitle

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

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

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

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

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

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

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

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

へやへ：５人

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

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

へやへ：５人

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

Linguan

Wincent Strings Utility

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

genstrings2

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

“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

WTF!? WTF!?

Andrey Subbotin

eploko@yandex-team.ru

@eploko

Вопросы? :-)

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

Documents

Transcript of Андрей Субботин "Автоматизация локализации...

КАЗАХСТАН – ПРИОРИТЕТЫ ЛОКАЛИЗАЦИИ

программа локализации потерь природного газа

Автоматизация проката

АВТОМАТИЗАЦИЯ УЧЕТА

«Автоматизация продаж»

Автоматизация Макдональдс

5 шагов локализации в России - SCHNEIDER GROUP...Налоги и право 4. Выбор места для локализации 5. Реализация Шаг

Автоматизация склада

Андрей Субботин "Локализация приложений для iOS: как не прострелить себе ногу"

презентация программы локализации потерь газа

Грязная автоматизация

Проблема локализации мобильного робота

Локализация программных продуктов и тестирование локализации

Автоматизация Ш

Автоматизация Продаж

автоматизация ц

АВТОМАТИЗАЦИЯ СТОЛОВОЙ

автоматизация залов

Автоматизация выставок

Автоматизация такси