Today we'll continue our localization series with a lesser-known Xcode feature that makes the process of translating our apps easier. Usually we won't be translating our apps ourselves, at least not into all the languages we want to support.
It's common to send our strings off to a third-party service, who will translate them and return them to us. Let's get started.
In Bite #181, we enabled the basic localization features of Xcode. As we work on our app, we'll add new strings:
button.setTitle( NSLocalizedString("fly-here", comment: "Fly Here"), forState: .Normal)
When we do, we could manually add the new key to all of the different language versions of our Localizable.strings file.
We could also generate a brand new Localizable.strings file using Apple's
genstrings command-line tool. Running
gentrings *swift in our project's root directory will scan our code and generate a new Localizable.strings file with all the NSLocalizedString keys we've used.
That sounds like it could lead to lots of manual diff'ing.
It turns out that Xcode itself actually has a more powerful feature that can export our strings for translation with almost no manual labor. It pulls from all our Storyboards, .xibs, and scans our code for NSLocalizedStrings.
To use it, we'll select our project at the top of the Project Navigator, and then select Editor > Export for Localization... This will export a folder full of
.xliff files for all the languages we've added to our project in Xcode.
This format is standard for most translation services. We'll find a service, then upload these files to them. They'll return us a similar set of files, filled with our translated strings. When they do we'll select Editor > Import Localizations... option then import them back into Xcode.