Lokalisierung für Mobile Apps

Deutsche Version meines Talks auf der Developer Week 2014 in Nürnberg. über Internationalisierung und Lokalisierung mobiler Apps am Beispiel von iOS. Beleuchtet u. a. Text, Zahlen, Datum und Zeit, Bilder und andere Ressourcen. Im Bereich Text werden verschiedene Schriftsysteme und korrekte Pluralbildung beschrieben.

Transcript

1. Lokalisierung für Mobile Apps Daniel Schneller, CenterDevice GmbH
2. Agenda I18N vs. L10N Sprachen und Regionen Text Datum und Uhrzeit Zahlen Bilder und andere Ressourcen https://github.com/dschneller/I18N-Example
3. I18N vs. L10N
4. I18N L10N
5. I — 18 Zeichen — N L - 10 Zeichen - N
6. Internationalization I — 18 Zeichen — N Localization L - 10 Zeichen - N
7. Internationalization
8. Internationalization […] ein Programm so zu gestalten, dass es leicht (ohne den Quellcode ändern zu müssen) an andere Sprachen und Kulturen angepasst werden kann. * * Wikipedia
9. Localization
10. Localization Anpassung von […] Software an die in einem […] geographisch oder ethnisch umschriebenen Nutzungsgebiet […] vorherrschenden lokalen sprachlichen und kulturellen Gegebenheiten. * * Wikipedia
12. I18N L10N App Lokalisierte
 App !"#$%& ! ! !"# $%&
13. Sprachen und Regionen
14. Sprachen und Regionen Sprache ≠ Region 12h-Zeit für Amerikaner in Deutschland „Jänner“ – „Januar“ Localization ≠ Locale Deutscher bevorzugt englische Anwendungstexte Aber: 24h-Zeitformat
15. Sprachen und Regionen
16. Sprachen und Regionen
17. Sprachen und Regionen
18. Sprachen und Regionen Scheme Startparameter -AppleLanguages (ar,de,fr) Reihenfolge bestimmt Präferenz -AppleLocale en_US
19. NSLocale Kapselt aktuelle Regionaleinstellungen + (id)autoupdatingCurrentLocale
 + (id)currentLocale NSCurrentLocaleDidChangeNotification [[NSNotificationCenter defaultCenter]
 addObserver:self
 selector:@selector(localeDidChange:)
 name:NSCurrentLocaleDidChangeNotification
 object:nil] Formatter / Locale Instanzen erneuern Bildschirminhalte aktualisieren
