Localizing with Xcode 9

Transcription

1 Session Developer Tools #WWDC17 Localizing with Xcode Sara Radi, Software Engineer Aya Siblini, Software Engineer Chris Hanson, Software Engineer 2017 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.

2

3

4

5

6

7 Agenda

8 Agenda Internationalization

9 Agenda Internationalization Xcode Localization Workflow

10 Agenda Internationalization Xcode Localization Workflow Testing

11 Internationalization Sara Radi, Software Engineer

12

13

14

15

16 Strings Management Formatting User Interface

17 Strings Management

18 Strings Management Prepare your strings for translation

19 Strings Management Prepare your strings for translation Use NSLocalizedString to load strings in code

20 Strings Management Prepare your strings for translation Use NSLocalizedString to load strings in code Use localizedstringwithformat to get a localized formatted string

21 // Set a label's text label.text = "Population" // Set a label's text to a localized string label.text = NSLocalizedString("Population", comment: "Label preceding the population value") // Load localized string from a specific table label.text = NSLocalizedString("Population", tablename: "Localizable", bundle:.main, value: nil, comment: "Label preceding the population value") // Create a formatted string let format = NSLocalizedString("%d popular languages", comment: "Number of popular languages") label.text = String.localizedStringWithFormat(format, popularlanguages.count)

22 // Set a label's text label.text = "Population" // Set a label's text to a localized string label.text = NSLocalizedString("Population", comment: "Label preceding the population value") // Load localized string from a specific table label.text = NSLocalizedString("Population", tablename: "Localizable", bundle:.main, value: nil, comment: "Label preceding the population value") // Create a formatted string let format = NSLocalizedString("%d popular languages", comment: "Number of popular languages") label.text = String.localizedStringWithFormat(format, popularlanguages.count)

23 // Set a label's text label.text = "Population" // Set a label's text to a localized string label.text = NSLocalizedString("Population", comment: "Label preceding the population value") // Load localized string from a specific table label.text = NSLocalizedString("Population", tablename: "Localizable", bundle:.main, value: nil, comment: "Label preceding the population value") // Create a formatted string let format = NSLocalizedString("%d popular languages", comment: "Number of popular languages") label.text = String.localizedStringWithFormat(format, popularlanguages.count)

24 // Set a label's text label.text = "Population" // Set a label's text to a localized string label.text = NSLocalizedString("Population", comment: "Label preceding the population value") // Load localized string from a specific table label.text = NSLocalizedString("Population", tablename: "Localizable", bundle:.main, value: nil, comment: "Label preceding the population value") // Create a formatted string let format = NSLocalizedString("%d popular languages", comment: "Number of popular languages") label.text = String.localizedStringWithFormat(format, popularlanguages.count)

25 // Set a label's text label.text = "Population" // Set a label's text to a localized string label.text = NSLocalizedString("Population", comment: "Label preceding the population value") // Load localized string from a specific table label.text = NSLocalizedString("Population", tablename: "Localizable", bundle:.main, value: nil, comment: "Label preceding the population value") // Create a formatted string let format = NSLocalizedString("%d popular languages", comment: "Number of popular languages") label.text = String.localizedStringWithFormat(format, popularlanguages.count)

26 Strings Management fr.lproj/localizable.strings /* Title label's text */ "International Facts" = "Faits Internationaux"; /* Label prompting a user to choose a territory */ "Territory" = "Territoire";

27 Strings Management Static analyzer

28 Strings Management Static analyzer (UITableViewCell *)tableview: (UITableView *)tableview cellforrowatindexpath: (NSIndexPath *)indexpath { UITableViewCell *cell = [tableview dequeuereusablecellwithindentifier:@"cell" forindexpath:indexpath]; cell.textlable.text } return cell; Thread Sanitizer and Static Analysis WWDC 2016

29 Strings Management Formatting User Interface

30

31

32 Formatters Date and time let formatter = DateFormatter() formatter.dateformat = "EEEE, MMMM d, yyyy" let str = formatter.string(from: date)

33 Formatters Date and time let formatter = DateFormatter() formatter.dateformat = "EEEE, MMMM d, yyyy" let str = formatter.string(from: date)

