Localization

About localization

The SDK ships with support for the following languages:

• English - en
• Dutch - nl
• French - fr
• German - de
• Italian - it
• Portuguese - pt
• Portuguese (Brazil) - pt-BR
• Spanish - es
• Spanish (Colombia) - es-CO
• Welsh - cy-GB

Custom localizations

If you wish to offer the SDK in a language other than English or customize any of the strings, you can create your own Localizable.strings entries in your app and override the iProov strings.

For reference, you can find the English language strings file here: Localizable.strings.

Note: Each iProov string is prefixed with "IProov_" to avoid collisions with any existing strings in your app.

Redistributing iProov with localizations

If you are redistributing iProov as a dependency within your own framework, and wish to include Localizable.strings from your framework, you must specify your framework bundle as the source of the strings. You can do this using options.stringsBundle.

Using the stringsTable option to provide localizations programmatically

It is possible to provide different localizations at runtime using the stringsTable option.

You can add a strings file in Xcode:

This is a file with a map of localized strings in key value pairs, just like our Localizable.strings files. You can use this as a template.

1. Download/copy the Localizable.strings file.
2. Rename it however you like, but keep the .strings extension. For this example lets call it NewLocalizable.strings.
3. Change the values in each row to the translation you want, but keep the key the same.

For example: "IProov_PromptAlignFace" = "Put your face in the oval"; becomes "IProov_PromptAlignFace" = "Halten Sie Ihr Gesicht in die ovale Form";

4. Add this file to your xcframework/app as you would with any other file.
5. Set stringsTable in iProov Options to your new .strings file (but omit the extension in the option).

For example: options.stringsTable = "NewLocalizable"