20. NSLocale -[NSLocale objectForKey:] NSString* NSLocaleIdentifier NSString* NSLocaleMeasurementSystem NSString* NSLocaleLanguageCode NSString* NSLocaleDecimalSeparator NSString* NSLocaleCountryCode NSString* NSLocaleGroupingSeparator NSString* NSLocaleScriptCode NSString* NSLocaleCurrencySymbol NSString* NSLocaleVariantCode NSString* NSLocaleExemplarCharacterSet NSString* NSLocaleCurrencyCode NSString* NSLocaleCollatorIdentifier NSString* NSLocaleCalendar NSString* NSLocaleQuotationBeginDelimiterKey NSString* NSLocaleCollationIdentifier NSString* NSLocaleQuotationEndDelimiterKey NSString* NSLocaleUsesMetricSystem
21. NSLocale Enthält nicht die aktuelle Sprache der Anwendung! Locale ≠ Localization [NSBundle mainBundle].localizations; // NSArray, (alle) [NSBundle mainBundle].preferredLocalizations[0]; // (laufende) Caveats InfoPlist.strings Lokalisierungen bestimmen „localizations“ Schnittmenge mit Nutzerpräferenz AppleLanguages Parameter
22. Text
25. Text ≠ Text Sprache für Meldungen, Labels etc. Schreibrichtung & Alignment Schriftsysteme Zahlen in Text Namen & Adressen Phrasen, Floskeln und Begriffe Pluralbildung Sortierung …
26. Text ≠ Text Sprache für Meldungen, Labels etc. Schreibrichtung & Alignment Schriftsysteme Zahlen in Text Namen & Adressen Phrasen, Floskeln und Begriffe Pluralbildung Sortierung …
27. Base Localization
28. Base Localization Eine Leitsprache (Base)
29. Base Localization Eine Leitsprache (Base) Add Localization
30. Base Localization Eine Leitsprache (Base) Add Localization
31. Base Localization Eine Leitsprache (Base) Add Localization “.strings” Files
32. Base Localization Eine Leitsprache (Base) Add Localization “.strings” Files genstrings
33. Base Localization Eine Leitsprache (Base) Add Localization “.strings” Files genstrings ibtool
34. Base Localization Eine Leitsprache (Base) Add Localization “.strings” Files genstrings ibtool Eine Kopie pro Sprache
35. Base Localization Eine Leitsprache (Base) Add Localization “.strings” Files genstrings ibtool Eine Kopie pro Sprache “.lproj” Ordner
36. Base Localization Eine Leitsprache (Base) “.strings” Files genstrings ibtool Eine Kopie pro Sprache “.lproj” Ordner
37. Base Localization Eine Leitsprache (Base) “.strings” Files genstrings ibtool Eine Kopie pro Sprache “.lproj” Ordner
38. Base Localization Eine Leitsprache (Base) “.strings” Files genstrings ibtool Eine Kopie pro Sprache “.lproj” Ordner
39. Base Localization … /* Class = "IBUILabel"; text = "Loaded by SecondViewController"; ObjectID = "NDk-cv-Gan"; */ "NDk-cv-Gan.text" = "Loaded by SecondViewController"; " /* Class = "IBUILabel"; text = "First View"; ObjectID = "KQZ-1w-vlD"; */ "KQZ-1w-vlD.text" = "First View"; …
40. Base Localization Vorschau im Assistant Editor Xcode 6: Sprachwahl Double-Length Pseudo- Language Auto Layout
41. NSLocalizedString Makrofamilie NSLocalizedString
 NSLocalizedStringFromTable
 NSLocalizedStringFromTableInBundle
 NSLocalizedStringWithDefaultValue Zugriff auf “.strings” Files Verwendet NSBundle -[[NSBundle mainBundle] localizedStringForKey:value:table:]
42. NSLocalizedString Beispiel [button setTitle:NSLocalizedString(@"reset.counter.button.title", 
 @"Reset Counter action button")
 forState:…]; genstrings — Localizable.strings /* Reset Counter action button */
 "reset.counter.button.title" = "Zurücksetzen";
43. .strings Files Updates?
44. .strings Files Updates? Use ibtool every time you update your labels and text.
 In the Base.lproj folder:
 
 ibtool ChangedNib.xib --generate-strings- file NewStrings.strings
 
 Open the generated output file and copy all new string entries to ChangedNib.strings in each lproj. #fail
45. Texte nicht normalisieren
46. Texte nicht normalisieren DRY! — Do Repeat Yourself [NSString stringWithFormat:@”…”]
47. Texte nicht normalisieren DRY! — Do Repeat Yourself [NSString stringWithFormat:@”…”] Localizable.strings “count” = “Anzahl” “game” = “Spiel” “reset” = “zurücksetzen” “save” = “sparen” “thumbnail” = “Daumennagel”
48. Texte nicht normalisieren DRY! — Do Repeat Yourself [NSString stringWithFormat:@”…”] Localizable.strings “count” = “Anzahl” “game” = “Spiel” “reset” = “zurücksetzen” “save” = “sparen” “thumbnail” = “Daumennagel” “reset count” ”zurücksetzen Anzahl” “save game” “sparen Spiel” …
49. Texte nicht normalisieren
50. Texte nicht normalisieren Kontext und Grammatik gehen verloren
51. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau
52. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) …
53. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) … Eigene Strings für jeden Zweck
54. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) … Eigene Strings für jeden Zweck “reset.counter.button” = “Auf 0 stellen”
55. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) … Eigene Strings für jeden Zweck “reset.counter.button” = “Auf 0 stellen” Kontext für Übersetzer
56. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) … Eigene Strings für jeden Zweck “reset.counter.button” = “Auf 0 stellen” Kontext für Übersetzer Sprechende Keys
57. Texte nicht normalisieren Kontext und Grammatik gehen verloren Satzbau Wortformen (Deklination & Konjugation) … Eigene Strings für jeden Zweck “reset.counter.button” = “Auf 0 stellen” Kontext für Übersetzer Sprechende Keys Hinreichende Kommentare (Button vs. Label, ungefähre Länge etc.)
58. Variablen Parameter [NSString stringWithFormat:
 NSLocalizedString(@"click.counter.label",
 @"P1: Current Click Count."),
 self.clickCount] " /* P1: Current Click Count. */
 "click.counter.label" = "%1d x geklickt”;