34 Formatters Date and time let formatter = DateFormatter() formatter.dateformat = "EEEE, MMMM d, yyyy" let str = formatter.string(from: date) let formatter = DateFormatter() formatter.datestyle =.full let str = formatter.string(from: date)

35

36 Formatters DateFormatter DateComponentsFormatter DateIntervalFormatter PersonNameComponentsFormatter NumberFormatter ByteCountFormatter EnergyFormatter LengthFormatter MassFormatter MeasurementFormatter Measurements and Units WWDC 2016 Internationalization Best Practices WWDC 2016

37 Strings Management Formatting User Interface

38 User Interface Base internationalization

39 Localized Resources Structure

40 Localized Resources Structure Project

41 Localized Resources Structure Project Base.lproj

42 Localized Resources Structure Project ru.lproj en.lproj Base.lproj

43 Localized Resources Structure Project ru.lproj en.lproj Base.lproj Launch.xib Main.storyboard Image

44 Localized Resources Structure Project ru.lproj en.lproj Base.lproj Main.stringsdict Launch.strings Main.strings Launch.strings Launch.xib Main.storyboard Image

45 User Interface Auto Layout What s New in Auto Layout WWDC 2016 Auto Layout Techniques in Interface Builder WWDC 2016

46 User Interface Localization warnings NEW

47 User Interface Pseudolocalization NEW Default Lorem Ipsum Double Length Lorem Ipsum Lorem Ipsum Accented Latin Affixed Strings Right to Left L o r ëm I p şu m [#Lorem Ipsum#] muspi merol

48 Demo Prepare your app for localization Aya Siblini, Software Engineer

49 Summary

50 Summary Use standard APIs to handle the complexity of data formatting

51 Summary Use standard APIs to handle the complexity of data formatting Use base internationalization and Auto Layout

52 Summary Use standard APIs to handle the complexity of data formatting Use base internationalization and Auto Layout Validate your strings and UI

53 Localization Workflow Sara Radi, Software Engineer

54 Localization

55 Localization Process

56 Localization Process Source Code

57 Localization Process Source Code Resources

58 Localization Process Source Code Resources Export French Russian Spanish

59 Localization Process Source Code Resources Export French Russian Spanish Import Localized Resources

60 Localization Process Source Code Resources Export French Russian Spanish Import Localized Resources

61 Localization Process Source Code Resources Export French Russian Spanish Import Localized Resources

62 Localization Process NEW Source Code Resources Export French Russian Spanish Import Localized Resources

63 Stringsdict NEW

64 Handling Plurals Adaptive Strings Localization Export and Import Other Resources

65 Stringsdict Plurals if popularlanguages.count == 1 { label.text = String.localizedStringWithFormat(NSLocalizedString("1 popular language", comment: "The list contains only one language")) } else { label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count) }

66 Stringsdict Plurals if popularlanguages.count == 1 { label.text = String.localizedStringWithFormat(NSLocalizedString("1 popular language", comment: "The list contains only one language")) } else { label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count) }

67 Stringsdict Plurals if popularlanguages.count == 1 { label.text = String.localizedStringWithFormat(NSLocalizedString("1 popular language", comment: "The list contains only one language")) } else { label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count) }

68 Stringsdict Plurals

69 Stringsdict Plurals English 1 popular language 2 popular languages 5 popular languages

70 Stringsdict Plurals English 1 popular language Russian Распространенных языков: 1 2 popular languages Распространенных языков: 2 5 popular languages Распространенных языков: 5

71 Stringsdict Plurals label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count)

72 Stringsdict Plurals label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count)

73 Stringsdict Plurals label.text = String.localizedStringWithFormat(NSLocalizedString("%d popular languages", comment: "The list contains more than one language"), popularlanguages.count)

74 Stringsdict Plurals

75 Stringsdict Plurals Russian Распространенных языков: 1 Распространенных языков: 2 Распространенных языков: 5

76 Stringsdict Plurals Russian Russian Распространенных языков: 1 1 распространенный язык Распространенных языков: 2 2 распространенных языка Распространенных языков: 5 5 распространенных языков

