Xcode 7 UITests with localized UI Xcode 7 UITests with localized UI ios ios

Xcode 7 UITests with localized UI


Option 1: Set a Default Language

Create a new scheme for UI Testing and set the default Application Language. This will lock the app into one localized file so you can write all of your tests for that language.

Set the option from Product -> Scheme -> Manage Schemes or ⌘⇧,. Then select the Options tab and set the language.

Xcode - Set the Default Application Language

Pros: Simple, one-time change.

Cons: Cannot be used to create localized screenshots with snapshot (a tool that runs your app via UI Testing and generates App Store screenshots along the way).

Option 2: Use -accessibilityIdentifier for Localized Strings

Instead of accessing items via their displayed text or value, use accessibilityIdentifier. This is read by the UI Testing framework but never shown or read to users (even with accessibility turned on). In the old UIAutomation docs Apple mentions using this for developer functionality, which this seams like a good use case.

You can then continue to set accessibilityLabel and accessibilityValue like normal, with the localized versions.

Pros: Can be used for more generic solutions, such as taking automated screenshots.

Cons: Might require more work changing each label you need "unlocalized" for testing.


I wanted to actually test the content of UI features and not just their existence, so setting a default language or using the accessibility identifiers wouldn't suit.

This builds on Volodymyr's and matsoftware's answers. However their answers rely on deviceLanguage which needs to be explicitly set in SnapshotHelper. This solution dynamically gets the actual supported language the device is using.

  1. Add the Localizable.strings files to your UITest target.
  2. Add the following code to your UITest target:

    var currentLanguage: (langCode: String, localeCode: String)? {    let currentLocale = Locale(identifier: Locale.preferredLanguages.first!)    guard let langCode = currentLocale.languageCode else {        return nil    }    var localeCode = langCode    if let scriptCode = currentLocale.scriptCode {        localeCode = "\(langCode)-\(scriptCode)"    } else if let regionCode = currentLocale.regionCode {        localeCode = "\(langCode)-\(regionCode)"    }    return (langCode, localeCode)}func localizedString(_ key: String) -> String {    let testBundle = Bundle(for: /* a class in your test bundle */.self)    if let currentLanguage = currentLanguage,        let testBundlePath = testBundle.path(forResource: currentLanguage.localeCode, ofType: "lproj") ?? testBundle.path(forResource: currentLanguage.langCode, ofType: "lproj"),        let localizedBundle = Bundle(path: testBundlePath)    {        return NSLocalizedString(key, bundle: localizedBundle, comment: "")    }    return "?"}
  3. Access the method by localizedString(key)

For those languages with a script code, the localeCode will be langCode-scriptCode (for example, zh-Hans). Otherwise the localeCode will be langCode-regionCode (for example, pt-BR). The testBundle first tries to resolve the lproj by localeCode, then falls back to just langCode.

If it still can't get the bundle, it returns "?" for the string, so it will fail any UI tests that look for specific strings.


YOU CAN RE-USE YOUR PROJECT LOCALIZATION BUNDLES!

When you test message boxes behaviour you need to know exactly what message box just appeared. You need to copy your localization from another scheme during build phase.

In your UI Tests target -> Build Phases -> Copy Bundle Resources, add the localization files needed (e.g. Localizable.strings).

Add a function similar to the following:

func localizedString(key:String) -> String {/*1*/ let localizationBundle = NSBundle(path: NSBundle(forClass: /*2 UITestsClass*/.self).pathForResource(deviceLanguage, ofType: "lproj")!) /*3*/ let result = NSLocalizedString(key, bundle:localizationBundle!, comment: "") //     return result}/*1 Gets correct bundle for the localization file, see here: http://stackoverflow.com/questions/33086266/cant-get-access-to-string-localizations-in-ui-test-xcode-7 *//*2 Replace this with a class from your UI Tests /*3 Gets the localized string from the bundle */

Then in your code you can use app.buttons[localizedString("localized.string.key")]

Full article is here: https://github.com/fastlane-old/snapshot/issues/321#issuecomment-159660882