Different storyboard localization per target

Question

I have a project with 3 targets. Each target needs to suppport only one language, but the language is not the same for each target. Currently I have

• Target 1 (es)
• Target 2 (es)
• Target 3 (pt)

Most of my strings are in a Localizable.strings file, and I simply target a different file for each target. However, a number of strings are in my storyboards. My problem is that it does not seem possible to create different storyboard localization files for each target. If I change the targeting of the portuguese file, the targeting of the spanish file changes automatically.

A possible solution is to duplicate each Storyboard for each target, but this won't scale well as the number of tagets grow. I could also modify all the text with NSLocalizedString in each ViewController, but this seems tedious and error prone.

Is there a better solution?

Answer 1

Shared Storyboard across targets

While this answer is the preferred approach, you can assign different Storyboard localizations to different targets, while sharing the same Storyboard across all targets.

Prerequisites:

Follow this instructions in this answer.

Concept:

You want to have the Main.storyboard in each target, but a different Main.strings in each target. Additionally, you do not want all localizations to be available in each target.

To achieve this, you must manipulate the .lproj directly, a process which is hidden when merely using the File Inspector.

Step by step:

1. Create all the pieces by following the steps in this answer.
2. From any target, remove the Main.storyboard. Of course, select Remove Reference to keep the storyboard around.
3. In the Finder, locate Base.lproj. Drag and drop Main.storyboard back to your project, and select every target.
4. In the File Inspector, ensure that the languages are not selected, and that you are still using Localizable Strings.
5. In the Finder again, locate en.lproj, es.lproj, fr.lproj, etc. Notice that they each contain a version of Main.strings. Drag these .lproj (the entire directories) back into your project. This time, do not select any target
6. One last time, in File inspector, associate each Main.strings to the desired target. Repeat for each .strings.

Conclusion

By decoupling the .lproj from the .storyboard in the Project Navigator, you can associate files and targets freely.

Demo:

See it at work using a French target, on a device with language set to Français in the Settings:

---

► Find this solution on GitHub and additional details on Swift Recipes.

Answer 2

Shared localizations across targets

1. Assuming you already have multiple languages in your project, in the Project Navigator, select your storyboard (say Main.storyboard)

2. In the File Inspector, under Localization, add English. Pick Localizable Strings which is the default. This will create a Main.string for each language, and share your Storyboard across all languages.

   

3. Merely clicking that checkbox in step 2. will add a Main.string (English) for that language, specifically for that Main.Storyboard. Pay special attention to the new hierarchy, these are not Localizable.strings but Main.strings, derived from Main.storyboard:

   

4. Localize in each language file to your heart content.

For example, starting with a UILabel which message was in Esperanto, it will appear in English when the device runs in English:

/* Class = "UILabel"; text = "Tiu mesaĝo estas en Esperanto"; ObjectID = "acC-pA-eMt"; */
"acC-pA-eMt.text" = "This message is in English";

---

Start here to add multiple languages to your project:

In the event you need to add more languages, follow these steps:

1. In the Project Navigator, select your Project

2. In the Project and Target List, select, once again, the Project

   

3. Select the Info tab

4. Under Localizations, keep Use Base Internationalization (unless your UI itself must change across languages)

5. Click +, pick a new language. In the dialog presented to you, select every Storyboard you want to have multiple localizations for.

   

If you missed Storyboards at Step 5. you can simply add a new language to that a storyboard by following the steps in Assuming you already have multiple languages.

Answer 3

All you need: to make common xcode workspace for your app, then to create a duplicates of main xcodeproj file for your set of languages and make different targets for all of them, also then you can set language for individual project settings in new xcodeproj's. Also you easy can tune build phase 'Copy Bundle Resourses' and others. I use this method. If you have a Xcode's crash during adding project in workspace - open project with Xcode, rename it and rename or duplicate targets (I think same names cause this issue).