77 Handling Plurals Adaptive Strings Localization Export and Import Handling Other Resources

78

79

80

81

82

83

84 Stringsdict Adaptive Strings NEW

85 Stringsdict Adaptive Strings NEW label.text = NSLocalizedString("GDP", comment: "A territory's GDP (Gross Domestic Product)")

86 Stringsdict Adaptive Strings NEW label.text = NSLocalizedString("GDP", comment: "A territory's GDP (Gross Domestic Product)") let widthformattedstring = string.variantfittingpresentationwidth(20)

87 Stringsdict Adaptive Strings NEW label.text = NSLocalizedString("GDP", comment: "A territory's GDP (Gross Domestic Product)") let widthformattedstring = string.variantfittingpresentationwidth(20)

88

89

90

91

92

93

94 Handling Plurals Adaptive Strings Localization Export and Import Other Resources

95 Export XLIFF

96 Import XLIFF

97 Handling Plurals Adaptive Strings Localization Export and Import Other Resources

98 Other Resources

99 Other Resources

100 Other Resources

101 Demo Localization export and import Chris Hanson, Software Engineer

102 Summary

103 Summary Use stringsdict for plurals and width variants

104 Summary Use stringsdict for plurals and width variants Export XLIFF for localization

105 Summary Use stringsdict for plurals and width variants Export XLIFF for localization Import localized XLIFF

106 Summary Use stringsdict for plurals and width variants Export XLIFF for localization Import localized XLIFF Localize non-string resources in Xcode

107 Summary Use stringsdict for plurals and width variants Export XLIFF for localization Import localized XLIFF Localize non-string resources in Xcode

108 Testing Aya Siblini, Software Engineer

109 Testing XCTest NEW

110 Testing XCTest NEW

111 Testing UI testing

112 Testing UI testing app.tables.cells.statictexts["territory"].tap()

113 Testing UI testing app.tables.cells.statictexts["territory"].tap()

114 Testing UI testing app.tables.cells.statictexts["territory"].tap() Use accessibilityidentifier app.tables.cells["territorytablecell"].tap()

115 Testing UI testing app.tables.cells.statictexts["territory"].tap() Use accessibilityidentifier app.tables.cells["territorytablecell"].tap()

116 Testing UI testing Set accessibilityidentifier button.accessibilityidentifier = "startbutton"

117 Testing UI testing

118 Testing UI testing NEW Use accessibility identifiers Use XCTAttachment to collect screenshots Get full coverage of UI for all localizations What s New in Testing Hall 2 Thursday 3:10PM Engineering for Testability Hall 3 Friday 1:50PM

119 Demo Testing Aya Siblini, Software Engineer

120 Summary

121 Summary Prepare your app for localization

122 Summary Prepare your app for localization Validate your app s readiness

123 Summary Prepare your app for localization Validate your app s readiness Export localizable content to be translated

124 Summary Prepare your app for localization Validate your app s readiness Export localizable content to be translated Import localized content

125 Summary Prepare your app for localization Validate your app s readiness Export localizable content to be translated Import localized content Use XCTest to test your localized app

126 More Information

127 Related Sessions Advances in TVMLKit Grand Ballroom B Tuesday 11:20AM What s New in Testing Hall 2 Thursday 3:10PM Localizing Content for Swift Playgrounds Grand Ballroom A Thursday 3:10PM Auto Layout Techniques in Interface Builder Hall 3 Friday 9:00AM The Keys to a Better Text Input Experience Grand Ballroom B Friday 11:00AM Building Apps with Dynamic Type Executive Ballroom Friday 1:50PM Engineering for Testability Hall 3 Friday 1:50PM Localization Best Practices on tvos WWDC 2017 Video

128 Labs Introduction to Interface Builder Lab Technology Lab E Tue 12:00PM-3:10PM Internationalization Lab Technology Lab I Tue 1:50PM-4:10PM Advanced Interface Builder and Auto Layout Lab Technology Lab K Wed 3:10PM-6:00PM Internationalization Lab Technology Lab I Fri 9:00AM-1:50PM Advanced Interface Builder and Auto Layout Lab Technology Lab K Fri 12:00PM-1:50PM

129