L10n testing with xcode

Setting up your l10n testing environment

Once you have your l10n testing environment set up in Xcode, testing your Firefox on iOS localization is a breeze.XLIFF diff screen (step 4)

  1. Follow the cloning and building instructions for Firefox on iOS.
  2. Open the Client.xcodeproj file in Xcode.
  3. Select the Client project in the left pane and choose Editor > Import Localizations from the toolbar and select your localized XLIFF file.
  4. A window will then appear showing the diff between the imported XLIFF file and the existing resources in the project folder. Click the Import button.




Xcode will import your translated strings into the project by adding them to the project folder and replacing the existing strings.

Next, you need to configure the iOS app simulator to run the app in your locale.

  1. Choose Product > Scheme > Edit Scheme from the toolbar menu.
  2. In the Edit Scheme screen, select Run from the left pane and then navigate to the Options tab.
  3. Select your language from the Application Language menu and click Close.

Tah dah! You're ready to test your localization of Firefox on iOS.




Launching & testing your Firefox on iOS localization

The iOS Simulator is fairly easy to use once you launch your app. To perform the next steps, you'll need to be familiar with how user gestures and hardware interactions work in the simulator. This guide should help.

  1. Press the Run button in the upper left-hand corner (the button has a playback icon).
  2. Navigate to the newly opened iOS Simulator window
  3. Many strings are accessibility strings and are only revieled when a user hovers their finger over the button. To view these strings, you'll need to start the Accessibility Inspector within the iOS Simulator by doing the following.
    1. In the iOS Simulator, press the Home button from the Hardware toolbar menu.
    2. Navigate to the Settings app, open it, and go to General > Accessibility.
    3. Slide the Accessibility Inspector switch to On. The Accessibility Inspector remains active until you turn it off, even if you quit and restart iOS Simulator.
    4. Press the Home button again, navigate to the pane with your Firefox for iOS localization on it, and reopen Firefox.
  4. Now, you can navigate through the Firefox app in the iOS Simulator, viewing both UI elements and accessibility strings as you go.

Congratulations, now your testing your app! See, that wasn't so hard, right?

Document Tags and Contributors

 Contributors to this page: jbeatty
 Last updated by: jbeatty,