localizing strings
LOCALIZATION AND ACCESSIBILITY
AGENDA Localizing Strings Localizing Storyboards Testing Localization Locales Accessibility
LOCALIZING STRINGS
LOCALIZING STRINGS Requires developer to use specific API to retrieve strings in code Additionally need .strings file with translation for each language
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 1 Generate a localized strings file using the following command: find . -name \*.swift | xargs genstrings -o .
Searches for all occurrences of NSLocalizedString and extracts keys and comments into a separate file
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 2 Add the Localizable.strings file to your project:
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 3 Add a new language to your project:
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 4 Add a new localization to your Localizable.strings file:
LOCALIZING STRINGS IN CODE // Shortest version of NSLocalizedString; comment is used to inform translator // about the role of this string mainLabel.text = NSLocalizedString("com.makeschool.helloString", comment: "The string that greets the user") // Longest version of NSLocalizedString; You can choose which strings file from which // bundle you want to use. You can also provide a default translation value in case // the key cannot be found in the table mainLabel.text = NSLocalizedString("com.makeschool.helloString", tableName: "Other", bundle: NSBundle.mainBundle(), value: "Hello World", comment: "The string that greets the user")
LOCALIZING STORYBOARDS
LOCALIZING STORYBOARDS
TESTING LOCALIZATION
TESTING LOCALIZATION
TESTING LOCALIZATION
TESTING LOCALIZATION
LOCALES
LOCALES Besides the language, the region we live in influences localization Examples: Date formatting, currency symbols, time zones
LOCALES dateLabel.text = NSDateFormatter.localizedStringFromDate(NSDate(), dateStyle: .MediumStyle, timeStyle: .MediumStyle)
German Locale (de-DE)
US Locale (en-US)
23.10.2015, 08:35:31
Oct 23, 2015, 8:26:12 AM
ACCESSIBILITY
ACCESSIBILITY Very important when building custom views! They are not accessible by default: self.isAccessibilityElement = true
Can enhance standard view components by providing hints, labels, traits and values
ACCESSIBILITY accessibilityLabel short description of the control, e.g. “Save” for button, “Rating” for label accessibilityHint helps the user to understand results of an action. E.g. “Saves the Document”, “Clears the text”
ACCESSIBILITY accessibilityTraits collection of constants that describe the type of control and/or how it should be treated, e.g: UIAccessibilityTraitImage, UIAccessibilityTraitNotEnabled, etc. accessibilityValue Used to describe the value of a none-label UI component. E.g. “50%” for a progress bar. “9 out of 10” for a rating view.
ACCESSIBILITY
Accessibility parameters can be defined in Interface Builder and in code!
SUMMARY
SUMMARY Localization and Accessibility are important to make your app available to a broader audience Xcode / iOS provide tooling that allow you to implement localization and accessibility with very little effort
ADDITIONAL RESOURCES
ADDITIONAL RESOURCES Apple: Internationalization and Localization Guide Apple: Formatting Data Using the Locale Setting AltConf Talk: Localization on iOS Apple: Accessibility Programming Guide for iOS UIAccessibility Class Reference
AGENDA Localizing Strings Localizing Storyboards Testing Localization Locales Accessibility
LOCALIZING STRINGS
LOCALIZING STRINGS Requires developer to use specific API to retrieve strings in code Additionally need .strings file with translation for each language
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 1 Generate a localized strings file using the following command: find . -name \*.swift | xargs genstrings -o .
Searches for all occurrences of NSLocalizedString and extracts keys and comments into a separate file
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 2 Add the Localizable.strings file to your project:
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 3 Add a new language to your project:
ADDING LOCALIZED STRINGS TO YOUR PROJECT - 4 Add a new localization to your Localizable.strings file:
LOCALIZING STRINGS IN CODE // Shortest version of NSLocalizedString; comment is used to inform translator // about the role of this string mainLabel.text = NSLocalizedString("com.makeschool.helloString", comment: "The string that greets the user") // Longest version of NSLocalizedString; You can choose which strings file from which // bundle you want to use. You can also provide a default translation value in case // the key cannot be found in the table mainLabel.text = NSLocalizedString("com.makeschool.helloString", tableName: "Other", bundle: NSBundle.mainBundle(), value: "Hello World", comment: "The string that greets the user")
LOCALIZING STORYBOARDS
LOCALIZING STORYBOARDS
TESTING LOCALIZATION
TESTING LOCALIZATION
TESTING LOCALIZATION
TESTING LOCALIZATION
LOCALES
LOCALES Besides the language, the region we live in influences localization Examples: Date formatting, currency symbols, time zones
LOCALES dateLabel.text = NSDateFormatter.localizedStringFromDate(NSDate(), dateStyle: .MediumStyle, timeStyle: .MediumStyle)
German Locale (de-DE)
US Locale (en-US)
23.10.2015, 08:35:31
Oct 23, 2015, 8:26:12 AM
ACCESSIBILITY
ACCESSIBILITY Very important when building custom views! They are not accessible by default: self.isAccessibilityElement = true
Can enhance standard view components by providing hints, labels, traits and values
ACCESSIBILITY accessibilityLabel short description of the control, e.g. “Save” for button, “Rating” for label accessibilityHint helps the user to understand results of an action. E.g. “Saves the Document”, “Clears the text”
ACCESSIBILITY accessibilityTraits collection of constants that describe the type of control and/or how it should be treated, e.g: UIAccessibilityTraitImage, UIAccessibilityTraitNotEnabled, etc. accessibilityValue Used to describe the value of a none-label UI component. E.g. “50%” for a progress bar. “9 out of 10” for a rating view.
ACCESSIBILITY
Accessibility parameters can be defined in Interface Builder and in code!
SUMMARY
SUMMARY Localization and Accessibility are important to make your app available to a broader audience Xcode / iOS provide tooling that allow you to implement localization and accessibility with very little effort
ADDITIONAL RESOURCES
ADDITIONAL RESOURCES Apple: Internationalization and Localization Guide Apple: Formatting Data Using the Locale Setting AltConf Talk: Localization on iOS Apple: Accessibility Programming Guide for iOS UIAccessibility Class Reference
