Localizing with Xcode 6

Transcription

1 Tools #WWDC14 Localizing with Xcode 6 Best practices and new workflows Session 412 Zoltan Foley-Fisher Xcode Software Engineer! Chris Hanson Xcode Software Engineer 2014 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.

2

3

4 Agenda

5 Agenda Localization Frameworks on OS X and ios

6 Agenda Localization Frameworks on OS X and ios Xcode Workflows for Localization

7 Internationalization and Localization

8 Internationalization and Localization Step 1 Step 2 App Data Hindi in India Localizable Data Spanish in Mexico

9 Languages and Regions

10 Languages and Regions

11 Languages and Regions

12 Languages and Regions

13 Languages and Regions

14 App Data Internationalization Preparing your App Localizable Data

15 Framework Support

16 Framework Support Localization support is pervasive in the system frameworks

17 Framework Support Localization support is pervasive in the system frameworks Separates localizable data from the rest of your app

18 Framework Support Localization support is pervasive in the system frameworks Separates localizable data from the rest of your app Images, sounds, movies, documentation

19 Framework Support Localization support is pervasive in the system frameworks Separates localizable data from the rest of your app Images, sounds, movies, documentation User-facing text

20 Framework Support Localization support is pervasive in the system frameworks Separates localizable data from the rest of your app Images, sounds, movies, documentation User-facing text even in your source code!

21 Framework Support Localization support is pervasive in the system frameworks Separates localizable data from the rest of your app Images, sounds, movies, documentation User-facing text even in your source code! Extremely simple to use

22 NSLocalizedString()

23 NSLocalizedString() Internationalize strings for your interface in your source code

24 NSLocalizedString() Internationalize strings for your interface in your source code Lets you keep nice strings in your code, including format strings

25 NSLocalizedString() Internationalize strings for your interface in your source code Lets you keep nice strings in your code, including format strings No explicit loading/management of localized strings needed at runtime

26 NSLocalizedString() Internationalize strings for your interface in your source code Lets you keep nice strings in your code, including format strings No explicit loading/management of localized strings needed at runtime Easily keep separate string tables with NSLocalizedStringFromTable()