59. Variablen Parameterposition dokumentieren! “Zeige 4 von 12 gesamt” “Total 12 — Showing 4” /* … Param 1: current page; Param 2: total count */
 "current.page.label" = “Zeige %1d von %2d gesamt”;
 
 /* … Param 1: current page; Param 2: total count */
 "current.page.label" = “Total %2d — Showing %1d”;
60. Sonderfälle 0 und 1 Plural Englisch Deutsch 0 No books Keine Bücher 1 One book Ein Buch sonstiges 100 books 100 Bücher Localizable.strings “books.0” = “No Books” “books.1” = “One Book” “books.n” = “%1d books” “books.0” = “Keine Bücher” “books.1” = “Ein Buch” “books.n” = “%1d Bücher” Abfrage im Code, Problem gelöst.
61. Englisch Deutsch 0 No books Keine Bücher 1 1 book 1 Buch Vielleicht nicht ganz… Plural
62. Englisch Deutsch 0 No books Keine Bücher 1 1 book 1 Buch 2 2 books 2 Bücher wenige 3 books 3 Bücher viele 11 books 11 Bücher sonstiges 100 books 100 Bücher Vielleicht nicht ganz… Plural
63. 0 1 2 wenige viele sonstiges Englisch No books 1 book 2 books 3 books 11 books 100 books Deutsch Keine Bücher 1 Buch 2 Bücher 3 Bücher 11 Bücher 100 Bücher Vielleicht nicht ganz… Plural
64. 0 1 2 wenige viele sonstiges Englisch No books 1 book 2 books 3 books 11 books 100 books Deutsch Keine Bücher 1 Buch 2 Bücher 3 Bücher 11 Bücher 100 Bücher Arabisch باتك ٠ باتك ناباتك بتك ٣ اًباتك ١١ باتك ١٠٠ Vielleicht nicht ganz… Plural
65. .strings + .stringsdict * http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html#ar
66. .strings + .stringsdict Seit iOS7 * http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html#ar
67. .strings + .stringsdict Seit iOS7 Implementiert (Unicode*) Lokalisierungsregeln für Plural Geschlecht [rdar://16670931] * http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html#ar
68. .strings + .stringsdict Seit iOS7 Implementiert (Unicode*) Lokalisierungsregeln für Plural Geschlecht [rdar://16670931] Plist Format Name identisch mit .strings .strings muss existieren, kann aber leer sein * http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html#ar
69. .strings + .stringsdict https://developer.apple.com/library/ios/releasenotes/Foundation/↩︎ RN-Foundation/index.html#//apple_ref/doc/uid/TP30000742-CH2-SW56 <dict>
 <key>files.selected.label.%d</key>
 <dict>
 <key>NSStringLocalizedFormatKey</key>
 <string>%#@num_files_are@ selected</string>
 <key>num_files_are</key>
 <dict>
 <key>NSStringFormatSpecTypeKey</key>
 <string>NSStringPluralRuleType</string>
 <key>NSStringFormatValueTypeKey</key>
 <string>d</string>
 <key>zero</key> <string>No file is</string>
 <key>one</key> <string>A file is</string>
 <key>other</key> <string>%d files are</string>
 </dict>
 </dict>
 </dict>
70. .stringsdict Kategorien pro Sprache per Unicode „zero“ geht zusätzlich in iOS immer „few“ z. B. für deutsch nicht unterstützt
71. String Tables Localizable.strings Default für NSLocalizedString() Große Projekte — große Datei Optional zerlegbar NSLocalizedStringFromTable(“MyController”, “Key”, “Comment”) MyController.strings Projektgliederung — Kontext für Übersetzer 3rd Party Code Analog für .stringsdict
72. Datum und Zeit
73. Datum und Zeit NSDateFormatter
74. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatter
75. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle NSDateFormatter
76. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA NSDateFormatter
77. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA Short 08.07.14 22:32 7/8/14,10:32 PM NSDateFormatter
78. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA Short 08.07.14 22:32 7/8/14,10:32 PM Medium 08.07.2014 22:32:36 Jul 8, 2014, 10:32:36 PM NSDateFormatter
79. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA Short 08.07.14 22:32 7/8/14,10:32 PM Medium 08.07.2014 22:32:36 Jul 8, 2014, 10:32:36 PM Long 8. Juli 2014 22:32:36 MESZ Jul 8, 2014, 10:32:36 PM GMT+2 NSDateFormatter
80. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA Short 08.07.14 22:32 7/8/14,10:32 PM Medium 08.07.2014 22:32:36 Jul 8, 2014, 10:32:36 PM Long 8. Juli 2014 22:32:36 MESZ Jul 8, 2014, 10:32:36 PM GMT+2 Full Dienstag, 8. Juli 2014 12:32:36 Mitteleuropäische Sommerzeit Tuesday, July 8, 2014 at 12:39:16 PM Central European Summer Time NSDateFormatter
81. Datum und Zeit Konvertierung zwischen NSDate und NSString +[NSDateFormatter localizedStringFromDate:dateStyle:timeStyle:]
 -[NSDateFormatter setLocale:] NSDateFormatterStyle Deutsch / Deutschland Englisch / USA Short 08.07.14 22:32 7/8/14,10:32 PM Medium 08.07.2014 22:32:36 Jul 8, 2014, 10:32:36 PM Long 8. Juli 2014 22:32:36 MESZ Jul 8, 2014, 10:32:36 PM GMT+2 Full Dienstag, 8. Juli 2014 12:32:36 Mitteleuropäische Sommerzeit Tuesday, July 8, 2014 at 12:39:16 PM Central European Summer Time No - - NSDateFormatter
82. Datum und Zeit NSDateFormatter.h typedef enum {
 NSDateFormatterNoStyle = …,
 NSDateFormatterShortStyle = …,
 NSDateFormatterMediumStyle = …,
 NSDateFormatterLongStyle = …,
 NSDateFormatterFullStyle = …
 } NSDateFormatterStyle Kombinierbar für Datum und Zeit NSDateFormatterNoStyle — nur Datum / Zeit Aktualisierung durch OS Updates NSDateFormatter
83. Datum und Zeit NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
84. Datum und Zeit Und wenn die Defaults nicht reichen? NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
85. Datum und Zeit Und wenn die Defaults nicht reichen? Keine konkreten Format-Strings verwenden! NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
86. Datum und Zeit Und wenn die Defaults nicht reichen? Keine konkreten Format-Strings verwenden! Unicode Locale Data Markup Language* NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
87. Datum und Zeit Und wenn die Defaults nicht reichen? Keine konkreten Format-Strings verwenden! Unicode Locale Data Markup Language* [f setDateFormat:[NSDateFormatter
 dateFormatFromTemplate:@"u QQ" 
 options:0
 locale:LOCALE_EN_US]];
 
 NSLog(@“%@", [f stringFromDate:july8th); NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
88. Datum und Zeit Und wenn die Defaults nicht reichen? Keine konkreten Format-Strings verwenden! Unicode Locale Data Markup Language* [f setDateFormat:[NSDateFormatter
 dateFormatFromTemplate:@"u QQ" 
 options:0
 locale:LOCALE_EN_US]];
 
 NSLog(@“%@", [f stringFromDate:july8th); Q3 2014 NSDateFormatter * http://www.unicode.org/reports/tr35/tr35-dates.html#Contents
89. Relative Zeitangaben [formatter setDoesRelativeDateFormatting:YES];
 
 NSLog(@“%@, %@, %@…", [formatter stringFromDate:GESTERN],
 [formatter stringFromDate:HEUTE],
 [formatter stringFromDate:MORGEN]);
 Gestern, Heute, Morgen… [de_DE] Yesterday, Today, Tomorrow… [en_US] Gestern, Heute, Morgen…
90. NSDateComponentsFormatter Darstellung von Zeitdauern [f stringFromTimeInterval:1234.0]) // seconds About 20 minutes remaining NSDateIntervalFormatter Darstellung von Zeiträumen [f stringFromDate:NOW toDate:LATER]) 09.07.14 12:10-13:13 Coming up next: iOS8
91. Zahlen
92. Zahlen
93. Zahlen “Einfache” Zahlen
94. Zahlen Massen Entfernungen Längen Geldbeträge Prozentsätze Datenmengen Gewichte Energie “in Worten” “Einfache” Zahlen
95. Zahlen Dezimaltrennzeichen Tausendergruppierung Währungszeichen … " NSNumberFormatter Verwendung ähnlich NSDateFormatter
96. Zahlen NSNumberFormatter Deutsch / Deutschland Englisch / USA No 1234,56 1234.56 Decimal 1.234,56 1,234.56 Currency 1.234,56 € $1,234.56 Percent 123.456% 123,456% Scientific 1,23456E+03 1.23456E3 SpellOut eintausendzweihundertvier- unddreißig Komma fünf sechs one thousand two hundred thirty- four point five six
97. Zahlen NSNumberFormatter.h enum {
 NSNumberFormatterNoStyle = …,
 NSNumberFormatterDecimalStyle = …,
 NSNumberFormatterCurrencyStyle = …,
 NSNumberFormatterPercentStyle = …,
 NSNumberFormatterScientificStyle = …,
 NSNumberFormatterSpellOutStyle = …
 }
 typedef NSUInteger NSNumberFormatterStyle
98. Zahlen NSNumberFormatter
99. Zahlen NSNumberFormatter* f = [[NSNumberFormatter alloc] init];
 f.numberStyle = NSNumberFormatterNoStyle; f.locale = LOCALE_DE_AT;
 NSLog(@"NoStyle de_AT: %@", [f stringFromNumber:@(1234.56)]); f.locale = LOCALE_EN_US;
 f.maximumFractionDigits = 2;
 NSLog(@“NoStyle en_US: %@", [f stringFromNumber:@(1234.56)]); NSNumberFormatter
100. Zahlen NSNumberFormatter* f = [[NSNumberFormatter alloc] init];
 f.numberStyle = NSNumberFormatterNoStyle; f.locale = LOCALE_DE_AT;
 NSLog(@"NoStyle de_AT: %@", [f stringFromNumber:@(1234.56)]); f.locale = LOCALE_EN_US;
 f.maximumFractionDigits = 2;
 NSLog(@“NoStyle en_US: %@", [f stringFromNumber:@(1234.56)]); NoStyle de_AT: 1235 NoStyle en_US: 1234.56 NSNumberFormatter
101. Zahlen Viele weitere Anpassungmöglichkeiten maximumFractionDigits usesSignificantDigits minimum/maximumSignificantDigits paddingCharacter roundingMode, roundingIncrement … NSNumberFormatter
102. Datenmengen NSByteCountFormatter Dateigrößen, Speichermengen Dynamische Einheiten Nicht-numerische Darstellung Allow Non-Numeric Zero KB File 1,234.57 GB Memory 1,149.78 GB
103. Coming up next: iOS8 NSEnergyFormatter Energie in Joule, Kalorien etc. NSLengthFormatter Distanzen, in Meilen, Kilometer etc. NSMassFormatter Masse und Gewicht in Pfund, kg etc.
104. Bilder u. a. Ressourcen
105. Bilder Buttons UI Elemente
106. UI Elemente -[UIImage imageNamed:@"myImage"]; Entsprechende Bilder in .lproj Ordner Funktioniert nicht für Asset Catalogues
107. Launch Image Asset Catalogue abschalten Launch Images in .lproj Ordner Typische Namenskonventionen Retina Orientierung Gerätetyp
108. Andere Ressourcen Analog zu Bildern Lookup mittels -[[NSBundle mainBundle] pathForResource:ofType:] Beispiele HTML Textfiles
109. App Name Info.plist Application has localized Display Name <key>LSHasLocalizedDisplayName</key>
 <true /> InfoPlist.strings "CFBundleDisplayName" = "国际范例";
110. Zusammenfassung
111. Cover the Basics Locale basierte Formatierung NSDateFormatter NSNumberFormatter NSByteCountFormatter Sorgfältige Übersetzung Ressourcen außerhalb des Codes nicht vergessen
112. Weitere Schritte Bildressourcen Launch Images (sofern relevant) Adressen, Namen Right-to-Left Support Automatische Auswahl von Einheiten (Meilen, km etc.) Vorbelegung für Auswahllisten etc. Farbschemata …
113. Fazit Initialer Aufwand ggf. erheblich Komplette Übersetzung Codeanpassung Workflow und Toolauswahl Andauernde Pflege überschaubar Zielgruppenrelevanz betrachten
114. Merci! Hvala! Vielen Dank! Thank You! Grazie!
115. Fragen? Daniel Schneller — @dschneller 
 daniel.schneller@centerdevice.com