Skip to Content
Previous

Localize an iOS app with SAP Translation Hub

By Robin van het Hof

Take an iOS app generated with the SDK Assistant and make it multilingual with SAP Translation Hub.

Details

You will learn

  • How to enable SAP Translation Hub in your SAP Cloud Platform trial account
  • How to add your SAP Translation Hub account into the SDK Assistant
  • How to create multilingual capabilities to your Xcode project using the SDK Assistant
  • How to modify and correct the generated translations

To view the entire series of tutorials, see the Customize UI’s, themes and onboarding for iOS apps tutorial group.


Step 1: Enable SAP Translation Hub

Log on to your SAP Cloud Platform cockpit at https://account.hanatrial.ondemand.com/cockpit/ and navigate to Services.

Locate the SAP Translation Hub tile (search for translation):

Enable SAP Translation Hub

If it is not yet enabled, click the tile.

In the next page, click the Enable button:

Enable SAP Translation Hub

Once the SAP Translation Hub service is enabled, click the Go to UI for Translation Workflow link at the bottom. The SAP Translation Hub web interface will open in a new tab:

Enable SAP Translation Hub
Please log in to access this content.
Step 2: Enable SAP Translation Hub in the SDK Assistant

Open the SDK Assistant. Click the Settings icon in the top-left, and open the Accounts page:

Enable SAP Translation Hub

Click the Plus button to add a new account. From the list, select Translation Hub:

Enable SAP Translation Hub

Click Continue.

In the next screen, add the following details:

Field Value
Name A descriptive name for the configuration, for instance SAP Translation Hub
Base URL https://saptranslation-<your_trial_account_user>trial.hanatrial.ondemand.com/translationhub/api/v1
User Your trial account user
Password Password for your trial account user
Enable SAP Translation Hub

Click Add when done. The account is now added to the SDK Assistant:

Enable SAP Translation Hub

Close the Accounts dialog.

Please log in to access this content.
Step 3: Add translations

In the SDK Assistant, right-click the ESPMReminders app and from the context menu, select Add translation…

Add translations
Please log in to access this content.
Step 4: Choose one or more languages

In the next page, leave the pre-populated values as they are.

Select one or more languages from the list for which you want to translate your app:

Add translations

Click the Add button. The project will now be translated in the chosen languages:

Add translations
Please log in to access this content.
Step 5: Examine the updated Xcode project

Open the Xcode project for your app. Notice the added InfoPlist.strings and Localizable.strings files for the languages you have selected for translation:

Add translations

While most translations seem right, some may not be translated correctly.

Although you can fix this from within the file itself, it may be more convenient to change it in the SAP Translation Hub web app.

Please log in to access this content.
Step 6: Modify the generated translations

Navigate to Services > SAP Translation Hub in your SAP Cloud Platform trial account and click the Go to UI for Translation Workflow link at the bottom. The SAP Translation Hub web interface will open in a new tab. you will now see the just added espmreminders project:

Add translations

Click the Translations tab. In this page, an overview of the original texts and the translated texts for the selected languages are shown:

Add translations

Here you can correct any translations that may be incorrect, and click the Save Project button once done.

Please log in to access this content.
Step 7: Localize the application name

You may have noticed the texts containing $(PRODUCT_NAME) are changed to (PRODUCT_NAME) $. You may change it back, but you could also provide a proper, translated name for your app.

Check the Source Texts which lists $(PRODUCT_NAME), and provide a translated app name instead. Click the Save Project button when done.

Please log in to access this content.
Step 8: Re-import the modified translations

Open the SDK Assistant, right-click the ESPMReminders app and from the context menu, select Add translation…. Select the same languages from the list you have chosen in Step 4, and click the Add button.

Once finished, open your Xcode project and notice the modified translations:

Add translations
Please log in to access this content.
Step 9: Enable your app for localized app name

Open the file Info.plist and add the following entry:

Field Value
Key Application has localized display name
Value YES
Add translations
Please log in to access this content.
Step 10: Change the device language

On your device, open the Settings app and navigate to General > Language & Region and click iPhone Language.

From the list, select one of the languages you have created a translation for, and confirm the language change for your device:

Add translations
Please log in to access this content.
Step 11: Run the translated app

When the device has started up in the new language, remove the old application from the device.

Build and run the application. You will now see the (partial) translation of the onboarding flow, as well as the translation of your custom UI:

Add translations
Please log in to access this content.

Updated 11/16/2017

Time to Complete

15 Min

Intermediate

Prerequisites

Next
Back to top