27 NSLocalizedString() label.text = [NSString is %d meters tall", mountain.name, mountain.height];

28 NSLocalizedString() label.text = [NSString stringwithformat: NSLocalizedString(@"%@ is %d meters and height (in meters) of a mountain"), mountain.name, mountain.height];!

29 NSLocalizedString() label.text = [NSString localizedstringwithformat: NSLocalizedString(@"%@ is %d meters and height (in meters) of a mountain"), mountain.name, mountain.height];!

30 NSLocalizedString() label.text = String.localizedStringWithFormat( NSLocalizedString("%@ is %d meters tall", comment:"name and height (in meters) of a mountain"), mountain.name, mountain.height)

31 Localizable.strings /* Name and height (in meters) of a mountain */ "%@ is %d meters tall" = "%1$@ is %2$d meters tall";

32 Localizable.strings /* Name and height (in meters) of a mountain */ "%@ is %d meters tall" = "%1$@ is %2$d meters tall";

33 Localizable.strings /* Name and height (in meters) of a mountain */ "%@ is %d meters tall" = "%1$@ is %2$d meters tall";

34 Localizable.strings /* Name and height (in meters) of a mountain */ "%@ is %d meters tall" = "%1$@ is %2$d meters tall";

35 Localizable.strings /* Name and height (in meters) of a mountain */ "%@ is %d meters tall" = "%2$d meters is the height of %1$@";

36 NSFormatter

37 NSFormatter Converts between objects and human-readable text

38 NSFormatter Converts between objects and human-readable text For both presenting and interpreting text

39 NSFormatter Converts between objects and human-readable text For both presenting and interpreting text Uses the current locale by default

40 NSFormatter NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; formatter.datestyle = NSDateFormatterMediumStyle; formatter.timestyle = NSDateFormatterNoStyle;

41 NSFormatter NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; formatter.datestyle = NSDateFormatterMediumStyle; formatter.timestyle = NSDateFormatterNoStyle;

42 NSFormatter NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; formatter.datestyle = NSDateFormatterMediumStyle; formatter.timestyle = NSDateFormatterNoStyle;

43 NSFormatter NSDateFormatter *formatter = [[NSDateFormatter alloc] init]; formatter.datestyle = NSDateFormatterMediumStyle; formatter.timestyle = NSDateFormatterNoStyle;! NSDate *date = mountain.latestclimb.date; label.text = [formatter stringfromdate:date];

44 NSFormatter let formatter = NSDateFormatter() formatter.datestyle =.MediumStyle formatter.timestyle =.NoStyle! let date = mountain.latestclimb.date label.text = formatter.stringfromdate(date)

45 NSFormatter

46 NSFormatter Dates, date components, and date/time intervals

47 NSFormatter Dates, date components, and date/time intervals Numbers, currency, and byte counts

48 NSFormatter Dates, date components, and date/time intervals Numbers, currency, and byte counts Health-related quantities

49 NSFormatter Dates, date components, and date/time intervals Numbers, currency, and byte counts Health-related quantities Energy

50 NSFormatter Dates, date components, and date/time intervals Numbers, currency, and byte counts Health-related quantities Energy Length

51 NSFormatter Dates, date components, and date/time intervals Numbers, currency, and byte counts Health-related quantities Energy Length Mass

52 NSBundle

53 NSBundle Standard way to access resources in your app

54 NSBundle Standard way to access resources in your app Uses the most appropriate resource for current language and region

55 NSBundle Standard way to access resources in your app Uses the most appropriate resource for current language and region Directly supported by Xcode

56 NSBundle NSURL *imageurl = [[NSBundle mainbundle] URLForResource:@"GameMenu" withextension:@"png"];! UIImage *image = [UIImage imagewithcontentsoffile:imageurl.path];! attentionicon.image = image;

57 NSBundle attentionicon.image = [UIImage imagenamed:@"gamemenu"];

58 NSBundle NSURL *welcomeurl = [[NSBundle mainbundle] URLForResource:@"Welcome" withextension:@"m4a"];! AVAudioPlayer *player = [[AVAudioPlayer alloc] initwithcontentsofurl:welcomeurl error:&error];

59 NSBundle let welcomeurl = NSBundle.mainBundle().URLForResource("Welcome", withextension:"m4a")! let player = AVAudioPlayer(contentsOfURL:welcomeURL, error:&error)

60 Xcode

61 Xcode Use base internationalization and Auto Layout to internationalize your interface

62 Xcode Use base internationalization and Auto Layout to internationalize your interface Localize other project resources as needed

63 Xcode Use base internationalization and Auto Layout to internationalize your interface Localize other project resources as needed Preview your app when running and within Xcode

64 Base Internationalization

65 Base Internationalization Works with Auto Layout to keep user-facing text distinct from the interface objects themselves

66 Base Internationalization Works with Auto Layout to keep user-facing text distinct from the interface objects themselves No need to adjust every xib or storyboard file for every supported localization

67 Other Resources Graphic Placement Guide

68 Other Resources Images Graphic Placement Guide

69 Other Resources Images Sounds Graphic Placement Guide

70 Other Resources Images Sounds Movies Graphic Placement Guide

71 Other Resources Images Sounds Movies Documentation Graphic Placement Guide

72 Other Resources Images Sounds Movies Documentation Graphic Placement Guide any other kind of resource, really!

73 Other Resources Xcode and your App Graphic Placement Guide

74 Debug-Time Preview

75 Debug-Time Preview

76 Design-Time Preview

77 Design-Time Preview

78 Design-Time Preview

79 Internationalization Step 1 Identify strings for translations Use base internationalization and Auto Layout App Data Localize other project resources Localizable Data

80 Demo Internationalizing your project Chris Hanson Xcode Software Engineer

81 Internationalization Summary

82 Internationalization Summary Let the frameworks do the heavy lifting in your code

83 Internationalization Summary Let the frameworks do the heavy lifting in your code Use the debug-time preview to check region support

84 Internationalization Summary Let the frameworks do the heavy lifting in your code Use the debug-time preview to check region support Take advantage of design-time preview via base internationalization

85 Internationalization Summary Let the frameworks do the heavy lifting in your code Use the debug-time preview to check region support Take advantage of design-time preview via base internationalization Localize other project resources as necessary

86 Localization Translating Your App Hindi in India Spanish in Mexico

87 User Facing Strings

88 User Facing Strings How to gather from your project?

89 User Facing Strings How to gather from your project? How to insert translations?

90 Export and Import Exchange user facing strings easily Project Resources Export

91 Export and Import Exchange user facing strings easily Project Resources Export

92 Export and Import Exchange user facing strings easily Project Resources Import Export Transport Format

93 Demo Localizing your project Zoltan Foley-Fisher Xcode Software Engineer

94 Command Line xcodebuild -exportlocalizations -project <project> -localizationpath <path>! xcodebuild -importlocalizations -project <project> -localizationpath <path>!

95 Summary

96 Summary Export and import Interface Builder and source strings

97 Summary Export and import Interface Builder and source strings Exchange strings in the widely accepted XLIFF format

98 App Data Iteration Updating your app Hindi in India US English Spanish in Mexico

99 Iterate on Your App

100 Iterate on Your App No need to put off localization to the end Export and import at will

101 Iterate on Your App No need to put off localization to the end Export and import at will Stay localized as you work, using previews to catch missing translations easily

102 Iterate on Your App No need to put off localization to the end Export and import at will Stay localized as you work, using previews to catch missing translations easily Prepare your app for right-to-left languages independently of translation

103 Demo Updating a localized project Chris Hanson Xcode Software Engineer

104 Summary

105 Summary Update translations as you go to keep your app current

106 Summary Update translations as you go to keep your app current Catch missing translations before your users

107 Summary Update translations as you go to keep your app current Catch missing translations before your users Simulate many different behaviors to ensure your apps work for everyone

108 Reach a Global Audience

109 Reach a Global Audience Apple's frameworks and tools make it easy!

110 Reach a Global Audience Apple's frameworks and tools make it easy! Take advantage of Xcode's new workflows

111 Reach a Global Audience Apple's frameworks and tools make it easy! Take advantage of Xcode's new workflows XLIFF export and import

112 Reach a Global Audience Apple's frameworks and tools make it easy! Take advantage of Xcode's new workflows XLIFF export and import Localization previews

113 Try It Out This Week!

114 Related Sessions Advanced Topics in Internationalization Russian Hill Tuesday 9:00AM Apps for China Get Together Folsom Wednesday 4:30PM

115 Labs Xcode and Localization Lab Tools Lab C Tuesday 2:00PM Internationalization Lab Frameworks Lab B Tuesday 3:15PM

116